User Guide for Magento 2 AI Locale Translator

Magento 2 AI Locale Translator uses artificial intelligence to translate language files. This helps you make your store available in many languages.

It supports multiple AI models like ChatGPT, Gemini, and Ollama.

This tool is ideal for store owners who want to offer a multilingual experience without manual work. It saves time and improves accuracy.

Now if you want to generate an AI concise product review summary on the product pages you can check the Magento 2 AI Product Review Summary Extension.

You can also go through the below video to get to know the functionality.

• Translates CSV locale files (e.g, en_US.csv) into any target language.
• Automatically generates and saves translations for selected modules.
• Automates CSV file translation based on store views.
• Admin can choose which modules to translate.
• Provide multilingual store experience effortlessly
• Supports ChatGPT, Gemini, and Ollama AI models.
• The admin can enable/disable the module
• The admin can download and review the translated language files
• The admin can check the translation process status
• The admin can delete the translated files
• Easy configuration from Magento admin panel.
• Improve accuracy with advanced AI-powered translations
• Saves time and reduces manual translation errors.

#1 Download Module

Firstly, you need to log in to the Webkul Store, go to My Account>My Purchased Products section, verify, and then download and extract the contents of this zip folder on the system.

#2 Upload Folder

Once the module zip is extracted, follow path src>app and then copy the app folder into the Adobe Commerce Cloud root directory on the server as shown below:

#3 Run Commands

After uploading the module folder, you need to run the following commands in the Magento 2 root directory:

php bin/magento setup:upgrade

php bin/magento setup:di:compile

php bin/magento setup:static-content:deploy

php bin/magento indexer:reindex

php bin/magento cache:flush

If you need to do the module translation, please navigate to the following path in your system app/code/Webkul/AILocaleTranslator/i18n.

Open the file named en_US.CSV for editing as shown in the below screenshot.

Once you have opened the file for editing. Replace the words after the†comma(,)†on the right with your translated words.

After editing and translating the CSV file, you need to save the translated file name according to your region language and country code such as – de_DE.CSV.

Then upload the translated file to the same folder from where you have obtained it. Now your module translation is complete.

The user has to first create an OpenAI account and log in to the OpenAI dashboard as shown in the screenshot.

Now the user will have to click on the Personal in the top-right corner and a popup will appear. The user will click on the View API Keys option.

A page will open and a button Create New Secret Key will be visible as shown in the screenshot.

Once, the user clicks on this button a pop-up will display with the API key. The user can copy the key from here with the help of the copy button.

Note – If you want to translate your product reviews then you can use our Magento 2 AI Review translator extension for translation.

The user has to first create and log in to the Google Gemini dashboard, then select the Get API key and continue, as shown in the screenshot.

Then click on Get API Key:

After that, it will redirect to a new page, and you can click on create api key to get the api key.

Then create the API for the new project.

After that, a popup will appear, from which the new API key will be copied.

After successfully installing the AI Locale Translator module, the admin can navigate to: Stores -> Configuration -> Webkul -> AI Locale Translator -> General Settings

Once you select Yes for the enable module in the AI model, you have to select Ollama or Gemini, or ChatGPT as per your requirement.

Here, the admin must make the configurations below to set the module settings.

Enable Module- Enable the module status from here.

AI Model – Select ChatGPT here.

ChatGPT Model: The admin can select the latest ChatGPT model from here.

ChatGPT API Secret- Enter the API secret key from the OpenAI account

If the admin selects the Ollama AI model, then they have to configure it accordingly.

Enable Module- Enable the module status from here.

AI Model – Select Ollama here.

Ollama Endpoints – Enter the Ollama endpoint (Ex: http://localhost:11434).

Ollama Model: Now the admin can select the Ollama model from various available Ollama models.

If the admin selects the Gemini AI model then they have to configure it accordingly.

Enable Module- Enable the module status from here.

AI Model – Select Gemini here.

Gemini Model: The admin can select the latest Gemini model from here.

Max Output Token: Enter the Max Output Token for the model (Ex: 1024)

Gemini API Secret- Enter the API secret key from the Gemini account

To set up the Locale Language, navigate to Stores -> Configuration -> General -> General -> Locale Options
Here, select the Locale Language as per the need. After the locale language is selected, we can proceed to create translation.

To create and manage translation, navigate to AI Locale Translator from the adminend sidebar menu

This has three sections:

• Create Translation -> Create translation of modules
• Translation List -> View and Download the translation
• Configurations -> Module configuration

To generate translation files, navigate to AI Locale Translator → Create Translation, then select the target language and the modules that you want to translate, and click Generate.

Note: You can select multiple modules for translation at once.

After creating the translation, run the following commands

php bin/magento cron:install

php bin/magento cron:run

To view translation files, navigate to AI Locale Translator → Translation List

Here, all generated translations are listed in one place for easy review and management. From this section, we can:-

• Check the status of all the translations.
• Check source language, target language, translation type, and module name.
• Access the file path of the generated translation.
• Download the translated CSV file directly.
• Delete the translated CSV file

After the translation is completed, navigate to the module that you have translated. Now your module will be translated into your target language

That is all about the Magento 2 AI Locale Translator extension. 

If you have any queries regarding the plugin, please contact us at Webkul Support System.

You may also check our top-quality Magento 2 AI Extensions. Extensions.