Language Support

Making Zen Cart multi-language

What is a Language Pack ?

In Zen Cart, the messages displayed by the storefront and admin area are kept in a separate area so they can be converted from English to any other language.

Languages for your cart may be managed in Admin > Localization > Languages.

Installing a Language Pack

To make your store multi-lingual, add the language in your admin using Admin > Localization > Languages > Add.

Once you have added a new language, you will need to get the language pack files that correspond to that language. Language packs may be found in the Plugins Library.

Language packs are structured to correspond to your cart folders, so you can just rename the admin folder, if one exists, and then upload all the files.

If you’re not familiar with installing a Zen Cart plugin, follow the instructions on how to install a plugin.

Troubleshooting a Language Pack

Here are some symptoms you might see, and ideas on how to resolve them.

Blank White Screen (on Storefront) After Language Pack Installed.

There are likely to be missing language files. Check the logs directory for myDEBUG-YYYYMMDD-HHMMSS-nnnnnn.log files and look for failed to open stream: No such file or directory. Before it you should see a file path of the missing file.

    PHP Warning: require_once(**YOURSITE/includes/languages/YOURLANGUAGE/MISSINGFILE.php**): failed to open stream: No such file or directory in YOURSITE/includes/languages/YOURLANGUAGE.php on line 607

Find the file in the english language folder YOURSITE/includes/languages/english/MISSINGFILE.php and copy to your language folder.

NOTE: You may have to repeat this task multiple times for older version language packs.

Capitalised Titles Displayed in English

If you get sections named displayed as capitalised title with underscore between, e.g.HEADING_TITLE, again it will be because language files have not been included in the original language pack. Finding these can be more tricky as the same title may be used in multiple places.

Start by logging into your admin page. Then select Tools > Developers Tool Kit in the tool kit, and enter the name of the missing variable. Search All Language Files for ENGLISH - Catalog/Admin. This should produce a list of places where the variable is defined.

  • If it is only one place, then transfer that file from the english location to YOURLANGUAGE equivalent location.
  • If there are multiple listings, then go back to the storefront and add &language=en to then end of the URL or if &language=YOURLANGUAGECODE is already present, change YOURLANGUAGECODE to en. Then refresh the page and look at the correct wording. Use this wording to find the correct file and copy the file from the english location to YOURLANGUAGE equivalent location.

Admin Field Descriptions Still in English

  • The language pack did not contain a full translation of the admin descriptions held in the database. Contact the language pack creator to ask if translation is available.

OR

  • You have not run the sql patch for the admin files. See your installation instruction and run the sql patch.



Still have questions? No problem! Just head over to the Zen Cart support forum and ask there in the appropriate subforum. In your post, please include your Zen Cart and PHP versions, and a link to your site.

Is there an error or omission on this page? Please post to General Questions on the support forum. Or, if you'd like to open a pull request, just review the guidelines and get started. You can even PR right here.
Last modified July 16, 2020 by brittainmark (e74269d).