HomeGeneral questionsHow to translate CS-Cart

How to translate CS-Cart

  1. Add a new language in CS-Cart (if it has not been added yet):
    1. Log in to your administration panel, open the Content tab and click on the Languages link.
    2. Click on the Add language button in the top right corner.
    3. Enter the code and name for a new language in the appropriate fields in the opened Add language pop up window and click on the Create button. The desired language will be added in the store (it will be the copy of English translation at the beginning).


      add new language

  2. Most of CS-Cart texts are stored in the so called language variables. You are able to translate language variables in two ways:
    1. Open the Translations tab on the Languages page and select the newly created language in the select box in the top left corner. Now you are assumed to enter the text in this language.
      NOTE: If English is selected in the select box, you are editing texts in English on the page.
      1. Translate texts in the VALUE input fields of the language variables on the page.


        translate language variables

        NOTE: Do not translate words written with lowercase letters in square brackets, i.e. [link]; [product]; .... When this text is displayed in the storefront, [product] will be replaced with an appropriate product name automatically (and so on). Namely, the word between square brackets is just a spot indicating where CS-Cart should place the appropriate value. So move it within text, but do not delete. Translate words written with uppercase letters in square brackets, i.e. [ALREADY PATCHED], [DELETED], [FAILED], [NON WRITABLE], ... These are notifications generated by Upgrade Center and should be translated as well.
      2. Click on the Save button to save the changes.
        NOTE: It is required to save the changes on each page with the translated language variables. If you open the next page with language variables without clicking on the Save button on the previous page, translations on your previous page will be lost.
    2. Open the Design tab, click on the Design mode link and click on the Enable translation mode button. In the translation mode some texts in your administration panel are highlighted with green.
      1. In order to translate a text move your cursor over it, the small image of a book will appear in the top left corner of the text.
      2. Click on it, select the desired language in the top right corner of the opened pop up window and enter the desired text in this language.
      3. Click on the Save translation button.


        translation mode

  3. Then it is required to translate the content of the following pages in the administration panel as they affect the storefront too:
    • Order statuses
    • Gift certificates
    • Return requests (translate these pages if you plan to use the RMA addon)
    • Profile fields
    • User groups
    • Shipping methods
    • Countries (and States if required)
    • Payment methods
    • Credit cards
    • Titles
    • Currencies
    • Top menu
    • Banners
    • Pages to change the content of the Information side box in the storefront
    • Forms (the Contact us page)
    • Site news
    • Blocks
    • Products
    • Categories
    • Promotions

      In order to translate these objects:
      1. Select the desired language in the language section in the top left corner of the page.
      2. Click on the edit link of the object and enter necessary information in the selected language in the opened window.
      3. Click on the Save button.
  4. In order to translate the list of options on the Settings page you should use the translation mode (point 2.2).
  5. In order to translate the list of available privileges click on the Translate privileges link on the Languages page.

Noticed an error in the article or it is not clear enough? Any suggestions to improve it? Please let us know by filling in the feedback form. Click here.