فحص ما قبل الترقية

قامت XOOPS 2.7.0 بترقية محرك النماذج من Smarty 3 إلى Smarty 4. Smarty 4 أكثر صرامة بشأن بناء جملة النماذج من Smarty 3، وقد تحتاج بعض المواضيع والنماذج المخصصة للوحدات إلى تعديل قبل أن تعمل بشكل صحيح على XOOPS 2.7.0.

للمساعدة في تحديد وإصلاح هذه المشاكل قبل تشغيل المحقق الرئيسي، تأتي XOOPS 2.7.0 مع ماسح ما قبل الترقية في دليل upgrade/. يجب تشغيل ماسح ما قبل الترقية مرة واحدة على الأقل قبل أن يسمح لك سير العمل الرئيسي للترقية بالمتابعة.

ما يفعله الماسح

يمر ماسح ما قبل الترقية عبر المواضيع والنماذج الحالية البحثاً عن عدم التوافقية المعروفة مع Smarty 4. يمكنه:

• مسح أدلة themes/ و modules/ الخاصة بك بحثاً عن ملفات نماذج .tpl و .html التي قد تحتاج إلى تغييرات
• إعادة تقرير المشاكل مجمعة حسب الملف ونوع المشكلة
• إصلاح تلقائي للعديد من المشاكل الشائعة عند طلب ذلك

لا يمكن إصلاح كل مشكلة تلقائياً. ستحتاج بعض النماذج إلى تحرير يدوي، خاصة إذا كانت تستخدم أساليب Smarty 3 القديمة التي لا تملك مكافئاً مباشراً في Smarty 4.

تشغيل الماسح

1. انسخ دليل upgrade/ من التوزيع إلى جذر الويب الخاص بك (إذا لم تقم بذلك بالفعل كجزء من خطوة التحضيرات للترقية).

2. وجه متصفحك إلى عنوان URL الخاص بـ ما قبل الترقية:

   http://example.com/upgrade/preflight.php

3. قم بتسجيل الدخول باستخدام حساب المسؤول عند مطالبتك.

4. يقدم الماسح نموذجاً يحتوي على ثلاث عناصر تحكم:

   • دليل النموذج — اتركه فارغاً للمسح الشامل لـ themes/ و modules/. أدخل مساراً مثل /themes/mytheme/ لتضييق المسح على دليل واحد.
   • امتداد النموذج — اتركه فارغاً للمسح الشامل لملفات .tpl و .html. أدخل امتداداً واحداً لتضييق المسح.
   • محاولة الإصلاح التلقائي — حدد هذا الخيار إذا كنت تريد من الماسح إصلاح المشاكل التي يعرف كيفية إصلاحها. اتركه غير محدد للمسح بدون تعديل.

5. اضغط على زر تشغيل. يمر الماسح عبر الأدلة المحددة ويعيد تقرير عن كل مشكلة يجدها.

تفسير النتائج

يسرد تقرير المسح كل ملف تم فحصه وكل مشكلة تم العثور عليها. تخبرك كل إدخال مشكلة بـ:

• أي ملف يحتوي على المشكلة
• أي قاعدة Smarty 4 تنتهكها
• ما إذا كان الماسح يمكنه إصلاحها تلقائياً

إذا قمت بتشغيل المسح مع تفعيل محاولة الإصلاح التلقائي، فسيؤكد التقرير أيضاً أي ملفات تمت إعادة كتابتها.

إصلاح المشاكل يدويًا

بالنسبة للمشاكل التي لا يمكن للماسح إصلاحها تلقائياً، افتح ملف النموذج المشار إليه في محرر وأجرِ التغييرات المطلوبة. تتضمن عدم التوافقية الشائعة مع Smarty 4:

• كتل {php} ... {/php} (لم تعد مدعومة في Smarty 4)
• المعدلات المستهلكة واستدعاءات الدوال
• استخدام الفاصل الحساس للمسافات البيضاء
• افتراضات مكون التسجيل التي تغيرت في Smarty 4

إذا لم تكن مرتاحاً لتحرير النماذج، فالطريقة الأكثر أماناً هي الانتقال إلى مظهر مُرسل (xbootstrap5 أو default أو xswatch5 وما إلى ذلك) والتعامل مع المظهر المخصص بشكل منفصل بعد انتهاء الترقية.

إعادة التشغيل حتى تنظيف

بعد القيام بالإصلاحات — سواء كانت تلقائية أو يدوية — أعد تشغيل ماسح ما قبل الترقية. كرر حتى يعيد المسح عدم وجود مشاكل متبقية.

بمجرد أن يكون المسح نظيفاً، يمكنك إنهاء جلسة ما قبل الترقية بالضغط على زر خروج الماسح في واجهة الماسح. يحدد هذا ما قبل الترقية كاملة ويسمح للمحقق الرئيسي في /upgrade/ بالمتابعة.

الانتقال إلى الترقية

مع انتهاء ما قبل الترقية، يمكنك تشغيل المحقق الرئيسي في:

http://example.com/upgrade/

راجع تشغيل الترقية للخطوات التالية.

إذا تخطيت فحص ما قبل الترقية

يُثنى بشدة عن تخطي ما قبل الترقية، لكن إذا قمت بالترقية دون تشغيله وتشاهد الآن أخطاء نماذج، راجع قسم أخطاء نماذج Smarty 4 في استكشاف الأخطاء. يمكنك تشغيل ما قبل الترقية بعد الحقيقة ومسح xoops_data/caches/smarty_compile/ للاسترجاع.