Translation File Format (PO)
We no longer maintain the Knowledge Base since version 4.3.x. All the latest user and developer documentation for 4.3.x and newer versions is now available at docs.cs-cart.com.
- This article is available only for CS-Cart versions:
The translations are stored in the .po format. The .po file structure adopted by the CS-Cart & Multi-Vendor software is different from the generally accepted gettext-driven standard [#gettext_po] for the sake of simplicity.
Important: Use CS-Cart Translator to contribute to CS-Cart & Multi-Vendor translation. You only need to manually edit an exported .po file if you want to apply the modification locally.
Each .po file contains some necessary metadata in the header:
# Base pack of "English" language variables msgid "" msgstr "" Language: en\n Content-Type: text/plain; charset=UTF-8\n Pack-Name: English\n Lang-Code: en\n Country-Code: US\n
Warning: Do not change the existing metadata. Though, some editors may add extra metadata, and that is OK (extra data is ignored).
Here is an example of a valid language variable definition:
#. Enable support of fraud notification msgctxt "Languages" msgid "2co_enable_fraud_verification" msgstr "Enable support of fraud notification"
- Comment holding the original English text
- msgid—unique title to identify the language variable
- msgstr—value in the selected language
Language variable definitions must be separated from each other with an empty line.
Here is how a .po file could end:
# Base pack of "English" language variables msgid "" msgstr "" "Language: en\n" "Content-Type: text/plain; charset=UTF-8\n" "Pack-Name: English\n" "Lang-Code: en\n" "Country-Code: US\n" #. Enable support of fraud notification msgctxt "Languages" msgid "2co_enable_fraud_verification" msgstr "Enable support of fraud notification" #. Status for orders with failed fraud review msgctxt "Languages" msgid "2co_fraud_fail" msgstr "Status for orders with failed fraud review"
Important: The file must end with an empty line.
For more information you can use the following references: