| 1 |
=== Polylang === |
| 2 |
Contributors: Chouby |
| 3 |
Donate link: https://polylang.pro |
| 4 |
Tags: multilingual, bilingual, translate, translation, language, multilanguage, international, localization |
| 5 |
Requires at least: 4.4 |
| 6 |
Tested up to: 4.9 |
| 7 |
Stable tag: 2.3.6 |
| 8 |
License: GPLv2 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.4 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.3.6 (2018-05-17) = |
| 80 |
|
| 81 |
* Pro: Fix post type archive slug not translated in ACF page link fields |
| 82 |
* WP 4.9.6: Translate the privacy policy page |
| 83 |
* WP 4.9.6: Add the translated user descriptions to exported personal data |
| 84 |
* Update Plugin updater to version 1.6.16 |
| 85 |
* Fix conflict with the plugin View Admin As. Props Jory Hogeveen. #253 |
| 86 |
|
| 87 |
= 2.3.5 (2018-05-08) = |
| 88 |
|
| 89 |
* Pro: Fix translated CPT slugs when one CPT name is a substring of another one. Props Steve Reimer. |
| 90 |
* Pro: Fix canonical redirection for post types archives when the CPT slug is translated |
| 91 |
* Pro: Fix ACF private key uselessly synchronized when the public custom field is not synchronized |
| 92 |
* Add filter 'pll_filter_query_excluded_query_vars' |
| 93 |
* Redirect www. to non www. when using multiple domains |
| 94 |
* Fix Yoast SEO category sitemap not filtered by language when using multiple domains |
| 95 |
* Fix PLL_COOKIE === false not honored when using a cache plugin. #248 |
| 96 |
* Fix empty predefined languages list |
| 97 |
|
| 98 |
= 2.3.4 (2018-03-27) = |
| 99 |
|
| 100 |
* Pro: Fix conflict with Pods related to translated slugs for custom post types |
| 101 |
* Add Friulian to the predefined languages list |
| 102 |
* Fix conflict (javascript error) with Gütenberg #225 |
| 103 |
* Fix conflict on ajax requests introduced by WooCoommerce 3.3.4 |
| 104 |
* Fix queries by 'category_name' not auto translated #238 |
| 105 |
|
| 106 |
= 2.3.3 (2018-03-15) = |
| 107 |
|
| 108 |
* Pro: Fix tax query using a term sharing slugs (fix a conflict with Fusion Builder) |
| 109 |
* Restore Polylang (free) on REST requests, while disabling the language filter as in v2.3 |
| 110 |
* Rework auto translated query with taxonomy in different language #223 |
| 111 |
* Synchronize Yoast SEO primary category (needs Yoast SEO 7.0+) |
| 112 |
* Fix PHP warning introduced by Yoast SEO 7.0 #229 |
| 113 |
* Fix tax query when using the relation 'OR' |
| 114 |
* Fix a conflict with the combination of Barrel + WP Bakery Page Builder |
| 115 |
* Fix broken redirect with MU domain mapping #226 |
| 116 |
* Fix site title not translated in password change email |
| 117 |
|
| 118 |
= 2.3.2 (2018-03-05) = |
| 119 |
|
| 120 |
* Pro: Fix REST requests not filtered by the requested language (introduced in 2.3). |
| 121 |
* Pro: Fix error 404 on single posts if posts are untranslatable |
| 122 |
* Deactivate Polylang (free) on REST requests by default. |
| 123 |
* Fix translated terms unassigned from posts when deleting a term |
| 124 |
* Fix auto translated query with taxonomy in different language returning empty results since WP 4.9 #223 |
| 125 |
* Fix conflict with a homepage option of the theme Extra |
| 126 |
* Fix warning when filtering get_pages() |
| 127 |
|
| 128 |
= 2.3.1 (2018-02-15) = |
| 129 |
|
| 130 |
* Pro: Fix GET REST request with slug parameter deleting the post slug |
| 131 |
* Fix http request with a custom query var being redirected to the home page #216 |
| 132 |
|
| 133 |
= 2.3 (2018-01-30) = |
| 134 |
|
| 135 |
* Pro: Duplicating a post now duplicates untranslated terms and the featured image (if media are translatable) |
| 136 |
* Pro: Add filter 'pll_sync_post_fields' |
| 137 |
* Pro: Translate ACF Pro clone fields when creating a new field group translation |
| 138 |
* Pro: Allow to share slugs when creating a post or term with the REST API |
| 139 |
* Pro: Load asynchronously the script added on front for multiple domains and subdomains |
| 140 |
* Pro: Fix 'lang' parameter not interpreted when the query includes 'name' |
| 141 |
* Refactor the synchronization of metas for better synchronization and performance improvement |
| 142 |
* Refactor the synchronization of taxonomy terms for performance improvement |
| 143 |
* Refactor language and translations saving for performance improvement |
| 144 |
* Refactor the synchronization of sticky posts |
| 145 |
* Remove all languages files. All translations are now maintained on https://translate.wordpress.org/projects/wp-plugins/polylang #199 |
| 146 |
* Refactor the list of languages to merge predefined languages, Facebook locales and fixes for W3C locales |
| 147 |
* Automatically deactivate Polylang when activating Polylang Pro |
| 148 |
* Disable programmatically translated post types and taxonomies in settings. Props Ulrich Pogson. #180 |
| 149 |
* Set the cookie language in Javascript when a cache plugin is active |
| 150 |
* Automatically remove the home page from cache when requesting the detection of the browser preferred language |
| 151 |
* Use relative urls for the admin language filter in admin bar. #209 |
| 152 |
* Disable auto translation of WP_Term_Query if it has a 'lang' parameter |
| 153 |
* Don't filter REST requests by default. #211 |
| 154 |
* Fix Yoast SEO statistics in dashboard showing only the default language. #211 |
| 155 |
* Fix WP Rocket clearing the cache of the wrong adjacent post |
| 156 |
* Fix random header image |
| 157 |
* Fix home page not correctly loaded when adding a query var |
| 158 |
* Fix: Impossible to change the language code when the language code is also a WordPress locale. |
| 159 |
|
| 160 |
See [changelog.txt](https://plugins.svn.wordpress.org/polylang/trunk/changelog.txt) for older changelog |
| 161 |
|
