DevTest
TPL → TWIG migration FAQ
Why migrate from TPL to TWIG "DevTest" ?
The TPL engine is locked to OpenCart 2.x and is no longer maintained. TWIG is the standard for OpenCart 3.x and later: safer, faster, with template inheritance, macros and filters.
Is the generated TWIG compatible with OpenCart 3.x?
Yes. The converter produces output that is fully compatible with the default OpenCart 3.x template engine — variables, conditions, loops, filters, and include statements.
How are complex PHP expressions handled?
Simple echo, if and foreach are converted automatically. Complex constructs (foreach with keys, switch, ternaries) need to be ported manually — the converter will mark them with comments.
Are comments and formatting preserved?
HTML markup, indentation and line breaks are kept. PHP comments are converted into TWIG comments {# #}, HTML comments stay untouched.
How to verify the result before going live?
Paste the generated TWIG into a test .twig file of your theme and inspect the page rendering. The reverse converter is also available so you can cross-check both versions.
Can I convert an entire theme at once?
The web interface processes one template at a time. For bulk migration we recommend the convertTplToTwig.php script — it lives in the project root and accepts a folder of .tpl files.
Is the source code safe during conversion?
Yes. The converter runs locally in your browser, the source code is never sent anywhere. The server-side script also makes no external requests.
What if TWIG throws a parse error?
Check the syntax of the original TPL — unclosed quotes, broken tags. If the error persists, send a sample through the feedback form and we will add support for your case.
123
