Admin
Multi langugage

Set up machine translations

7min

Purple Hub



Summary

To configure machine translations within Purple Hub, you need to set up Polylang Pro and machine translations via the DeepL API. This article will guide you through the setup process.



Precondition

  • Have a 'Super Admin' role in the Purple Hub. If you don't have a Super Admin role, contact us and we can set it up for you. We are happy to help!
  • Have a Polylang Pro License Key generated. Learn more
  • Have a DeepL API Key for Translations generated. Learn more


Enabling Polylang Pro

In Purple Hub, in the left side menu, navigate to 'Plugins' -> 'Polylang Pro'

Plugins Page
Plugins Page


(1) Activate the Polylang Pro Plugin by clicking on this button

Important: Make sure to activate the 'Polylang Pro' Plugin, not 'Polylang'. Depending on your User role, you might not be able to access the Plugins Page in Purple Hub. If this is the case, please talk to us, we are happy to help.

Configuring Polylang Pro to work with Machine Translation

In Purple Hub, in the left side menu, navigate to 'Languages' —> 'Settings'

Below License keys, next to Polylang Pro, the license key coming from your Polylang subscription is stored.

Save Changes activates the connection to your Polylang Pro account.

License Keys Setup
License Keys Setup


Configuration of DeepL Machine Translation

In Purple Hub, in the left side menu, navigate to 'Languages' --> 'Settings'

For setting up the DeepL translations, scroll to Machine Translation

Machine Translation Setup
Machine Translation Setup


(1) Settings opens the setup options

(2) Deactivate Machine Translation in your Purple Hub

In case the setting Machine translations isn't visible on the settings page, Polylang Pro wasn't set up correctly and you should verify the setup.

Machine Translation Setup
Machine Translation Setup


(1) Data used: As soon as the API key for DeepL is successfully enabled (see 2), this bar appears, indicating the percentage of usage of available characters for translation, according to your plan in DeepL.

(2) the DeepL API key is stored in this entry field. You can get a new API key, with a subscription to the DeepL API (here) and afterwards following the instructions on the HelpCenter of the provider.

(3) Check connection to DeepL indicates, wether the API key you created is working. If the bar has turned green, after clicking on the button, you can continue with the setup. If the bar has turned red, you API key is invalid and you have to re-create it in order to proceed with the setup.

(4) Formality: Defines whether the translated text should have a formal or informal style: Choose from 'Default'; 'Prefer formal'; 'Prefer informal'. If your choice is not available for the target language, the default formality will be used.

(5) Cancel configuration

(6) Save Changes to make your configuration take effect in your Purple Hub