उड़ान पूर्व जांच

XOOPS 2.7.0 ने अपने टेम्प्लेटिंग इंजन को Smarty 3 से Smarty 4 में अपग्रेड किया। Smarty 4 टेम्प्लेट सिंटैक्स के बारे में Smarty 3 की तुलना में अधिक सख्त है, और कुछ कस्टम थीम और मॉड्यूल टेम्प्लेट को XOOPS पर सही ढंग से काम करने से पहले समायोजित करने की आवश्यकता हो सकती है। 2.7.0.

इन समस्याओं को पहचानने और सुधारने में मदद करने के लिए _आपके द्वारा मुख्य अपग्रेडर चलाने से पहले, XOOPS 2.7.0 upgrade/ निर्देशिका में प्रीफ्लाइट स्कैनर के साथ भेजा जाता है। मुख्य अपग्रेड वर्कफ़्लो आपको जारी रखने की अनुमति देने से पहले आपको कम से कम एक बार प्रीफ़्लाइट स्कैनर चलाना होगा।

स्कैनर क्या करता है

प्रीफ़्लाइट स्कैनर आपके मौजूदा थीम और मॉड्यूल टेम्प्लेट के माध्यम से ज्ञात Smarty 4 असंगतताओं की तलाश करता है। यह हो सकता है:

.tpl और .html टेम्पलेट फ़ाइलों के लिए अपनी themes/ और modules/ निर्देशिकाओं को स्कैन करें जिनमें बदलाव की आवश्यकता हो सकती है
रिपोर्ट मुद्दों को फ़ाइल और समस्या के प्रकार के आधार पर समूहीकृत किया गया
जब आप कहें तो कई सामान्य समस्याओं को स्वचालित रूप से ठीक करें

हर समस्या को स्वचालित रूप से ठीक नहीं किया जा सकता. कुछ टेम्प्लेट को मैन्युअल संपादन की आवश्यकता होगी, खासकर यदि वे पुराने Smarty 3 मुहावरों का उपयोग करते हैं जिनका Smarty 4 में कोई सीधा समकक्ष नहीं है।

स्कैनर चलाना

वितरण upgrade/ निर्देशिका को अपनी साइट वेब रूट में कॉपी करें (यदि आपने अपग्रेड के लिए तैयारी चरण के हिस्से के रूप में पहले से ऐसा नहीं किया है)।
अपने ब्राउज़र को प्रीफ़्लाइट URL पर इंगित करें:
```
http://example.com/upgrade/preflight.php
```
संकेत मिलने पर व्यवस्थापक खाते से लॉग इन करें।
स्कैनर तीन नियंत्रणों के साथ एक फॉर्म प्रस्तुत करता है:
- टेम्पलेट निर्देशिका — themes/ और modules/ दोनों को स्कैन करने के लिए खाली छोड़ दें। स्कैन को एकल निर्देशिका तक सीमित करने के लिए /themes/mytheme/ जैसा पथ दर्ज करें।
- टेम्पलेट एक्सटेंशन — .tpl और .html दोनों फाइलों को स्कैन करने के लिए खाली छोड़ दें। स्कैन को संकीर्ण करने के लिए एक एकल एक्सटेंशन दर्ज करें।
- स्वचालित सुधार का प्रयास करें - यदि आप चाहते हैं कि स्कैनर उन समस्याओं को ठीक करे जो वह जानता है कि उन्हें कैसे ठीक करना है तो इस बॉक्स को चेक करें। इसे केवल पढ़ने योग्य स्कैन के लिए अनियंत्रित छोड़ दें।
रन बटन दबाएँ। स्कैनर चयनित निर्देशिकाओं पर चलता है और मिलने वाली प्रत्येक समस्या की रिपोर्ट करता है।

परिणामों की व्याख्या करना

स्कैन रिपोर्ट में जांच की गई प्रत्येक फ़ाइल और पाई गई प्रत्येक समस्या सूचीबद्ध होती है। प्रत्येक अंक प्रविष्टि आपको बताती है:

किस फ़ाइल में समस्या है
यह किस Smarty 4 नियम का उल्लंघन करता है
क्या स्कैनर इसे स्वचालित रूप से ठीक कर सकता है

यदि आपने स्कैन को अटेम्प्ट ऑटोमैटिक फिक्स इनेबल्ड के साथ चलाया है, तो रिपोर्ट यह भी पुष्टि करेगी कि कौन सी फाइलें दोबारा लिखी गई थीं।

मुद्दों को मैन्युअल रूप से ठीक करना

उन समस्याओं के लिए जिन्हें स्कैनर स्वचालित रूप से ठीक नहीं कर सकता, संपादक में फ़्लैग की गई टेम्पलेट फ़ाइल खोलें और आवश्यक परिवर्तन करें। सामान्य Smarty 4 असंगतताओं में शामिल हैं:

{php} ... {/php} ब्लॉक (अब Smarty 4 में समर्थित नहीं)
अप्रचलित संशोधक और फ़ंक्शन कॉल
व्हाइटस्पेस-संवेदनशील डिलीमीटर उपयोग
रजिस्टर-टाइम प्लगइन धारणाएँ जो Smarty 4 में बदल गईं

यदि आप टेम्प्लेट संपादित करने में सहज नहीं हैं, तो सबसे सुरक्षित तरीका शिप किए गए थीम (xbootstrap5, default, xswatch5, इत्यादि) पर स्विच करना है और अपग्रेड पूरा होने के बाद कस्टम थीम से अलग से निपटना है।

साफ़ होने तक पुनः चलाना

सुधार करने के बाद - चाहे स्वचालित हो या मैन्युअल - प्रीफ़्लाइट स्कैनर को फिर से चलाएँ। तब तक दोहराएँ जब तक कि स्कैन कोई शेष समस्या न बता दे।

एक बार स्कैन साफ़ हो जाने पर, आप स्कैनर यूआई में स्कैनर से बाहर निकलें बटन दबाकर प्रीफ़्लाइट सत्र समाप्त कर सकते हैं। यह प्रीफ़्लाइट को पूर्ण के रूप में चिह्नित करता है और /upgrade/ पर मुख्य अपग्रेडर को आगे बढ़ने की अनुमति देता है।

अपग्रेड जारी रखना

प्रीफ़्लाइट पूर्ण होने पर, आप मुख्य अपग्रेडर को यहां लॉन्च कर सकते हैं:

http://example.com/upgrade/
```अगले चरणों के लिए [रनिंग अपग्रेड](ustep-02.md) देखें।

## यदि आप पूर्व उड़ान छोड़ देते हैं

प्रीफ़्लाइट को छोड़ना दृढ़ता से हतोत्साहित करता है, लेकिन यदि आपने इसे चलाए बिना अपग्रेड किया है और अब टेम्पलेट त्रुटियाँ देख रहे हैं, तो [समस्या निवारण](ustep-03.md) का Smarty 4 टेम्पलेट त्रुटियाँ अनुभाग देखें। आप तथ्य के बाद प्रीफ़्लाइट चला सकते हैं और पुनर्प्राप्त करने के लिए `xoops_data/caches/smarty_compile/` साफ़ कर सकते हैं।