Проверка предполета

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/ в корневую папку веб-сайта (если вы еще не сделали это как часть шага Preparations for 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 и т.д.) и заниматься пользовательской темой отдельно после завершения обновления.

Повторный запуск до чистоты

После внесения исправлений — будь то автоматическое или ручное — переустановите сканер предполета. Повторяйте до тех пор, пока сканирование не сообщит об отсутствии оставшихся проблем.

Когда сканирование чистое, вы можете завершить сеанс предполета, нажав кнопку Exit Scanner в пользовательском интерфейсе сканера. Это отмечает предполет как завершенный и позволяет основному обновлению на /upgrade/ продолжить.

Продолжение обновления

После завершения предполета вы можете запустить основное обновление по адресу:

http://example.com/upgrade/

Подробнее см. Running Upgrade.

Если вы пропустите Preflight

Пропуск предполета настоятельно не рекомендуется, но если вы обновили без его запуска и теперь видите ошибки шаблонов, см. раздел Smarty 4 Template Errors раздела Troubleshooting. Вы можете запустить предполет постфактум и очистить xoops_data/caches/smarty_compile/ для восстановления.