| 1 |
=== Polylang === |
| 2 |
Contributors: Chouby, manooweb, raaaahman, marianne38, sebastienserre, greglone, hugod |
| 3 |
Donate link: https://polylang.pro |
| 4 |
Tags: multilingual, translate, translation, language, localization |
| 5 |
Requires at least: 6.8 |
| 6 |
Tested up to: 7.1 |
| 7 |
Requires PHP: 7.4 |
| 8 |
Stable tag: 3.8.9 |
| 9 |
License: GPLv3 or later |
| 10 |
License URI: https://www.gnu.org/licenses/gpl-3.0.html |
| 11 |
|
| 12 |
Go multilingual in a simple and efficient way. Keep writing posts and taxonomy terms as usual while defining their languages all at once. |
| 13 |
|
| 14 |
== Description == |
| 15 |
|
| 16 |
With Polylang fully integrated to WordPress and using only its built-in core features (taxonomies), keep steady performances on your site and create a multilingual site featuring from just one extra language to 10 or more depending on your needs. There is no limit in the number of languages added and WordPress’ language packs are automatically downloaded when ready. |
| 17 |
|
| 18 |
= Features = |
| 19 |
|
| 20 |
Depending on the type of site you have built or are planning to build, a combination of plugins from the list below might be of interest. |
| 21 |
All plugins include a wizard allowing to setup them in just a few clicks. |
| 22 |
|
| 23 |
### Polylang |
| 24 |
|
| 25 |
Polylang and [Polylang Pro](https://polylang.pro) share the same core providing features such as: |
| 26 |
|
| 27 |
* Translating posts, pages, media, categories, post tags, custom post types and taxonomies, RSS feeds; RTL scripts are supported. |
| 28 |
* The language is either set by the language code in URL, or you can use a different sub-domain or domain per language. |
| 29 |
* Automatic copy of categories, post tags and other metas when creating a new post or page translation. |
| 30 |
* Translating classic menus and classic widgets. Also accessible with [Site Editor Classic Features](https://wordpress.org/plugins/fse-classic/) in block themes. |
| 31 |
* Customizable language switchers available as blocks, classic widget or classic navigation menu item. |
| 32 |
* Compatibility with Yoast SEO. |
| 33 |
|
| 34 |
### Polylang Pro |
| 35 |
|
| 36 |
Helps optimizing the time spent translating your site with some very useful extra features such as: |
| 37 |
|
| 38 |
* Better integration in the new Block Editor. |
| 39 |
* Language options available in the widget block editor. |
| 40 |
* Template parts translatable in the site editor (FSE). |
| 41 |
* Duplicate and/or synchronize content across post translations. |
| 42 |
* Improved compatibility with other plugins such as [ACF Pro](https://polylang.pro/doc/working-with-acf-pro/). |
| 43 |
* Share the same URL slug for posts or terms across languages. |
| 44 |
* [Translate URL slugs](https://polylang.pro/doc/translating-urls-slugs/) for categories, author bases, custom post types and more... |
| 45 |
* Machine translation with DeepL. |
| 46 |
* Export and import of content in XLIFF format for outsourced professional translation. |
| 47 |
* **Access to a Premium Support for personalized assistance.** |
| 48 |
|
| 49 |
### Polylang for WooCommerce |
| 50 |
|
| 51 |
[Add-on](https://polylang.pro/downloads/polylang-for-woocommerce/) for the compatibility with WooCommerce which provides features such as: |
| 52 |
|
| 53 |
* Translating WooCommerce pages (shop, check-out, cart, my account), product categories and global attribute terms directly in the WooCommerce interface. |
| 54 |
* Translating WooCommerce e-mails and sending them to customers in their language. |
| 55 |
* Products metadata synchronization. |
| 56 |
* Compatibility with the native WooCommerce CSV import & export tool. |
| 57 |
* Compatibility with popular plugins such as WooCommerce Subscriptions, Product Bundles, WooCommerce Bookings, Shipment Tracking and more. |
| 58 |
* Ability to use the WooCommerce REST API (available with Polylang Pro). |
| 59 |
* **Access to a Premium Support for personalized assistance.** |
| 60 |
|
| 61 |
= Switching from WPML? = |
| 62 |
|
| 63 |
* [WPML to Polylang](https://wordpress.org/plugins/wpml-to-polylang/) allows migrating from WPML to Polylang in a few clicks. |
| 64 |
|
| 65 |
= Credits = |
| 66 |
|
| 67 |
Thanks a lot to all translators who [help translating Polylang](https://translate.wordpress.org/projects/wp-plugins/polylang). |
| 68 |
Thanks a lot to [Alex Lopez](http://www.alexlopez.rocks/) for the design of the logo. |
| 69 |
Most of the flags included with Polylang are coming from [famfamfam](http://famfamfam.com/) and are public domain. |
| 70 |
Wherever third party code has been used, credit has been given in the code’s comments. |
| 71 |
|
| 72 |
== Installation == |
| 73 |
|
| 74 |
1. Make sure you are using WordPress 6.8 or later and that your server is running PHP 7.4 or later (same requirement as WordPress itself). |
| 75 |
1. If you tried other multilingual plugins, deactivate them before activating Polylang, otherwise, you may get unexpected results! |
| 76 |
1. Install and activate the plugin as usual from the 'Plugins' menu in WordPress. |
| 77 |
1. The [setup wizard](https://polylang.pro/documentation/support/getting-started/setup-wizard/) is automatically launched to help you get started more easily with Polylang by configuring the main features. |
| 78 |
|
| 79 |
== Frequently Asked Questions == |
| 80 |
|
| 81 |
= Where to find help ? = |
| 82 |
|
| 83 |
* First time users should read [Polylang - Getting started](https://polylang.pro/documentation/support/getting-started/), which explains the basics and includes a lot of screenshots. |
| 84 |
* Read the [documentation](https://polylang.pro/documentation/support/). It includes a [FAQ](https://polylang.pro/documentation/support/faq/) and the [documentation for developers](https://polylang.pro/documentation/support/developers/). |
| 85 |
* Search the [community support forum](https://wordpress.org/search/). You will probably find your answers here. |
| 86 |
* Read the sticky posts in the [community support forum](http://wordpress.org/support/plugin/polylang). |
| 87 |
* If you still have a problem, open a new thread in the [community support forum](http://wordpress.org/support/plugin/polylang). |
| 88 |
* [Polylang Pro and Polylang for WooCommerce](https://polylang.pro) users have access to our premium support through helpdesk. |
| 89 |
|
| 90 |
= Is Polylang compatible with WooCommerce? = |
| 91 |
|
| 92 |
* You need [Polylang for WooCommerce](https://polylang.pro/pricing/polylang-for-woocommerce/), premium addon described above, which will make both plugins work together. |
| 93 |
|
| 94 |
= Where do I report security bugs found in this plugin? = |
| 95 |
|
| 96 |
* Please report security bugs found in the source code of the Polylang plugin through the [Patchstack Vulnerability Disclosure Program](https://patchstack.com/database/vdp/d83984d2-d748-43e3-88e2-6dd3bd2c881d). The Patchstack team will assist you with verification, CVE assignment, and notify the developers of this plugin. |
| 97 |
|
| 98 |
== Screenshots == |
| 99 |
|
| 100 |
1. The Polylang languages admin panel |
| 101 |
2. The Strings translations admin panel |
| 102 |
3. Multilingual media library |
| 103 |
4. The Edit Post screen with the Languages metabox |
| 104 |
|
| 105 |
== Changelog == |
| 106 |
|
| 107 |
= 3.9 = |
| 108 |
|
| 109 |
* Require WP 6.8 as minimum version |
| 110 |
* Pro: Allow to manage all Business Pack plugins with a single field for the license key |
| 111 |
* Pro: Allow to manage fallbacks and active languages with the REST API #2947 |
| 112 |
* Pro: Allow to manage locale fallbacks and active status of languages with WP CLI #3007 |
| 113 |
* Pro: Display DeepL billed characters after machine translation #3041 |
| 114 |
* Pro: Fix inconsistency in translation setting displayed when an ACF field was created before the activation of Polylang Pro #2968 |
| 115 |
* Pro: Fix bulk copy separating synchronized posts #2949 |
| 116 |
* Pro: Fix synchronized posts deleted when using "Rewrite & Republish" in Yoast Duplicate Post. Props @krokodok #1536 |
| 117 |
* Add a dropdown language switcher with optional flags, available as a classic widget or block |
| 118 |
* Allow to customize the shape and size of the flags in all language switchers |
| 119 |
* Replace PNG 16x11 images by SVG 18x12 images for default flags #1864 |
| 120 |
* Change the code of some flags to use iso 3166 for countries or regions, iso 639 for languages #1865 |
| 121 |
* Remove the filter `pll_flag_title`, inoperative since v3.0 #1828 |
| 122 |
* Harmonize flags across the administration area and improve their accessibility #1857 #2992 |
| 123 |
* Translate taxonomy filter in post list table when switching the language filter #1891 |
| 124 |
* Allow to filter untranslated posts in the posts list table #1892 |
| 125 |
* Add views for languages in the posts list table #1899 |
| 126 |
* Fix the synchronization of meta values when updating a meta with multiple values #1826 |
| 127 |
|
| 128 |
= 3.8.9 (2026-09-08) = |
| 129 |
|
| 130 |
* Fix wrong redirect on home when the URL includes a query var #1998 |
| 131 |
|
| 132 |
= 3.8.8 (2026-09-07) = |
| 133 |
|
| 134 |
* Security: Fix exposure of some draft posts metadata to non-authorized users. Reported by Patchstack. |
| 135 |
* Pro: Allow plugins requiring Polylang to be installed when Polylang Pro is active #3051 #3116 |
| 136 |
* Pro: Fix warning `WP_Post conversion to int` with WooCommerce #3101 |
| 137 |
* Pro: Fix creation of translation in block editor for WP < 6.7 #3105 |
| 138 |
* Fix duplicated posts page #1992 |
| 139 |
|
| 140 |
= 3.8.7 (2026-08-17) = |
| 141 |
|
| 142 |
* Pro: Add the translation of new blocks introduced by WP 7.1 #3048 |
| 143 |
* Fix quick edit parent page dropdown for hierarchical custom post types #1947 |
| 144 |
* Fix wp-editor script enqueued together with the new widgets editor #1968 |
| 145 |
|
| 146 |
= 3.8.6 (2026-07-20) = |
| 147 |
|
| 148 |
* Pro: Security: Ensure the user has the required capability for ACF fields when switching language in the editor #3029 |
| 149 |
* Security: Fix exposure of some private posts metadata to non-authorized users. Reported by Patchstack. |
| 150 |
* Security: Fix server side default language encoding for the block editor |
| 151 |
* Fix 404 for post type or taxonomy sitemap when its name ends with a language code #1909 |
| 152 |
|
| 153 |
= 3.8.5 (2026-06-16) = |
| 154 |
|
| 155 |
* Pro: Fix language switcher block error in Widget screen #1905 |
| 156 |
* Pro: Fix "edit" button wrongly disabled in the languages sidebar in the block editor #3011 |
| 157 |
* Fix edited images files deleted when deleting the first media translation #1887 |
| 158 |
* Fix error in AJAX context when the parameter `lang` is passed a locale instead of a language code #1896 |
| 159 |
|
| 160 |
= 3.8.4 (2026-05-18) = |
| 161 |
|
| 162 |
* Security: Fix an XSS in the multilingual biography |
| 163 |
* Pro: Fix draft post translations not shown in the languages sidebar in the block editor #3006 |
| 164 |
* Pro: Fix compatibility with libxml 2.15.1 #2920 |
| 165 |
* Pro: Fix Allowed memory size exhausted with Divi 5 #3008 |
| 166 |
* Improve accessibility of the multilingual biography on user profile page #1869 |
| 167 |
* Prevent using unsupported block fields in wpml-config.xml #1868 |
| 168 |
|
| 169 |
= 3.8.3 (2026-04-27) = |
| 170 |
|
| 171 |
* Pro: Improve performance of the languages sidebar in the block editor #2989 |
| 172 |
* Pro: Fix impossibility to add more than one translation at once from the block editor sidebar #2985 |
| 173 |
* Pro: Fix HTML entities displayed in translation inputs in the block editor sidebar #2984 |
| 174 |
* Pro: Fix error when editing a pattern from the post editor #2990 |
| 175 |
* Pro: Fix sync icon incorrectly shown as active on new posts #2995 |
| 176 |
* Pro: Fix `pll_sync_post` REST API field returning an empty array instead of an empty object #2995 |
| 177 |
* Pro: Fix ACF fields in a repeater nested in a flexible content overwritten with wrong values #2975 |
| 178 |
* Fix language switcher block error in Widget screen #1856 |
| 179 |
* Fix PHP warning in site health #1862 |
| 180 |
* Fix wrong cookie sent in some cases #1863 |
| 181 |
* Fix error with WordPress Importer when the imported file has synchronized posts #1853 |
| 182 |
|
| 183 |
= 3.8.2 (2026-04-07) = |
| 184 |
|
| 185 |
* Pro: Fix refresh issues in block editor languages panel #2965 |
| 186 |
* Pro: Fix error when unlinking 2 translations in block editor #2970 |
| 187 |
* Pro: Fix fatal error when a repeater is previously created in ACF Pro but ACF is active #2972 |
| 188 |
* Fix settings redirect in Playground #1840 |
| 189 |
* Fix possible fatal error when the default language has been corrupted in DB #1843 |
| 190 |
|
| 191 |
= 3.8.1 (2026-03-19) = |
| 192 |
|
| 193 |
* Fix fatal error when the cache is suspended #1837 #1839 |
| 194 |
|
| 195 |
= 3.8 (2026-03-17) = |
| 196 |
|
| 197 |
* Requires PHP 7.4 and WP 6.5 as minimum version |
| 198 |
* Pro: Use autonomous updater #2475 |
| 199 |
* Pro: Add capabilities allowing to control permissions per language |
| 200 |
* Pro: Add capabilities to control access to languages and strings translations |
| 201 |
* Pro: Allow to manage languages and settings with WP CLI #2653 |
| 202 |
* Pro: Add smart duplication in site editor #2559 |
| 203 |
* Pro: Add support for DeepL glossaries #2687 |
| 204 |
* Pro: Add locale fallback support to machine translation #2685 |
| 205 |
* Pro: Add Support encoding for block attributes in wpml-config.xml #1683, #2660 |
| 206 |
* Pro: Improve extensibility of the block editor languages panel #2553 |
| 207 |
* Pro: Add support for new blocks introduced in WP 7.0 #2933 #2941 |
| 208 |
* Pro: Hide language selector on inner blocks in Widget Block Editor #2900 |
| 209 |
* Pro: Fix page template not copied when creating a new page translation in the block editor #2581 |
| 210 |
* Pro: Fix SVG icons lost when using machine translation |
| 211 |
* Pro: Fix a performance issue with the translation of ACF labels #2670 |
| 212 |
* Pro: Fix product status wrongly modified when updating a product with the REST API #2540 |
| 213 |
* Pro: Fix inactive languages not displayed when they should in REST API #2791 |
| 214 |
* Pro: Fix translation of ACF repeaters with pagination #2674 |
| 215 |
* Pro: Fix ACF's layout fields instructions #2889 |
| 216 |
* Pro: Fix ACF's taxonomy fields not synchronized #2948 |
| 217 |
* Pro: Fix event dates of The Events Calendar not duplicated #2894 |
| 218 |
* Add language switcher block and navigation language switcher block #1811 |
| 219 |
* Add support for multiple encodings in wpml-config.xml #1679, #2655 |
| 220 |
* Enforce transients in DB and in object cache are synchronized #1653, #2598 |
| 221 |
* Enforce passing all translations when saving the translations of a post or term #1690 |
| 222 |
* Hide the admin language filter when editing posts #1698 |
| 223 |
* Improve performance by preventing DB queries to fetch the language terms #1650 |
| 224 |
* Fix edge cases where the translation group could be corrupted #1690 |
| 225 |
* Fix a fatal error on multisite when saving a post after having switched to a site without Polylang #1700 |
| 226 |
* Fix a fatal error when translating a custom table #1730 |
| 227 |
* Fix warning when requesting a non-existing language #1665 |
| 228 |
* Fix strings translations import with WP Importer #1637 |
| 229 |
* Fix edge cases leading to wrong languages order #1777 |
| 230 |
* Fix a fatal error with the plugin Groups #1834 |
| 231 |
|
| 232 |
See [changelog.txt](https://plugins.svn.wordpress.org/polylang/trunk/changelog.txt) for older changelog |
| 233 |
|
