3 – Strings translations

3 – Strings translations

Go to Languages > Strings translations. You must add at least one language to access this setting.
Polylang allows you to translate user defined strings such as the site title, the tagline, or the widget titles. Moreover themes and plugins can allow you to translate their options here.

The string column contains the source string. You can translate it in all your languages thanks to the input fields in the translations column. Don’t forget to click on save changes.

Advanced usage of strings translations
Translating slugs (Polylang Pro)

2 – Setup wizard

2 – Setup wizard

Setup wizard launch
When activating Polylang or Polylang Pro for the first time, the setup wizard is automatically launched with all the necessary steps to configure more easily a multilingual website.
You should have to follow each step one by one until the “Ready!” step at the end of the setup wizard.
Some additionals steps are added when activating Polylang for WooCommerce. For a full walkthrough of these steps, please read through the Polylang for WooCommerce installation documentation.
Note that if you skipped the setup wizard, you can run the setup wizard by going to Languages > Setup or by clicking on the button which should still be visible on all the most admin pages.

Please note that the setup wizard notice will be dismissed automatically when you come into the setup wizard “Ready!” step.
You will have to go through these steps below:

Licenses
Languages
Media
Content
Homepage
Ready!

Licenses step
If you have launched the setup wizard from Polylang Pro, a new step is added at the beginning: Licenses step.
We recommend you to fill in your Polylang Pro license key in the corresponding field at this step to ensure you will be able to receive automatic updates.

Languages step
This step is surely one of the most important because without any language defined your multilingual website will not work correctly.
So you should define at least one language, chosen in a list of more than 90 predefined languages.

The first language you add become the default language of your multilingual website.
Before continuing to the next step you can of course add several languages in the list by using the “Add new language” button.

Note: the languages are really created when you click on the “Continue” button.
Media step
If you want to translate the media fields (title, alternative text, description…) you need to keep this option checked, you can read more info about it in our documentation.

Content step
If you are installing and activating Polylang on an existing website, then all the existing contents have no language assigned yet. It is important that each content has a language otherwise your content is not displayed on the front end.
The default language will be assigned to all the existing content by default. However in this step you should be able to select another language that you added before at the languages step.

Homepage step
This step is only displayed when a static homepage has been defined in Settings > Reading. As it is mandatory to translate it in all languages, this step will create new pages linked to your existing homepage in all your languages.
If you are using Polylang, these newly created pages will be empty. With Polylang Pro your existing homepage will be duplicated in your other languages (with the exact same content, title and excerpt, untranslated).

Ready step
Congratulations! You have reached the last step of the setup wizard and you have correctly configured all that is absolutely required to make your multingual website work correctly.
You are now ready to manage and translate your contents in each language you have defined.
However, to get your website ready, there are still two steps you need to perform manually: add menus in each language, and add a language switcher to allow your visitors to select their preferred language. That is why you will find a button to directly access to our documentation from the setup wizard.

You can now quit the setup wizard by simply clicking the “Return to the Dashboard” button.

1 – Installation

1 – Installation

First installation
To install Polylang, follow the usual steps to install a plugin from the wordpress.org repository.
To install Polylang Pro,

Download polylang-pro.zip by following the link in your purchase receipt or from your account > Downloads tab.
In your WordPress Dashboard, go to the plugins list table and click on “Add New”
Click on “Upload plugin” and select the polylang-pro.zip file you previously downloaded
Activate Polylang Pro

Polylang setup wizard
When you are installing Polylang or Polyang Pro the first time, the setup wizard is automatically started. The goal is to help you get started more easily with Polylang by configuring the main features.
Migrating from Polylang to Polylang Pro
You can’t activate both versions of Polylang at the same time. Activating Polylang Pro will automatically deactivate Polylang. The migration is seamless, because both plugins are sharing the same data.
Removing Polylang after Polylang Pro activation
You can keep both versions on your hard disk, but you may want to save some space and delete Polylang before installing Polylang Pro. Here is how to proceed without loosing your data. If you do not feel comfortable with WordPress administration, it may be safer to make a database backup before proceeding.

Go to the plugins list table and de-activate Polylang
Click on the red delete link and confirm the deletion
Go back to the plugins list table and click on “Add New”
Click on “Upload plugin” and select the polylang-pro.zip file you previously downloaded
Activate Polylang Pro

How to renew a license key?

How to renew a license key?

