چک قبل از پرواز

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 ندارند.

اجرای اسکنر

فهرست توزیع upgrade/ را در ریشه وب سایت خود کپی کنید (اگر قبلاً این کار را به عنوان بخشی از مرحله آماده سازی برای ارتقا انجام نداده اید).
مرورگر خود را به URL قبل از پرواز نشان دهید:

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

هنگامی که از شما خواسته شد با یک حساب مدیر وارد شوید.
اسکنر فرمی را با سه کنترل ارائه می دهد:
- دایرکتوری الگو - برای اسکن themes/ و modules/ خالی بگذارید. مسیری مانند /themes/mytheme/ را وارد کنید تا اسکن را به یک فهرست واحد محدود کنید.
- پسوند قالب - برای اسکن هر دو فایل .tpl و .html خالی بگذارید. برای محدود کردن اسکن، یک پسوند واحد وارد کنید.
- **تلاش برای رفع خودکار ** - اگر می‌خواهید اسکنر مشکلاتی را که می‌داند چگونه برطرف کند، این کادر را علامت بزنید. برای اسکن فقط خواندنی آن را بدون علامت بگذارید.
دکمه Run را فشار دهید. اسکنر دایرکتوری های انتخاب شده را بررسی می کند و هر مشکلی را که پیدا می کند گزارش می دهد.

تفسیر نتایج

گزارش اسکن هر فایلی را که بررسی کرده و هر مشکلی را که پیدا کرده است فهرست می کند. هر ورودی شماره به شما می گوید:

کدام فایل حاوی مشکل است
چه قانون Smarty 4 را نقض می کند
آیا اسکنر می تواند آن را به طور خودکار تعمیر کند

اگر اسکن را با فعال بودن Attempt automatic fix اجرا کنید، گزارش همچنین تایید می کند که کدام فایل ها بازنویسی شده اند.

رفع مشکلات به صورت دستی

برای مشکلاتی که اسکنر نمی تواند به طور خودکار تعمیر کند، فایل الگوی پرچمدار را در یک ویرایشگر باز کنید و تغییرات لازم را انجام دهید. ناسازگاری های رایج Smarty 4 عبارتند از:

بلوک های {php} ... {/php} (دیگر در Smarty 4 پشتیبانی نمی شود)
اصلاح کننده ها و فراخوانی های تابع منسوخ شده است
استفاده از جداکننده حساس به فضای خالی
مفروضات افزونه زمان ثبت نام که در Smarty 4 تغییر کردند

اگر در ویرایش قالب‌ها راحت نیستید، ایمن‌ترین رویکرد این است که به یک تم ارسال شده (xbootstrap5، default، xswatch5، و غیره) تغییر دهید و پس از تکمیل ارتقاء، به تم سفارشی پرداخته شود.

اجرای مجدد تا زمانی که پاک شود

پس از انجام اصلاحات - چه خودکار یا دستی - اسکنر قبل از پرواز را دوباره اجرا کنید. این کار را تا زمانی تکرار کنید که اسکن مشکل باقیمانده را گزارش نکند.

هنگامی که اسکن تمیز شد، می توانید با فشار دادن دکمه خروج از اسکنر در رابط کاربری اسکنر، جلسه قبل از پرواز را پایان دهید. این پیش از پرواز را کامل نشان می دهد و به ارتقا دهنده اصلی در /upgrade/ اجازه می دهد تا ادامه دهد.

ادامه به ارتقا

با تکمیل پیش از پرواز، می توانید ارتقا دهنده اصلی را در آدرس زیر راه اندازی کنید:

http://example.com/upgrade/

برای مراحل بعدی به Running Upgrade مراجعه کنید.

اگر پیش از پرواز را رها کنیدپرش از قبل از پرواز به شدت ممنوع است، اما اگر بدون اجرای آن ارتقا داده اید و اکنون خطاهای الگو را می بینید، به بخش خطاهای الگوی Smarty 4 در عیب یابی مراجعه کنید. شما می توانید قبل از پرواز را پس از این واقعیت اجرا کنید و `xoops_data/caches/smarty_compile/` را برای بازیابی پاک کنید.