Installing Language Packages
page last edited on 18 October 2017
You can add more languages to your store by installing one or more language packages. A language package (also called a “translation addon”, a “translation package” or simply a “translation”) is a .csv file that contains text label values defined for a specific language. Some language packages are available via the X-Cart App Store.
To install a language package from the X-Cart App Store:
In your store’s Admin area, select My addons.
Use search to locate the language package you require. For example, enter “translation” in the Search box to find all language package addons in the X-Cart App Store.
Install and activate the language package the same way as any other addon from the X-Cart App Store. See Installing Addons from the X-Cart App Store.
The store will be redeployed:
The translation addon will be installed:
Once you have more than one language installed and enabled, language selectors will be provided both in the Admin and Customer areas of your X-Cart store.
Try switching the language, and you should see at least some of the words and phrases on the page you are viewing translated to the selected language.
For example, here’s what the Admin area home page looks like after switching the language of the interface in Admin to German (Note the language code “DE” in the language selector):
Despite that the page is displayed using the German translation, it still contains a lot of English words. This happens because in X-Cart 5 pieces of text like names of sections of the user interface, various notes, comments and error messages are all stored as text labels. A text label has a name by which it can be referenced from the template or program code and one or more “translations”. A translation is a value of the label defined for a specific language. When a piece of text needs to be displayed on a page, X-Cart selects the respective text label from the database and determines which of its translations needs to be displayed - according to the language that is currently selected for viewing the page. If, for some reason, the value of the label for the selected language is missing, the label value for the default language is displayed. If the label value for the default language is missing as well, the label name is displayed.
Hence if the translation you installed is not a complete one (which is the case with all community translations), you can complete it by editing the respective text labels or by changing the text of the chosen page directly in the store interface.
Help make this document better
This guide, as well as the rest of our docs, are open-source and available on GitHub.