Powerling extension

Getting ready

First step is to require the sources:

composer require powerling/akeneo-extension 3.2

Note: replace `3.2` with your version if it is not 3.2 (e.g. `2.3` if your version of Akeneo is 2.3). Versions currently supported are 2.3, 3.0, 3.1 and 3.2

Register your bundle in the AppKernel::registerProjectBundles:

new \Pim\Bundle\PowerlingBundle\PimPowerlingBundle(),

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 app/config/routing.yml:

powerling: resource: "@PimPowerlingBundle/Resources/config/routing.yml"

Update the database schema and regenerate your cache and assets:

rm -rf var/cache/* web/bundles/* web/js/* web/css/*
bin/console doctrine:schema:update --force --env=prod
bin/console p:i:a --env=prod
bin/console a:i --env=prod
yarn run webpack
find ./ -type d -exec chmod 755 {} \;
find ./ -type f -exec chmod 644 {} \;

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'