- Default language: it will for example be used when someone visits your homepage for the first time.
- If you are installing Polylang on an existing site, an option will be displayed in red: There are posts, pages, categories or tags without language set. Do you want to set them all to default language ? You can check this to quickly set up the language for all existing posts, pages, categories and post tags. It will also work for custom post types and custom taxonomies. It is important to note that the URL for posts, pages, categories, or tags is not modified.
- Detect browser language: check this option and when someone will visit your homepage for the first time it will be displayed according to his browser preferences. If his browser preferences do not include any language of your site, the default language will be used.
- URL modifications
There is first a very important choice to make. Either the language will be set from content of from the url (with 3 possibilities for this last case: the language code is used as a directory name in the url or as subdomain or you can even use one different domain per language).
Polylang was first designed to avoid modifying URL as much as possible and so, by default, adds the language information to the URL only when there is no other way to do (mainly the archives) and does not add it when it is not necessary (posts, pages, categories, post tags). Thus, if the plugin is de-activated, most importants links will not break.
However most plugins similar to Polylang do store the language information in all URL. Polylang offers this possibility too. There is no issue when the plugin is working well. However, if for some reason the plugin is de-activated, every URL loose the language information and thus all external links are broken.
If you want to use subdomains (or a different domain per language), all your subdomains (or domains) must point to the same directory (where the WordPress index.php is present).
If you encounter some issues with other plugins or with your theme, you can try one or the other option as Polylang sets the language quite differently (and not at the same time in the WordPress loading process) depending on wether the language is set by content or by the URL.
Additional options to control the urls are:
- Keep /language/ in pretty permalinks: the monthly archives URL will look like:
- Remove /language/ in pretty permalinks: the monthly archives URL will look like:
- Hide URL language information for the default language allows you to hide language information only for the default language. In this case the monthly archives URL in the default language will look like:
- The front page url contains the language code instead of the page name or page id. For example, the home URL will look like:
http://www.yoursite.com/home/. The option is not visible if you don’t use a static front page.
There are then further options to control how your site will handle languages and translations:
- Media: wether you want to translate the caption and description of your media.
- Synchronisation: when you create translations of your posts and pages, you may need to avoid repetitive actions such as setting categories and tags (taxonomies), featured image, page parent, and so on. Here you choose what you want to synchronize between translations or not.
Finally, if your site uses custom post types and taxonomies, your are offered the possibility to choose for which ones you want to manage languages and translations.
Don’t forget to click on the ‘save changes’ button.