| 1 |
=== Polylang === |
| 2 |
Contributors: Chouby, manooweb |
| 3 |
Donate link: https://polylang.pro |
| 4 |
Tags: multilingual, bilingual, translate, translation, language, multilanguage, international, localization |
| 5 |
Requires at least: 4.7 |
| 6 |
Tested up to: 5.2 |
| 7 |
Stable tag: 2.6.3 |
| 8 |
License: GPLv3 or later |
| 9 |
|
| 10 |
Making WordPress multilingual |
| 11 |
|
| 12 |
== Description == |
| 13 |
|
| 14 |
= Features = |
| 15 |
|
| 16 |
Polylang allows you to create a bilingual or multilingual WordPress site. You write posts, pages and create categories and post tags as usual, and then define the language for each of them. The translation of a post, whether it is in the default language or not, is optional. |
| 17 |
|
| 18 |
* You can use as many languages as you want. RTL language scripts are supported. WordPress languages packs are automatically downloaded and updated. |
| 19 |
* You can translate posts, pages, media, categories, post tags, menus, widgets... |
| 20 |
* Custom post types, custom taxonomies, sticky posts and post formats, RSS feeds and all default WordPress widgets are supported. |
| 21 |
* The language is either set by the content or by the language code in url, or you can use one different subdomain or domain per language |
| 22 |
* Categories, post tags as well as some other metas are automatically copied when adding a new post or page translation |
| 23 |
* A customizable language switcher is provided as a widget or in the nav menu |
| 24 |
|
| 25 |
> The author does not provide support on the wordpress.org forum. Support and extra features are available to [Polylang Pro](https://polylang.pro) users. |
| 26 |
|
| 27 |
If you wish to migrate from WPML, you can use the plugin [WPML to Polylang](https://wordpress.org/plugins/wpml-to-polylang/) |
| 28 |
|
| 29 |
If you wish to use a professional or automatic translation service, you can install [Lingotek Translation](https://wordpress.org/plugins/lingotek-translation/), as an addon of Polylang. Lingotek offers a complete translation management system which provides services such as translation memory or semi-automated translation processes (e.g. machine translation > human translation > legal review). |
| 30 |
|
| 31 |
= Credits = |
| 32 |
|
| 33 |
Thanks a lot to all translators who [help translating Polylang](https://translate.wordpress.org/projects/wp-plugins/polylang). |
| 34 |
Thanks a lot to [Alex Lopez](http://www.alexlopez.rocks/) for the design of the logo. |
| 35 |
Most of the flags included with Polylang are coming from [famfamfam](http://famfamfam.com/) and are public domain. |
| 36 |
Wherever third party code has been used, credit has been given in the code’s comments. |
| 37 |
|
| 38 |
= Do you like Polylang? = |
| 39 |
|
| 40 |
Don't hesitate to [give your feedback](http://wordpress.org/support/view/plugin-reviews/polylang#postform). |
| 41 |
|
| 42 |
== Installation == |
| 43 |
|
| 44 |
1. Make sure you are using WordPress 4.7 or later and that your server is running PHP 5.2.4 or later (same requirement as WordPress itself) |
| 45 |
1. If you tried other multilingual plugins, deactivate them before activating Polylang, otherwise, you may get unexpected results! |
| 46 |
1. Install and activate the plugin as usual from the 'Plugins' menu in WordPress. |
| 47 |
1. Go to the languages settings page and create the languages you need |
| 48 |
1. Add the 'language switcher' widget to let your visitors switch the language. |
| 49 |
1. Take care that your theme must come with the corresponding .mo files (Polylang automatically downloads them when they are available for themes and plugins in this repository). If your theme is not internationalized yet, please refer to the [Theme Handbook](https://developer.wordpress.org/themes/functionality/internationalization/) or ask the theme author to internationalize it. |
| 50 |
|
| 51 |
== Frequently Asked Questions == |
| 52 |
|
| 53 |
= Where to find help ? = |
| 54 |
|
| 55 |
* First time users should read [Polylang - Getting started](https://polylang.pro/doc-category/getting-started/), which explains the basics with a lot of screenshots. |
| 56 |
* Read the [documentation](https://polylang.pro/doc/). It includes a [FAQ](https://polylang.pro/doc-category/faq/) and the [documentation for developers](https://polylang.pro/doc-category/developers/). |
| 57 |
* Search the [community support forum](https://wordpress.org/search/). You will probably find your answer here. |
| 58 |
* Read the sticky posts in the [community support forum](http://wordpress.org/support/plugin/polylang). |
| 59 |
* If you still have a problem, open a new thread in the [community support forum](http://wordpress.org/support/plugin/polylang). |
| 60 |
* [Polylang Pro](https://polylang.pro) users have access to our helpdesk. |
| 61 |
|
| 62 |
= Is Polylang compatible with WooCommerce? = |
| 63 |
|
| 64 |
* You need a separate addon to make Polylang and WooCommerce work together. [A Premium addon](https://polylang.pro/downloads/polylang-for-woocommerce/) is available. |
| 65 |
|
| 66 |
= Do you need translation services? = |
| 67 |
|
| 68 |
* If you want to use professional or automatic translation services, install and activate the [Lingotek Translation](https://wordpress.org/plugins/lingotek-translation/) plugin. |
| 69 |
|
| 70 |
== Screenshots == |
| 71 |
|
| 72 |
1. The Polylang languages admin panel |
| 73 |
2. The Strings translations admin panel |
| 74 |
3. Multilingual media library |
| 75 |
4. The Edit Post screen with the Languages metabox |
| 76 |
|
| 77 |
== Changelog == |
| 78 |
|
| 79 |
= 2.6.3 (2019-08-06) = |
| 80 |
|
| 81 |
* Pro: Fix fatal error when updating an ACF field from frontend |
| 82 |
* Pro: Add action 'pll_post_synchronized' |
| 83 |
* Allow to get the current or default language object using the API. Props Jory Hogeveen. #359 |
| 84 |
* Fix empty span in languages switcher widget when showing only flags |
| 85 |
* Fix wpml_register_single_string when updating the original string |
| 86 |
|
| 87 |
= 2.6.2 (2019-07-16) = |
| 88 |
|
| 89 |
* Pro: Fix slow admin in case the translations update server can't be reached |
| 90 |
* Pro: Fix value not correctly translated for ACF clone fields in repeater |
| 91 |
* Fix strings translations mixed when registered via the WPML compatibility. #381 |
| 92 |
|
| 93 |
= 2.6.1 (2019-07-03) = |
| 94 |
|
| 95 |
* Pro: Fix Yoast SEO sitemap for inactive languages when using subdomains or multiple domains |
| 96 |
* Fix fatal error in combination with Yoast SEO and Social Warfare |
| 97 |
* Fix post type archive url in Yoast SEO sitemap |
| 98 |
|
| 99 |
= 2.6 (2019-06-26) = |
| 100 |
|
| 101 |
* Pro: Remove all languages files. All translations are now maintained on TranslationsPress |
| 102 |
* Pro: Move the languages metabox to a block editor plugin |
| 103 |
* Pro: Better management of user capabilities when synchronizing posts |
| 104 |
* Pro: Separate REST requests from the frontend |
| 105 |
* Pro: Copy the post slug when duplicating a post |
| 106 |
* Pro: Duplicate ACF term metas when terms are automatically duplicated when creating a new post translation |
| 107 |
* Pro: Fix hierarchy lost when duplicating terms |
| 108 |
* Pro: Fix page shared slugs with special characters |
| 109 |
* Pro: Fix synchronized posts sharing their slug when the language is set from the content |
| 110 |
* Pro: Fix PHP warning with ACF Pro 5.8.1 |
| 111 |
* Pro: Fix ACF clone fields not translated in repeaters |
| 112 |
* Better management of user capablities when synchronizing taxonomies terms and custom fields |
| 113 |
* Extend string translations search to translated strings #207 |
| 114 |
* Update plugin updater to 1.6.18 |
| 115 |
* Honor the filter `pll_flag` when performing the flag validation when creating a new language |
| 116 |
* Modify the title and the label for the language switcher menu items #307 |
| 117 |
* Add support for international domain names |
| 118 |
* Add a title to the link icon used to add a translation #325 |
| 119 |
* Add a notice when a static front page is not translated in a language |
| 120 |
* Add support for custom term fields in wpml-config.xml |
| 121 |
* Add filter `pll_admin_languages_filter` for the list of items the admin bar language filter |
| 122 |
* Add compatibility with WP Offload Media Lite. Props Daniel Berkman |
| 123 |
* Yoast SEO: Add post type archive url in all languages to the sitemap |
| 124 |
* Fix www. not redirected to not www. for the home page in multiple domains #311 |
| 125 |
* Fix cropped images not being synchronized |
| 126 |
* Fix auto added page to menus when the page is created with the block editor |
| 127 |
* Fix embed of translated static front page #318 |
| 128 |
* Fix a possible infinite redirect if the static front page is not translated |
| 129 |
* Fix incorrect behavior of action 'wpml_register_single_string' when updating the string source |
| 130 |
* Fix fatal error with Jetpack when no languages has been defined yet #330 |
| 131 |
* Fix a conflict with Laravel Valet. Props @chesio. #250 |
| 132 |
* Fix a conflict with Thesis. |
| 133 |
* Fix a conflict with Pods in the block editor. Props Jory Hogeveen. #369 |
| 134 |
* Fix fatal error with Twenty Fourteen introduced in version 2.5.4. #374 |
| 135 |
|
| 136 |
See [changelog.txt](https://plugins.svn.wordpress.org/polylang/trunk/changelog.txt) for older changelog |
| 137 |
|
