Creating the languages

Polylang comes with a list of more than 50 predefined languages. Go to the languages page found in the WordPress settings menu. Choose a language in the dropdown list and click on the ‘add language’ button.

If you need a language not included in the list, or if you are not happy with the default settings of a language, you can edit it yourself. There are five fields for each language.

  • Full name: it is the name which will be displayed on your site. For example: English, Français, Deutsch, Italiano.
  • Locale: it is the code used by WordPress for each language. It is very important to enter the exact WordPress locale for the language, otherwise the theme translation will not work. It is generally made with two lower case characters, an underscore, and two upper case characters. For example: en_US, fr_FR, de_DE. There are however some locales made with only two or three lower case characters. For example: ar, el, ckb.
  • Language code: this code will be used to build the url. It is best to use the (lower case) 2-characters ISO 639-1 language. For example: en, fr, de.
  • Text direction: most languages are written left to right, but some are written right to left (Arabic, Hebrew and some others). Just choose the right option for your language. Polylang will thus inform the theme it has to load the LTR or RTL style. Note that not all themes are compatible with both text directions (of course Twenty Ten,Twenty eleven and Twenty Twelve are !)
  • Order: it is possible to choose the order in which the language will be displayed in the language switcher

Don’t forget to click on the ‘add language’ button and redo the operation for all languages you need for your site. There is no limit for the number of languages.

By default, WordPress comes only with English. For other languages, Polylang will try to automatically download corresponding WordPress language files. If, for some reason, it does not succeed, you can try to download them at: http://svn.automattic.com/wordpress-i18n/. You then would have to upload these files to the ‘/wp-content/languages/’ directory.

Polylang will also try to download Twenty Ten, Twenty Eleven and Twenty Twelve language files. If for some reason it does not work, you can download them at the same address as above and upload the files to ‘/wp-content/themes/your_theme/languages’

Note: Although some languages have been included in the predefined languages list, the languages files will not be downloaded or updated automatically and need to be installed manually. For more information: http://codex.wordpress.org/WordPress_in_Your_Language