Installation

After downloading the add-on, it is installed using standard CS-Cart tools, on the page Administrator Panel → Add-ons → Downloaded add-ons → Gear button → Manual installation (For CS-Cart version later than 4.18.1)

Click Download, in the window that appears, select the add-on file, then Download and install

Setup

1. After installation, go to its settings. To do this, follow these steps: Administrator Panel → Add-ons→ Downloaded add-ons → AI Translator (GPT) → Settings → General and activate the necessary parameters:

   

   • Translation service:

     Select the service that will be used for translation. Two options are available:

     • ContentGenius GPT – AI-based translation.

       💡 To purchase additional tokens, follow the link to our website https://makeshop.pro/en/gpt/ and select the desired package.

       

     • Yandex translator – translation service from Yandex.

       To work, you need to specify:

       1. API key
       2. Catalog ID

       To get this data, follow these steps:

       1. Log in to the site cloud.yandex.ru

          

       2. We will be redirected to the control panel, here we need to link the payment account

          

       3. We enter all the data and save the payment account. After linking, the account will become active

       4. Go to the OAuth token page and click “You can get an OAuth token for working with Yandex Cloud using request”, we will be redirected to the page with the token, copy it (OAuth token is obtained automatically)

          

          The token must be entered in the add-on settings

          

       5. On the main page we need to get the folder ID from the paid account

          

          We specify it in the add-on settings

          

   • Request balance:

     Shows how many requests for translation are still available.

     ⚠️ This option is only available if you select ContentGenius GPT in the Translation service setting

   • The main language of the storefront:

     Specify the language from which texts will be translated into other site languages.

   • Translate when editing a product:

     Determines which data will be translated when editing a product. Possible options:

     • Don’t translate – disables automatic translation when editing.
     • Translate empty languages – translation is performed only for languages ​​where the text is missing, minimizing the number of requests.
     • Translate into all languages – translation is performed to all languages, even if the text has already been translated previously.

   • Translate when editing a category:

     Check the box if you want categories to be automatically translated when editing.

   • Translate when editing a company description:

     Check this box if you want the company description to be translated automatically when editing.

   • Translate hidden and disabled entities:

     Check this box if you want to translate even those entities (products, categories, etc.) that are hidden or disabled.

2. The Cron tab in the add-on settings contains commands that allow you to automate the translation of content on the site. These commands are run on a schedule and translate products, categories, and seller descriptions without the need for manual intervention.

   

   There are three commands available:

   1. Cron. Translate already created products:

      Allows you to automatically translate product names and descriptions on a schedule.

   2. Cron. Translating categories:

      Translates category names and descriptions automatically.

   3. Cron. Translation of seller's description:

      Performs automatic translation of the company (seller) description.

   To perform automatic translation manually, go to the following page: Administrator Panel → Web-site → MS: Autotranslations and run the necessary translation by clicking the button:

   

   • Transfer of goods:

     Runs translation of the name and description in all previously created products.

   • Translation of language variables:

     Runs translation in all language variables.

   • Translating categories:

     Runs translation in all categories.

   • Translation of the seller's description:

     Starts the translation of created company descriptions.

   • Translation of characteristics:

     The first button starts the translation of the filter name, and the second one starts the translation of all characteristics.

   • Menu translation:

     Starts the translation of all menu items.

If you need to exclude a product from automatic translation, open its page and uncheck the Translate checkbox in the MS: Automatic translation section.

3. After completing these settings, the translation can be started manually or automatically according to a schedule. Use Cron commands to automate the translation or perform it through the admin panel in the MS: Autotranslations section for convenient process management.