How to translate CS-Cart
- Log in to your store administration panel.
- Add a new language in CS-Cart (if it has not been added yet):
- Open the Content tab and click on the Languages link.
- Click on the Add language button in the top right corner.
- 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). The select box allowing users to choose a language will be displayed in the customer area and in the store administration panel.
- Most of CS-Cart texts are stored in the so called language variables. Although, they all can be viewed and edited under the Translations tab of the Languages page (it is under the Content root tab), we recommend to translate them in the following order:
- Open the Design tab, click on the Design mode link and click on the Enable translation mode button. In the translation mode the texts in your administration panel are highlighted with green.
- 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.
- 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.
- Click on the Save translation button.
- After you have translated all texts in your store administration panel, open the Design tab, click on the Design mode link, then click on the View STOREFRONT in translation mode. link. You will be redirected to the storefront and will need to translate the text pieces highlighted with green using the instructions from point 3.1.1-3.1.3.
- After you translate all visible texts, some language variables are still not translated as they are displayed in the e-mail notifications and in some special situations, i.e. error notifications, popup window messages etc. In order to translate the rest variables:
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.
- Translate texts in the VALUE input fields of the language variables on the page.
NOTE: Do not translate words written with lowercase words in square brackets, i.e. [link]; [product]; .... When this text is displayed in the storefront, such a variable will be replaced with an appropriate value automatically (e.g. [product] will be replaced with the corresponding product name). Namely, the word between square brackets is just a spot indicating where CS-Cart should place the appropriate value. So move it within the text, but do not delete. Translate the words written with uppercase letters in square brackets, i.e. [ALREADY PATCHED], [DELETED], [FAILED], [NON WRITABLE], ... They are the notifications generated by Upgrade Center and should be translated as well.
- 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.
- Translate texts in the VALUE input fields of the language variables on the page.
- Open the Design tab, click on the Design mode link and click on the Enable translation mode button. In the translation mode the texts in your administration panel are highlighted with green.
- Then it is necessary to translate the content of the following pages in the administration panel as they affect the storefront too:
- Order statuses (the link to this page is under the Orders tab)
- Gift certificates statuses (the link to this page is in the right menu on the Orders->Gift certificates page)
- Profile fields (under the Users tab)
- User Groups (under the Users tab)
- Shipping methods (under the Shipping/Taxes tab)
- Countries (and States if required) (under the Shipping/Taxes tab)
- Payment methods (under the Administration tab)
- Credit cards (under the Administration tab)
- Titles (under the Administration tab)
- Currencies (under the Administration tab)
- Top menu (under the Design tab)
- Quick links (under the Design tab)
- Blocks (under the Design tab)
- Pages to change the content of the Information block in the storefront (under the Content tab)
- Forms (the Contact us page) (under the Content tab)
- Also, it might be required to translate the following pages if there are any entries on them (it can be the result of enabling the appropriate addon):
- Gift certificates (the link to this page is under the Orders tab)
- Return requests statuses (translate this page if you plan to use the RMA addon) (the link to this page is in the right menu on the Orders->Return requests page)
- Banners (under the Content tab)
- Site news (under the Content tab)
- Products (under the Catalog tab)
- Categories (under the Catalog tab)
- Product features (under the Catalog tab)
- Product filters (under the Catalog tab)
- Global options (under the Catalog tab)
- Promotions (under the Catalog tab)
In order to translate the entries on the pages listed above:
- Open the necessary page and select the desired language in the language section in the top left corner of the page.
- Click on the edit link next to an entry (e.g. order status) and enter the necessary information in the selected language in the opened window.
- Click on the Save button.
- Repeat points 2-3 for the other entries on the page.
- In order to translate the list of options on the Settings page you should use the translation mode (point 3).
- In order to translate the list of available privileges click on the Translate privileges link on the Languages page.
NOTE: We recommend you closing the store when the translation mode is enabled, as long as some debugging information is displayed on the storefront then and it may confuse your customers.
- Log in to your store administration panel.
- Add a new language in CS-Cart (if it has not been added yet):
- Open the Content tab and click on the Languages link.
- Click on the Add language button in the top right corner.
- 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). The select box allowing users to choose a language will be displayed in the customer area and in the store administration panel.
- Most of CS-Cart texts are stored in the so called language variables. Although, they all can be viewed and edited under the Translations tab of the Languages page (it is under the Content root tab), we recommend to translate them in the following order:
- Open the Design tab, click on the Design mode link and click on the Enable translation mode button. In the translation mode the texts in your administration panel are highlighted with green.
- 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.
- 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.
- Click on the Save translation button.
- After you have translated all texts in your store administration panel, open the Design tab, click on the Design mode link, then click on the View STOREFRONT in translation mode. link. You will be redirected to the storefront and will need to translate the text pieces highlighted with green using the instructions from point 3.1.1-3.1.3.
- After you translate all visible texts, some language variables are still not translated as they are displayed in the e-mail notifications and in some special situations, i.e. error notifications, popup window messages etc. In order to translate the rest variables:
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.
- Translate texts in the VALUE input fields of the language variables on the page.
NOTE: Do not translate words written with lowercase words in square brackets, i.e. [link]; [product]; .... When this text is displayed in the storefront, such a variable will be replaced with an appropriate value automatically (e.g. [product] will be replaced with the corresponding product name). Namely, the word between square brackets is just a spot indicating where CS-Cart should place the appropriate value. So move it within the text, but do not delete. Translate the words written with uppercase letters in square brackets, i.e. [ALREADY PATCHED], [DELETED], [FAILED], [NON WRITABLE], ... They are the notifications generated by Upgrade Center and should be translated as well.
- 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.
- Translate texts in the VALUE input fields of the language variables on the page.
- Open the Design tab, click on the Design mode link and click on the Enable translation mode button. In the translation mode the texts in your administration panel are highlighted with green.
- Then it is necessary to translate the content of the following pages in the administration panel as they affect the storefront too:
- Order statuses (the link to this page is under the Orders tab)
- Gift certificates statuses (the link to this page is in the right menu on the Orders->Gift certificates page)
- Profile fields (under the Users tab)
- User Groups (under the Users tab)
- Shipping methods (under the Shipping/Taxes tab)
- Countries (and States if required) (under the Shipping/Taxes tab)
- Payment methods (under the Administration tab)
- Credit cards (under the Administration tab)
- Titles (under the Administration tab)
- Currencies (under the Administration tab)
- Top menu (under the Design tab)
- Quick links (under the Design tab)
- Blocks (under the Design tab)
- Pages to change the content of the Information block in the storefront (under the Content tab)
- Forms (the Contact us page) (under the Content tab)
- Also, it might be required to translate the following pages if there are any entries on them (it can be the result of enabling the appropriate addon):
- Gift certificates (the link to this page is under the Orders tab)
- Return requests statuses (translate this page if you plan to use the RMA addon) (the link to this page is in the right menu on the Orders->Return requests page)
- Banners (under the Content tab)
- Site news (under the Content tab)
- Products (under the Catalog tab)
- Categories (under the Catalog tab)
- Product features (under the Catalog tab)
- Product filters (under the Catalog tab)
- Global options (under the Catalog tab)
- Promotions (under the Catalog tab)
In order to translate the entries on the pages listed above:
- Open the necessary page and select the desired language in the language section in the top left corner of the page.
- Click on the edit link next to an entry (e.g. order status) and enter the necessary information in the selected language in the opened window.
- Click on the Save button.
- Repeat points 2-3 for the other entries on the page.
- In order to translate the list of options on the Settings page you should use the translation mode (point 3).
- In order to translate the list of available privileges click on the Translate privileges link on the Languages page.
NOTE: We recommend you closing the store when the translation mode is enabled, as long as some debugging information is displayed on the storefront then and it may confuse your customers.
- Log in to your store administration panel.
- Add a new language in CS-Cart (if it has not been added yet):
- Open the Administration tab and click on the Languages link.
- Click on the Add language button in the top right corner.
- 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). The select box allowing users to choose a language will be displayed in the customer area and in the store administration panel.
- Most of CS-Cart texts are stored in the so called language variables. Although, they all can be viewed and edited under the Translations tab of the Languages page (it is under the Content root tab), we recommend to translate them in the following order:
- Open the Design tab, click on the Design mode link and click on the Enable translation mode button. In the translation mode the texts in your administration panel are highlighted with green.
- 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.
- 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.
- Click on the Save translation button.
- After you have translated all texts in your store administration panel, open the Design tab, click on the Design mode link, then click on the View STOREFRONT in translation mode. link. You will be redirected to the storefront and will need to translate the text pieces highlighted with green using the instructions from point 3.1.1-3.1.3.
- After you translate all visible texts, some language variables are still not translated as they are displayed in the e-mail notifications and in some special situations, i.e. error notifications, popup window messages etc. In order to translate the rest variables:
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.
- Translate texts in the VALUE input fields of the language variables on the page.
NOTE: Do not translate words written with lowercase words in square brackets, i.e. [link]; [product]; .... When this text is displayed in the storefront, such a variable will be replaced with an appropriate value automatically (e.g. [product] will be replaced with the corresponding product name). Namely, the word between square brackets is just a spot indicating where CS-Cart should place the appropriate value. So move it within the text, but do not delete. Translate the words written with uppercase letters in square brackets, i.e. [ALREADY PATCHED], [DELETED], [FAILED], [NON WRITABLE], ... They are the notifications generated by Upgrade Center and should be translated as well.
- 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.
- Translate texts in the VALUE input fields of the language variables on the page.
- Open the Design tab, click on the Design mode link and click on the Enable translation mode button. In the translation mode the texts in your administration panel are highlighted with green.
- Then it is necessary to translate the content of the following pages in the administration panel as they affect the storefront too:
- Order statuses (the link to this page is under the Orders tab)
- Gift certificates statuses (the link to this page is in the right menu on the Orders -> Gift certificates page)
- Profile fields (under the Customers tab)
- User Groups (under the Customers tab)
- Shipping methods (under the Shipping/Taxes tab)
- Countries (and States if required) (under the Shipping/Taxes tab)
- Payment methods (under the Administration tab)
- Credit cards (under the Administration tab)
- Titles (under the Administration tab)
- Currencies (under the Administration tab)
- Top menu (under the Design tab)
- Quick links (under the Design tab)
- Blocks (under the Design tab)
- Pages to change the content of the Information block in the storefront (the link to this page is on the Website -> Content page)
- Forms (the Contact us page) (the link to this page is on the Website -> Content page)
- Also, it might be required to translate the following pages if there are any entries on them (it can be the result of enabling the appropriate addon):
- Gift certificates (the link to this page is under the Orders tab)
- Return requests statuses (translate this page if you plan to use the RMA addon) (the link to this page is in the right menu on the Orders->Return requests page)
- Banners (under the Website tab)
- Site news (under the Website tab)
- Products (under the Products tab)
- Categories (under the Products tab)
- Product features (under the Products tab)
- Product filters (under the Products tab)
- Global options (under the Products tab)
- Promotions (under the Products tab)
In order to translate the entries on the pages listed above:
- Open the necessary page and select the desired language in the language section in the top left corner of the page.
- Click on the edit link next to an entry (e.g. order status) and enter the necessary information in the selected language in the opened window.
- Click on the Save button.
- Repeat points 2-3 for the other entries on the page.
- In order to translate the list of options on the Settings page you should use the translation mode (point 3).
- In order to translate the list of available privileges click on the Translate privileges link on the Languages page.
NOTE: We recommend you closing the store when the translation mode is enabled, as long as some debugging information is displayed on the storefront then and it may confuse your customers.
- Log in to your administrator panel and click on the Languages link in the ADMINISTRATION side box.
- Enter the code, name and character set for a new language in the LANGUAGE CODE, LANGUAGE NAME and CHARACTER SET input fields in the Add new language section.
- Click on the Add new button below. The desired language will be added in the store (it will be the copy of English translation at the beginning).
- Select the newly created language in the Select description language select box at the top of the Language variables section. 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.
- Translate texts in the input fields under the Language variables section.
NOTE: Do not translate words written with lowercase letters in square brackets, i.e. [link]; [product]; .... When this text is displayed in the customer area, [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.
- Click on the Update 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.
- Then it is required to translate the content of the following pages in the admin panel as they affect the storefront too:
- Order statuses
- Gift certificate (click on the Gift certificate statuses link on the page)
- Return requests (there are the RMA reasons, RMA actions, RMA request statuses links on the page. Translate these pages if you plan to use the RMA addon)
- Profile fields
- Memberships
- Shipping methods
- Manage countries (and Manage states if required)
- Payment methods
- Credit cards
- Titles
- Currencies
- Top navigation
- Manage ads
- Manage pages (and Manage topics) to change the content of the Information side box in the storefront
- Form builder (the Contact us page)
- Site news
- Listmania (if you have any lists like Bestsellers, etc defined)
- It is also needed to translate products, categories, manufacturers as well as discounts, coupons, promotions, events (Gift Registry), etc if any are defined on the appropriate pages in the CS-Cart admin panel.
NOTE: In order to translate these objects you should select the desired language in the Select description language select box at the top of the appropriate pages.
- In order to translate the Settings page click on the Translate settings link on the Settings page. In order to translate the list of available privileges click on the Translate privileges link on the Languages page.
CS-Cart version: