Powerling Add-on and API Connector
Description
Introduction
In order for you to easily translate your Akeneo product content to a large quantity of languages with a simple process, Powerling has developed two different products:
- Powerling x Akeneo API connector: A web platform that leverages the APIs of your Akeneo in order to retrieve and translate your Akeneo content without the need to install anything on your premises
- Powerling x Akeneo Add-on Extension: An Akeneo Extension that you need to install on your Akeneo that adds a "Translate with Powerling" to your Akeneo Mass Edit actions.
No more copy and pasting, your workflow is optimized and all your product content is in one place !
Powerling guarantees the best quality control of your translations by our incountry teams (we have offices in 3 time-zones - Europe, Hong-Kong and Boston). Together, we make the world your playground !
Powerling x Akeneo Add-on Extension
Description
The Powerling x Akeneo extension allows you to easily translate your Akeneo product content to a large quantity of languages with a simple mass edit process.
Compatibility
The plugin works with any non-SaaS Akeneo PIM versions 2.3.x, 3.x, 4.x, and 5.x both Community Edition and Enterprise Edition
In other words, it is compatible with the following Akeneo PIM:
- CE/EE On-Premise Akeneo versions 2.3.x, 3.x, 4.x and 5.x
- Akeneo Flexibility versions 2.3.x, 3.x, 4.x and 5.x
Requirements
In order to start using this extension, first contact our sales team through this form: https://powerling.com/contact/cms-token Once the modalities of the collaboration settled (language pairs, billing information, etc...), you will be provided with an API token
Powerling x Akeneo API connector
Description
The Powerling x Akeneo API connector is a web platform hosted by Powerling that leverages your Akeneo API connection in order to retrieve and update your products for translation.
Compatibility
The connector is compatible with all Akeneo PIMs from version 1.7 up to the latest 5.0 and Serenity SaaS
In other words, it is compatible with the following Akeneo PIM:
- CE/EE On-Premise Akeneo versions 1.7, 2.x, 3.x and 4.x and 5.x
- Akeneo Flexibility versions 1.7, 2.x, 3.x, 4.x and 5.x
- Akeneo Serenity
- Akeneo Growth Edition
Requirements
In order to start using this extension, first contact our sales team through this form: https://powerling.com/contact/cms-token Once the modalities of the collaboration settled (language pairs, billing information, etc...), we will ask you to setup a Powerling connector and provide us the generated credentials.
Documentation
Powerling x Akeneo Add-on Extension
Installation
This documentation is for an installation on the latest version of Akeneo (5.0)
You may find the documentation related to your version of Akeneo on the corresponding branch of the github project.
Getting ready
First step is to require the sources:
composer require powerling/akeneo-extension 5.0
Register the bundle in config/bundles.php
:
Pim\Bundle\PowerlingBundle\PimPowerlingBundle::class => ['all' => true],
Clear cache:
rm -rf var/cache && bin/console cache:warmup
Then we need to add a new mass edit batch job:
bin/console akeneo:batch:create-job 'Powerling Connector' 'powerling_start_projects' "mass_edit" 'powerling_start_projects'
Add the new routes used by the extension to the global router. Add the following lines at the end of config/routes/routes.yml
(create the file if it does not exist):
powerling: resource: "@PimPowerlingBundle/Resources/config/routing.yml"
Update the database schema and regenerate your cache and assets:
bin/console doctrine:schema:update --force --env=prod
NO_DOCKER=true make cache
NO_DOCKER=true make assets
NO_DOCKER=true make javascript-extensions
NO_DOCKER=true make css
NO_DOCKER=true make javascript-prod
Finally, you must set a cron
to retrieve the translated contents from Powerling:
0 * * * * /home/akeno/pim/bin/console pim:powerling:retrieve-translations >> /tmp/powerling.log
This command checks for translated content once every hour. We do not recommend to check more often than every hour to not overload the Powerling servers.
Sandbox
When you install the extension, it aims at Powerling's sandbox environment. In order to make it aim at the production environment, add the following line to your parameters.yml file:
powerling.base_uri.app: 'https://api.powerling-tp.com'
Documentation
The translation request is done by a very simple mass edit process:
- Select your products in the grid and choose the "translate with Powerling" mass edit operation.
- Choose the language association used for this translation project.
- Send your products to Powerling in just one click
- Your products will be pushed back in the PIM as soon as the translation is complete
Powerling x Akeneo API connector
Installation
In order to get going, we only need you to create a Powerling connector on your Akeneo and provide us with the generated API credentials
Documentation
The web platform allows you to filter your product base in order to select which products you want to send for translation.
You can then specify your translation languages, give the project a name and send it for translation