בדיקה מוקדמת

XOOPS 2.7.0 upgraded its templating engine from Smarty 3 to Smarty 4. Smarty 4 is stricter about template syntax than Smarty 3, and some custom themes and module templates may need to להתאים לפני שהם יפעלו כהלכה ב-XOOPS 2.7.0.

כדי לעזור לזהות ולתקן את הבעיות האלה לפני שאתה מפעיל את המשדרג הראשי, XOOPS 2.7.0 נשלח עם סורק טרום-פלוט בספריית upgrade/. עליך להפעיל את סורק הטרום-טיסה לפחות פעם אחת לפני שזרימת העבודה הראשית של השדרוג תאפשר לך להמשיך.

מה הסורק עושה

הסורק הטרום טיסה עובר על ערכות הנושא הקיימות ותבניות המודולים שלך ומחפש אי-תאימות ידועות של Smarty 4. זה יכול:

סרוק את ספריות ה-themes/ ו-modules/ שלך עבור קובצי תבניות .tpl ו-.html שעשויים להזדקק לשינויים
דווח על בעיות מקובצות לפי קובץ ולפי סוג הבעיה
תיקון אוטומטי בעיות נפוצות רבות כשאתה מבקש זאת

לא כל בעיה ניתנת לתיקון אוטומטי. תבניות מסוימות יזדקקו לעריכה ידנית, במיוחד אם הן משתמשות בביטויים ישנים יותר של Smarty 3 שאין להם מקבילה ישירה ב-Smarty 4.

הפעלת הסורק

העתק את ספריית ההפצה upgrade/ לשורש האינטרנט של האתר שלך (אם עדיין לא עשית זאת כחלק מהשלב הכנות לשדרוג).
הפנה את הדפדפן אל ה-preflight URL:
```
http://example.com/upgrade/preflight.php
```
היכנס עם חשבון מנהל כאשר תתבקש.
הסורק מציג טופס עם שלושה פקדים:
- ספריית התבניות - השאר ריק כדי לסרוק גם את themes/ וגם modules/. הזן נתיב כמו /themes/mytheme/ כדי לצמצם את הסריקה לספרייה בודדת.
- סיומת תבנית - השאר ריק כדי לסרוק את שני הקבצים .tpl ו-.html. הזן הרחבה בודדת כדי לצמצם את הסריקה.
- ניסיון תיקון אוטומטי - סמן את התיבה הזו אם אתה רוצה שהסורק יתקן בעיות שהוא יודע לתקן. השאר אותו לא מסומן עבור סריקה לקריאה בלבד.
לחץ על הלחצן הפעלה. הסורק עובר בין הספריות הנבחרות ומדווח על כל בעיה שהוא מוצא.

פירוש תוצאות

דוח הסריקה מפרט כל קובץ שהוא בדק וכל בעיה שמצא. כל ערך גיליון אומר לך:

איזה קובץ מכיל את הבעיה
מה הכלל Smarty 4 שהוא מפר
האם הסורק יכול לתקן אותו אוטומטית

אם הפעלת את הסריקה עם Attempt Automatic fix מופעל, הדוח יאשר גם אילו קבצים נכתבו מחדש.

תיקון בעיות באופן ידני

לבעיות שהסורק אינו יכול לתקן באופן אוטומטי, פתח את קובץ התבנית המסומנת בעורך ובצע את השינויים הנדרשים. אי-תאימות נפוצות של Smarty 4 כוללות:

בלוקים {php} ... {/php} (אינם נתמכים עוד ב-Smarty 4)
שינויים ושיחות פונקציה שהוצאו משימוש
שימוש במפריד רגיש לרווחים
הנחות תוסף זמן רישום שהשתנו ב-Smarty 4

אם לא נוח לך לערוך תבניות, הגישה הבטוחה ביותר היא לעבור לערכת נושא שנשלחה (xbootstrap5, default, xswatch5 וכו’) ולהתמודד עם הנושא המותאם אישית בנפרד לאחר השדרוג.

פועל מחדש עד נקי

לאחר ביצוע תיקונים - בין אם אוטומטיים או ידניים - הפעל מחדש את סורק הבדיקה המוקדמת. חזור על הפעולה עד שהסריקה לא תדווח על בעיות שנותרו.

לאחר שהסריקה נקייה, תוכל לסיים את הפגישה המוקדמת על ידי לחיצה על הלחצן צא סורק בממשק המשתמש של הסורק. זה מסמן את הטיסה המוקדמת כהשלמה ומאפשר למשדרג הראשי ב-/upgrade/ להמשיך.

ממשיך לשדרוג

עם השלמת הטיסה המוקדמת, תוכל להפעיל את המשדרג הראשי בכתובת:

http://example.com/upgrade/

ראה שדרוג רץ לשלבים הבאים.

אם תדלג על טיסה מוקדמת

מומלץ מאוד לדלג על בדיקה מוקדמת, אך אם שדרגת מבלי להפעיל אותה וכעת אתה רואה שגיאות תבנית, עיין בסעיף Smarty 4 שגיאות תבנית של פתרון בעיות. אתה יכול להפעיל טיסה מוקדמת לאחר מעשה ולנקות את xoops_data/caches/smarty_compile/ כדי להתאושש.