User Guide for Magento 2 AI Locale Translator

Magento 2 AI Locale Translator is an AI-powered extension that automatically translates Magento store content into multiple languages.

It uses advanced AI models like ChatGPT and Gemini to automate translations.
This helps you manage both frontend and backend content quickly and without manual effort.

Managing multilingual content manually takes time and often leads to errors.It also creates inconsistency across store views and product data.

This module solves these issues by automating translations and keeping content consistent.
It improves accuracy and saves time for store owners and teams.

This extension is ideal for businesses that want to expand into global markets.
It helps deliver a seamless and localized shopping experience across multiple languages.

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.

• Automatically generates and saves AI-based translations for Magento 2 products, categories, CMS pages, and module locale content.
• Translates product content, including titles, descriptions, and related details, into multiple languages.
• Enables translation of product attributes to help manage multilingual product data easily.
• Supports translation of categories to keep catalog structure consistent across store views.
• Allows CMS page translation in Magento 2 to deliver localized content and improve user experience.
• Translates CSV locale files (e.g., en_US.csv) into any target language.
• Translates Magento 2 modules for complete storefront and admin panel localization.
• Automates CSV file translation based on store views.
• Provides a multilingual store experience effortlessly.
• Supports ChatGPT and Gemini AI models.
• Allows easy enable or disable control of the module.
• Provides options to download, delete, and manage translation files efficiently.
• Displays translation process status for better tracking and control.
• Improves translation accuracy and multilingual SEO performance with AI-powered processing.

#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

php bin/magento cron:install

php bin/magento cron:run

php bin/magento ailocaletranslator:translate:product

php bin/magento ailocaletranslator:translate:category

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 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 the Enable Module option is set to Yes, select the desired AI model such as ChatGPT or Gemini.

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

Fetch Models: This pulls the latest available versions directly from the AI provider, so you’re always working with current options

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: Click the “Fetch Latest Models” button to automatically retrieve and display the most recent available Gemini models.

Max Output Token: Enter the Max Output Token for the model

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

Note: After entering the respective API key and saving the configuration, the models available for the selected AI service will be fetched automatically.

• To configure the Locale Language, first navigate to Stores → Configuration.
• Next, select the Store View for which you want to configure the language from the scope dropdown at the top-left corner.
• Then navigate to General → General → Locale Options.
• Next, choose the Locale Language according to the language you want to apply for the selected store view.
• Once the locale language is configured for the store view, you can proceed to generate translations.

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

This has three sections:

• Create Translation: Create translation for selected Magento default and installed modules.
• Translation List: View, Delete, and Download the translation files.
• Configurations: Module configuration.

• Navigate to AI Locale Translator → Create Translation to start generating translation files.
• Select the target language from the Select Language Translate To field.
  The list shows languages configured for available store views.
• Choose the modules you want to translate from the Select Module section.
  This lets you control which content gets translated.
• Click the Generate button to start the translation process.
• The module begins processing based on your selected options.
  The system automatically generates translated CSV files for selected modules.

Note: You can select multiple modules and multiple languages at the same time to generate translation files in bulk.

• First, navigate to Catalog → Products to start product translation.
• Then, select the checkbox for the product(s) you want to translate.
  You can choose multiple products for bulk translation.
• Next, click the Actions dropdown above the product grid.
  Then, select Translate to [Store View] based on your target language.
• After that, click the OK button to confirm the action.
• The system will start the translation process automatically.
• Finally, the module translates product content and supported attributes.
  It saves the translated data for the selected store view language.

• First, navigate to Catalog → Categories in Magento Admin Panel.
• Then, select the category you want to translate from the category tree.
• Next, click the Translate button available on the category page.
• A popup will appear with available store views.
• Then, select the store view(s) for translation or choose Select All Stores.
  This lets you translate the category into multiple languages at once.
• After that, click the Translate/OK button to start the process.
  The system will begin translating the selected category data.

• First, navigate to Stores → Attributes → Product from Magento Admin Panel.
• Then, select the checkbox for the attribute(s) you want to translate.
  You can choose multiple attributes for bulk translation.
• Next, click the Actions dropdown above the attributes grid.
  Then, select Translate to [Store View] based on your target language.
• After that, click the Submit/OK button to confirm the action.
• The system will start the translation process automatically.
• Finally, the module translates selected product attribute labels.
  It saves the translated content for the selected store view language.

Note: You can use CLI commands to generate translations for products and categories.

Run php bin/magento ailocaltranslator:translate:product for product translation.
Run php bin/magento ailocaltranslator:translate:category for category translation.

• First, navigate to Content → Pages in Magento Admin Panel.
• Then, select the checkbox for the CMS page(s) you want to translate.
  You can choose multiple pages for bulk translation.
• Next, click the Actions dropdown above the pages grid.
  Then, select Translate to [Store View] based on your target language.
• After that, click the Submit/OK option to confirm the action.
• The system will start the translation process automatically.

Note: You can use CLI commands to generate product and category translations.
They help you automate translation without using the admin panel.

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, the admin 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.

• To view translated content in the admin panel, first change the Interface Locale language.
• Go to Admin User Settings → Interface Locale and select your desired language.
• Then, save the settings to apply the selected language.
• The admin panel will update based on your chosen locale.
• Finally, the translated modules will show localized content in the admin panel.
  Refer to the images below to see the applied translations.

• After the translation process is complete, go to the storefront of your Magento store.
• Then, switch to the store view for which the translation was generated.
• After that, the translated content will appear across the storefront.
  All updates will reflect based on the selected store view language.
• The module interface text, labels, and storefront elements will display in the selected language.
  This provides a localized and seamless experience for customers.
• Finally, refer to the images below to see how the translated module appears.
• These examples show the applied translations on the storefront.

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.