You will receive an email about one month before the license key expires. Clicking on the link provided in this email directs you to the checkout page with pre-filled information for the renewal.
It is also possible to renew from you Account page > license keys tab. Click on “Extend license” and you will be redirected to the checkout page with pre-filled information for the renewal.

NB: If you purchased the Polylang Business Pack, you received 3 license keys, one for Polylang Pro, one for Polylang for WooCommerce and one for the Polylang Business Pack. Only the license of the Polylang Business Pack must be renewed (the other two will be automatically renewed at the same time). This will allow you to continue to take profit of the discount associated to the bundle.

How to upgrade a license key?

How to upgrade a license key?

Go to your Account page > License keys tab then click on the “View Upgrades” link next to your license key.
How will my upgrade price be calculated?
When upgrading your license you will pay the difference between the cost of your current license and the license you are upgrading to.
Case 1: Upgrade a Polylang Pro license to 3 or 5 or 25 sites.
In the following example we want to upgrade a Polylang Pro license 1 site at 99 € to a Polylang Pro license 3 sites at 198 €:
* the upgrade price will be: 198 € – 99 € = 99 € ex VAT
Case 2: Upgrade a Polylang Pro license to a Polylang Business Pack license.
Here we want to upgrade a upgrade a Polylang Pro license 1 site at 99 € to a Polylang Business Pack license 1 sites at 139 €:
* the upgrade price will be: 139 € – 99 € = 40 € ex VAT
Case 3: Upgrade a Polylang Business Pack license to 3 or 5 or 25 sites.
Here we want to upgrade a Polylang Business Pack license 1 site at 139 € to a 3 sites at 269 €
* the upgrade price will be: 269 € – 139 € = 130 € ex VAT
Note that the Polylang Business Pack is the package containing Polylang Pro and Polylang for WooCommerce. Since they are included in a package, you can not renew or upgrade your Polylang Pro and Polylang for WooCommerce license keys separately. You can only renew or upgrade the complete package.
Should I renew first before upgrading?
Upgrading a license key doesn’t extend its expiration time. Upgrades and renewals are completely disconnected and the order in which you do things is important. It’s indeed cheaper to renew first and upgrade after.
In the case you renew first your Polylang Pro license 1 site and upgrade to 3 sites, the cost will be 49,50 € (renewal cost of a license 1 site) + 99 € (difference cost between 1 site to 3 sites) = 148,50 € ex VAT
In the case you upgrade first your Polylang Pro license 1 site to 3 sites and renew it, the cost will be 99 € (difference cost between 1 site to 3 sites) + 99 € (renewal cost of a license 3 sites) = 198 € ex VAT

How to use different designs for different languages?

How to use different designs for different languages?

For language dependent CSS rules, you can use the :lang CSS selector.
Languages written from right to left use the rtl.css stylesheet already included in most themes.
It’s also possible to apply a different stylesheet for each language. Indeed, stylesheets named liked en_US.css, fr_FR.css or ar.css put in your theme directory will be automatically loaded by WordPress.
Note that in every cases, you have to keep the main style.css file.

How to unlink translations?

How to unlink translations?

To unlink translations, edit a post and delete the title of the post that you want to unlink in Languages metabox. The pen icon will turn to a plus sign.

How to translate the themes and plugins hardcoded strings?

How to translate the themes and plugins hardcoded strings?

This entry refers to strings which are written in the code of your plugin or theme. For strings entered in the theme or plugins options, you must use the Strings translations table.
Themes and plugins translations are handled in .po files ( human readable ) and .mo files ( machine readable ).
If your theme is correctly internationalized ( translation ready ), you can use Poedit or a plugin such as Loco translate to do the translation.
Plugins and themes available on wordpress.org can be translated online with Translating WordPress.
Ressources for developpers:
Theme internationalization
Theme localization
Child themes internationalization
How to Internationalize Your Plugin

How to uninstall Polylang?

How to uninstall Polylang?

There are two things to understand when uninstalling or removing Polylang or Polylang Pro.

If you deactivate and delete the plugin from WordPress, you only remove the plugin and its files. Your settings, languages and information linking translations together will still exist in the database.
If you need to remove ALL Polylang data, including languages, settings, etc., you need to be able to modify the site’s wp-config.php file before deactivating and deleting the plugin.

To fully remove all Polylang data from your WordPress site, open your site’s wp-config.php file. Add define( ‘PLL_REMOVE_ALL_DATA’, true ); on its own line above the /* That’s all, stop editing! Happy publishing. */ line.
Then when you deactivate and delete Polylang or Polylang Pro it will remove all of its data from your WordPress site database.