DevTest
Часті питання про міграцію TPL → TWIG
Навіщо переходити з TPL на TWIG "DevTest" ?
TPL-рушій залишився в OpenCart 2.x і більше не розвивається. TWIG — сучасний стандарт OpenCart 3.x і вище: безпечніше, швидше, підтримує наслідування шаблонів, макроси та фільтри.
Чи сумісний згенерований TWIG з OpenCart 3.x?
Так. Конвертер видає синтаксис, який повністю сумісний з дефолтним шаблонізатором OpenCart 3.x — змінні, умови, цикли, фільтри, include.
Що робити з PHP-логікою у вихідному TPL?
Прості echo, if, foreach конвертуються автоматично. Складні конструкції (foreach з ключами, switch, тернарні оператори) переносяться у TWIG вручну — конвертер позначить такі місця коментарями.
Чи зберігаються коментарі та форматування?
HTML-розмітка, відступи та переноси рядків зберігаються. PHP-коментарі переносяться у TWIG-коментарі {# #}, HTML-коментарі залишаються без змін.
Як перевірити результат перед заміною?
Скопіюйте отриманий TWIG-код у тестовий .twig-файл теми та перевірте рендеринг сторінки. Також доступний зворотний конвертер, щоб звірити обидва варіанти.
Чи можна пакетно сконвертувати всю тему?
Інтерфейс обробляє по одному шаблону. Для масової міграції рекомендуємо PHP-скрипт convertTplToTwig.php — він лежить у корені проєкту і приймає папку з .tpl файлами.
Чи безпечний вихідний код після конвертації?
Так. Конвертер працює локально в браузері, вихідний код нікуди не надсилається. Серверний скрипт також не робить зовнішніх запитів.
Що робити, якщо TWIG видає помилку парсингу?
Перевірте синтаксис вихідного TPL — незакриті лапки, биті теги. Якщо помилка залишається — надішліть приклад через форму зворотного зв'язку, додамо підтримку вашого кейсу.
123
