Note
First you may want to learn more about language variables and their use.
Language variables allow you to maintain translations for your CS-Cart/Multi-Vendor add-ons.
Texts in various languages don’t appear in the PHP code or Smarty template files directly—a special function is called instead. The name of the language variable is passed to the function, which then returns the text in one of the languages, depending on the user’s locale.
Language variables of the add-ons are stored in PO files. There is a separate PO file for each language, located in a separate folder according to its language code: var/langs/[language_code]/addons/[addon_name].po.
For example, the PO file with the English translation for the Access Restrictions add-on lies in var/langs/en/addons/access_restrictions.po.
Important
The name of the PO file must be the same as the content of the <id>
section of addon.xml, which is located in app/addons/<addon_name>.
This article describes what happens to the language variables when the add-on is installed, uninstalled, or upgraded.
When an add-on is installed, its PO files are analyzed. The values of the language variables for every available language are written into the language_values
table. The table consists of the following fields:
The values are also put into the original_values
table. Here’s its structure:
msgctxt
from the PO file.msgid
from the PO file.When the variable is used in the __
function for the first time, the value is taken from the language_values
table and cached. Later the values are taken from the cache. Language variables are a part of CS-Cart/Multi-Vendor general cache. The caching mechanism depends on CS-Cart/Multi-Vendor settings.
Administrators can change the values of the language variables in the Administration panel. These changes are recorded to the value field of the language_values
table. The original_values
table remains unchanged.
When the language variables are exported to a PO file from the Administration panel, the values of msgtxt and msgid come from original_values
, and the value of msgstr comes from language_values
.
When an add-on is upgraded, the PO files in the upgrade package are analyzed. The new language variables are added, but the existing language variables aren’t updated. This applies to CS-Cart/Multi-Vendor upgrades as well.
Hint
Learn more about creating an upgrade package for an add-on.
When an add-on is uninstalled, it’s PO files are analyzed. All the language variables of the add-on are removed from the original_values
and language_values
tables. The language cache is cleared.
Questions & Feedback
Have any questions that weren't answered here? Need help with solving a problem in your online store? Want to report a bug in our software? Find out how to contact us.