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
