Creating a Language Pack
This documentation is for Zen Cart 1.5.8 and above; if you need the older documentation, please see Pre 1.5.8 Language Files.
If you are not familiar with the new language file format for Zen Cart 1.5.8 and above, please see Developer Information on Array based Language files.
Developers seeking to build new translations for 1.5.8 and above have two options:
Start with the English files, and do the translations by hand. The advantage of this approach is that it is just translation; all the necessary code changes in each language file have been done.
Start with an older translation, and run the Language File Converter. This reduces the translation burden, but requires coding skills, since the produced files will need to be hand edited in cases where the tool didn’t produce perfect results.
Of course, a hybrid approach is possible where (2) is performed, and then issues are resolved on a per-file basis using approach (1).
Issues with the Converter
The Converter is not perfect. It allows rapid conversion of language files, but some portion of the output will still need manual correction. Translators following approach (2) above will need to make changes in the following situations:
references to global variables such as
separate code paths for admin vs storefront (example:
backward references to language definitions from earlier within the same file (example:
Parameterized calls to
PHP statements in isolation (example:
definitions which begin with a constant (example:
Referring to the
english translation will demonstrate a known-working approach for fixing these issues.
One common failure the converter has is failing to change a comma to a double arrow operator in a
define. For example, changing
define('TEXT_ONETIME_CHARGES_EMAIL',"\t" . '*onetime charges = ');
'TEXT_ONETIME_CHARGES_EMAIL', "\t" . '*onetime charges = ',
These failures can be detected with this grep pattern:
grep "'[A-Z0-9_]*'[\s]*," *.php | grep -v "=>"
Available Array Based Language Packs for Zen Cart 1.5.8 and above
Please see User information on Array based Language files.
If you need to include a language file directly, see the code example in the Upgrading plugins for 1.5.8 FAQ.
Language File Help:
- Creating a Language Pack for Zen Cart 1.5.8 and above
- Language Files - New vs Legacy in 1.5.8
- Language Files - Developer information on Array based Language files
- Language Files - User information on Array based Language files
- Release Specific Upgrade Considerations
- Upgrading plugins to work with 1.5.8/PHP 8.0+
- Basic 158+ Language Customizations