Передпольотна перевірка

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. Введіть одне розширення, щоб звузити сканування.
- Спроба автоматичного виправлення — установіть цей прапорець, якщо ви хочете, щоб сканер виправляв проблеми, які він знає, як виправити. Не встановлюйте прапорець для сканування лише для читання.
Натисніть кнопку Виконати. Сканер проходить вибрані каталоги та повідомляє про кожну знайдену проблему.

Інтерпретація результатів

У звіті про сканування перелічено кожен перевірений файл і кожну знайдену проблему. Кожен запис про проблему повідомляє:

Який файл містить проблему
Яке правило 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/ для відновлення.