Introduction:
Akeneo Content Translator is used to translate the localized attribute from one locale to multiple other locales. The store owner needs to map the attribute and locale and then select the products and perform bulk action to translate the product attributes. The store owner can choose the locale and scope that will be translated to other selected locales.
Basic Requirements:
- This module works with Akeneo 2.0.x, 2.1.x, 2.2.x, 2.3.x, 3.0.x, 3.1.x, 3.2.x and 4.0.x. Download Akeneo from here
- Node and Yarn packages need to be installed.
- Also works with Akeneo Cloud Flexibility Mode which is a PAAS Edition of Akeneo
Features:
- Translate localized attributes from one locale to multiple other locales.
- Change Translation of Product and Product Module localizable text and text area type attributes.
- Select products from the product grid to make the translation of products.
Installing Module For Version 4.0.x
Please follow these steps for installing the Akeneo content translator module in your Akeneo PIM platform.
1 – Unzip the respective extension zip then merge the “src” folder into akeneo project root directory.
2 – Goto config/Bundles.php then add line:
Webkul\AkeneoTranslatorBundle\AkeneoTranslatorBundle::class => ['all' => true],
in return array.
3 – Copy the “config” folder into akeneo project root directory for routing.
4 – Run this command after ssh to your akeneo server by the terminal.
rm -rf ./var/cache/** && php bin/console wk-translator:setup:install
5. If you are using php-fpm. Then you need to restart the php-fpm services and apache web server.
sudo service php-fpm7.3 restart
Installing Module for Version 2.x to 3.x
Please follow these steps for installing the Akeneo content translator module in your Akeneo PIM platform.
1 – Unzip the respective extension zip then merge the “src” folder into akeneo project root directory.
2 – Goto app/AppKernel.php then add line.
new Webkul\AkeneoTranslatorBundle\AkeneoTranslatorBundle(),
3 – Goto app/config/routing.yml then add these lines at top of file
akeneo_translator: resource: "@AkeneoTranslatorBundle/Resources/config/routing.yml" prefix: /
4 – Run this command after ssh to your akeneo server by the terminal.
rm -rf ./var/cache/** && php bin/console wk-translator:setup:install
5. If you are using php-fpm. Then you need to restart the php-fpm services and apache web server.
sudo service php-fpm7.2 restart
How to Create Google API Key
Go to https://console.cloud.google.com/
To create your API key simply follow the steps below:
1. Create a new Project from the top bar for that click on select a project.
2. After that click to new project then add the name and click to save button.
2. With the new project selected, go to the hamburger menu to the left and visit API & Services from Dashboard enable Google Translate API
3. Search for translate API and enable it.
4. From the credentials interface create a new API Key.
5. Restrict your API Key to a particular website
After that click to save button.
Configuration
Akeneo Content Translation after installing the module in Akeneo, navigate to the Akeneo Dashboard. Here, you will see the Webkul Akeneo Translator icon at the left side of the screen.
Credentials:
Now to add credentials you have to navigate Akeneo translator>>Credential. After that, you have to fill the API key.
Locale Mapping:
In the Locale Mapping section, you can map the akeneo locale with the google locale code. Find the link for the locale code here – https://developers.google.com/admin-sdk/directory/v1/languages
Attribute Mapping:
In this you can add all the localizable attribute you can add two type of attributes text and text area attributes.
After that click to Save button.
Workflow
To translate the localized attribute from one locale to multiple other locales you have to go to product select the products.
In this you can select multiple product at a time.
After that click to Bulk action to perform the action translation. After that, it will redirect to the new page where you have to follow three steps:
1 – Select Action
In this, you have to select your action for the bulk action Change Translation. After that click to the next button.
2 – Change Translation
To change the translation you have to fill the details like:
- Change from locale and Change from Scope – In this, you have to select the locale and scope from which you want to change the translation.
- Change to locale and Change to Scope – In this, you have to select the locale and scope in which you want to change the translation. You can select multiple locales in this.
After selecting the locale and scope click to Next button.
3 – Confirm
In this you have to click to Confirm to confirm the process of translation.
After click to confirm you can will recieve a notification.
After that go to process tracker then check the execution details.
Now check the product details in different locale.
English:
French:
Support
This was all about the Akeneo Content Translator. I hope you must have the got the idea of our module. Thanks for taking the time in reading this blog. And also, please doesn’t forget to share your feedback and suggestions under the comment box given below.
Moreover, If you have any queries or suggestions, then feel free to add a ticket at our HelpDesk system.