| 1 |
=== Polylang === |
| 2 |
Contributors: Chouby, manooweb, raaaahman, marianne38, sebastienserre |
| 3 |
Donate link: https://polylang.pro |
| 4 |
Tags: multilingual, bilingual, translate, translation, language, multilanguage, international, localization |
| 5 |
Requires at least: 4.9 |
| 6 |
Tested up to: 5.5 |
| 7 |
Requires PHP: 5.6 |
| 8 |
Stable tag: 2.8.1 |
| 9 |
License: GPLv3 or later |
| 10 |
License URI: https://www.gnu.org/licenses/gpl-3.0.html |
| 11 |
|
| 12 |
Making WordPress multilingual |
| 13 |
|
| 14 |
== Description == |
| 15 |
|
| 16 |
= Features = |
| 17 |
|
| 18 |
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. |
| 19 |
|
| 20 |
* You can use as many languages as you want. RTL language scripts are supported. WordPress languages packs are automatically downloaded and updated. |
| 21 |
* You can translate posts, pages, media, categories, post tags, menus, widgets... |
| 22 |
* Custom post types, custom taxonomies, sticky posts and post formats, RSS feeds and all default WordPress widgets are supported. |
| 23 |
* 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 |
| 24 |
* Categories, post tags as well as some other metas are automatically copied when adding a new post or page translation |
| 25 |
* A customizable language switcher is provided as a widget or in the nav menu |
| 26 |
|
| 27 |
> The author does not provide support on the wordpress.org forum. Support and extra features are available to [Polylang Pro](https://polylang.pro) users. |
| 28 |
|
| 29 |
If you wish to migrate from WPML, you can use the plugin [WPML to Polylang](https://wordpress.org/plugins/wpml-to-polylang/) |
| 30 |
|
| 31 |
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). |
| 32 |
|
| 33 |
= Credits = |
| 34 |
|
| 35 |
Thanks a lot to all translators who [help translating Polylang](https://translate.wordpress.org/projects/wp-plugins/polylang). |
| 36 |
Thanks a lot to [Alex Lopez](http://www.alexlopez.rocks/) for the design of the logo. |
| 37 |
Most of the flags included with Polylang are coming from [famfamfam](http://famfamfam.com/) and are public domain. |
| 38 |
Wherever third party code has been used, credit has been given in the code’s comments. |
| 39 |
|
| 40 |
= Do you like Polylang? = |
| 41 |
|
| 42 |
Don't hesitate to [give your feedback](http://wordpress.org/support/view/plugin-reviews/polylang#postform). |
| 43 |
|
| 44 |
== Installation == |
| 45 |
|
| 46 |
1. Make sure you are using WordPress 4.9 or later and that your server is running PHP 5.6 or later (same requirement as WordPress itself) |
| 47 |
1. If you tried other multilingual plugins, deactivate them before activating Polylang, otherwise, you may get unexpected results! |
| 48 |
1. Install and activate the plugin as usual from the 'Plugins' menu in WordPress. |
| 49 |
1. Go to the languages settings page and create the languages you need |
| 50 |
1. Add the 'language switcher' widget to let your visitors switch the language. |
| 51 |
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. |
| 52 |
|
| 53 |
== Frequently Asked Questions == |
| 54 |
|
| 55 |
= Where to find help ? = |
| 56 |
|
| 57 |
* First time users should read [Polylang - Getting started](https://polylang.pro/doc-category/getting-started/), which explains the basics with a lot of screenshots. |
| 58 |
* 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/). |
| 59 |
* Search the [community support forum](https://wordpress.org/search/). You will probably find your answer here. |
| 60 |
* Read the sticky posts in the [community support forum](http://wordpress.org/support/plugin/polylang). |
| 61 |
* If you still have a problem, open a new thread in the [community support forum](http://wordpress.org/support/plugin/polylang). |
| 62 |
* [Polylang Pro](https://polylang.pro) users have access to our helpdesk. |
| 63 |
|
| 64 |
= Is Polylang compatible with WooCommerce? = |
| 65 |
|
| 66 |
* You need a separate addon to make Polylang and WooCommerce work together. [A Premium addon](https://polylang.pro/downloads/polylang-for-woocommerce/) is available. |
| 67 |
|
| 68 |
= Do you need translation services? = |
| 69 |
|
| 70 |
* If you want to use professional or automatic translation services, install and activate the [Lingotek Translation](https://wordpress.org/plugins/lingotek-translation/) plugin. |
| 71 |
|
| 72 |
== Screenshots == |
| 73 |
|
| 74 |
1. The Polylang languages admin panel |
| 75 |
2. The Strings translations admin panel |
| 76 |
3. Multilingual media library |
| 77 |
4. The Edit Post screen with the Languages metabox |
| 78 |
|
| 79 |
== Changelog == |
| 80 |
|
| 81 |
= 2.8.1 (2020-08-25) = |
| 82 |
|
| 83 |
* Pro: Fix fatal error with WP 4.9 |
| 84 |
* Fix pll_the_languages() with 'raw' option returning html flag instead of flag url #558 |
| 85 |
* Fix compatibility with Duplicate Posts not correcly loaded #557 |
| 86 |
* Fix custom flag size in admin bar language switcher #559 |
| 87 |
* Fix tag clouds mixed in the classic editor #561 |
| 88 |
|
| 89 |
= 2.8 (2020-08-17) = |
| 90 |
|
| 91 |
* Pro: Add a language switcher block |
| 92 |
* Pro: Add compatibility with block image edition introduced in WP 5.5 |
| 93 |
* Pro: Fix our private taxonomies being displayed in the ACF field group rules. |
| 94 |
* Pro: Fix incorrect flags loaded from the block editor |
| 95 |
* Pro: Fix SSO causing a wrong redirect when using subdomains (introduced in 2.7.4) |
| 96 |
* Pro: Fix a performance issue on the plugins list |
| 97 |
* Pro: Fix option to automatically duplicate media in all languages when uploading a new file not honored in block image |
| 98 |
* Use composer for autoload and Polylang Pro dependency on Polylang |
| 99 |
* Display a flag for each post in the posts list tables (same for terms). #515 |
| 100 |
* Add test for the homepage translations to Site Health |
| 101 |
* Add debug information to Site Health |
| 102 |
* Add compatibility with the sitemaps introduced in WP 5.5 #451 |
| 103 |
* Always filter WP_Query by the current language |
| 104 |
* Support wildcards in "admin-texts" parent keys in wpml-config.xml |
| 105 |
* Fix sticky posts showed for all languages when the admin language filter is active #469 |
| 106 |
* Fix a performance issue on the pages list |
| 107 |
* Fix dependency to jQuery Migrate removed from WP 5.5 #539 |
| 108 |
* Fix: output secure cookie when using a cache plugin and ssl #542 |
| 109 |
* Fix the possibility to create 2 terms with the same name in the same language, without specifying the second slug. |
| 110 |
* Fix sticky posts appearing 2 times in WP 5.5 |
| 111 |
|
| 112 |
= 2.7.4 (2020-06-29) = |
| 113 |
|
| 114 |
* Pro: Allow using our /untranslated-posts REST endpoint for non-public post types |
| 115 |
* Pro: Fix broken display in the block editor sidebar when a language has no flag |
| 116 |
* Pro: Fix SSO breaking the preview on secondary domains |
| 117 |
* Pro: Fix ACF translation option not working for term custom fields |
| 118 |
* Pro: Fix a styling issue in the fields group list table in ACF 5.9 |
| 119 |
* Add Spanish from Puerto Rico to the predefined list of languages |
| 120 |
|
| 121 |
= 2.7.3 (2020-05-26) = |
| 122 |
|
| 123 |
* Security: Slash metas |
| 124 |
* Pro: Fix categories not savedafter the language has been switched in the block editor |
| 125 |
* Pro: Fix ACF fields stored as integers instead of strings |
| 126 |
* Pro: Fix ACF untranslated posts or terms being copied when creating a new translation |
| 127 |
* Pro: Fix PHP notice with ACF when a repeater or group is included in a flexible content |
| 128 |
* Pro: Fix "DevTools failed to load SourceMap" warning in browser console |
| 129 |
* Update plugin updater to 1.7.1 |
| 130 |
* Honor the filter "pll_the_language_link" when the language switcher displays a dropdown #506 |
| 131 |
* Fix "Something went wrong" message when quick editing untranslated post types #508 |
| 132 |
* Fix wpseo_opengraph deprecated warning #509 |
| 133 |
|
| 134 |
= 2.7.2 (2020-04-27) = |
| 135 |
|
| 136 |
* Pro: Re-allow to modify the capability for strings translations |
| 137 |
* Pro: Fix redirect for posts having the same slug as a media |
| 138 |
* Pro: Fix PHP notice with ACF flexible content |
| 139 |
* Pro: Fix a fatal error with InfiniteWP |
| 140 |
* Update plugin updater to 1.7 |
| 141 |
* Fix font in setup wizard |
| 142 |
|
| 143 |
= 2.7.1 (2020-04-09) = |
| 144 |
|
| 145 |
* Pro: Fix untranslated post types filtered by the parameter in the REST API #493 |
| 146 |
* Fix fatal error when the function idn_to_ascii is not available |
| 147 |
* Fix PHP warning warning when a 3rd party plugin declares options not stored in DB in wpml-config.xml #492 |
| 148 |
* Fix fatal error when a 3rd party plugin declares options stored as objects in wpml-config.xml #494 |
| 149 |
|
| 150 |
= 2.7 (2020-04-06) = |
| 151 |
|
| 152 |
* Minimum WordPress version is now 4.9 |
| 153 |
* Pro: Strings translations can now be exported and imported (in PO format) |
| 154 |
* Pro: Allow to decide individually which ACF fields to copy or synchronize |
| 155 |
* Pro: Add action pll_inactive_language_requested |
| 156 |
* Pro; Fix fatal error in The Events Calendar compatibility when no language is defined yet |
| 157 |
* Pro: Fix bulk translate when a post has no language |
| 158 |
* Pro: Fix reusable block saved without language |
| 159 |
* Pro: Fix post requested by slug not filtered in REST API, when the slug is shared |
| 160 |
* Add a setup wizard |
| 161 |
* Add Swahili, Upper Sorbian, Sindhi and Spanish from Uruguay to the list of predefined languages |
| 162 |
* Add flags in the predefined list of languages |
| 163 |
* Allow to hide the metaboxes from the screen options |
| 164 |
* The deletion of the plugin's data at uninstall is now controlled by a PHP constant instead of an option #456 |
| 165 |
* Add parent in ajax response when selecting a term in autocomplete field #328 |
| 166 |
* Add Vary: Accept-Language http header in home page redirect. Props @chesio #452 |
| 167 |
* Improve performance to register/unregister WPML strings |
| 168 |
* Add support for the action wpml_switch_language |
| 169 |
* Add post_status to the list of accepted args of pll_count_posts() |
| 170 |
* Apply the filter pll_preferred_language in wp-login.php |
| 171 |
* Use filtered wrappers to create meta when creating media translations #231 |
| 172 |
* Allow to translate the Twenty Seventeen header video Youtube url #460 |
| 173 |
* Notices are now dismissed per site instead of per user #478 |
| 174 |
* Fix terms not visible in the quick edit when only one language is defined and teh admin language filter is active |
| 175 |
* Fix post state not displayed for translations of the privacy policy page #395 |
| 176 |
* Fix wildcards not correctly interpreted in wpml-config.xml |
| 177 |
* Fix product categories with special characters duplicated when importing WooCommerce products #474 |
| 178 |
|
| 179 |
See [changelog.txt](https://plugins.svn.wordpress.org/polylang/trunk/changelog.txt) for older changelog |
| 180 |
|
