| 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.2 |
| 6 |
Tested up to: 6.8 |
| 7 |
Requires PHP: 7.2 |
| 8 |
Stable tag: 3.7.1 |
| 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 switcher available as a classic widget or a 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 switcher available as a block. |
| 40 |
* Language options available in the widget block editor. |
| 41 |
* Template parts translatable in the site editor (FSE). |
| 42 |
* Duplicate and/or synchronize content across post translations. |
| 43 |
* Improved compatibility with other plugins such as [ACF Pro](https://polylang.pro/doc/working-with-acf-pro/). |
| 44 |
* Share the same URL slug for posts or terms across languages. |
| 45 |
* [Translate URL slugs](https://polylang.pro/doc/translating-urls-slugs/) for categories, author bases, custom post types and more... |
| 46 |
* Machine translation with DeepL. |
| 47 |
* Export and import of content in XLIFF format for outsourced professional translation. |
| 48 |
* **Access to a Premium Support for personalized assistance.** |
| 49 |
|
| 50 |
### Polylang for WooCommerce |
| 51 |
|
| 52 |
[Add-on](https://polylang.pro/downloads/polylang-for-woocommerce/) for the compatibility with WooCommerce which provides features such as: |
| 53 |
|
| 54 |
* Translating WooCommerce pages (shop, check-out, cart, my account), product categories and global attribute terms directly in the WooCommerce interface. |
| 55 |
* Translating WooCommerce e-mails and sending them to customers in their language. |
| 56 |
* Products metadata synchronization. |
| 57 |
* Compatibility with the native WooCommerce CSV import & export tool. |
| 58 |
* Compatibility with popular plugins such as WooCommerce Subscriptions, Product Bundles, WooCommerce Bookings, Shipment Tracking and more. |
| 59 |
* Ability to use the WooCommerce REST API (available with Polylang Pro). |
| 60 |
* **Access to a Premium Support for personalized assistance.** |
| 61 |
|
| 62 |
= Our other free plugins = |
| 63 |
|
| 64 |
* [WPML to Polylang](https://wordpress.org/plugins/wpml-to-polylang/) allows migrating from WPML to Polylang. |
| 65 |
* [Site Editor Classic Features](https://wordpress.org/plugins/fse-classic/) allows to use classic widgets (including the Polylang language switcher) and menus in the site editor (FSE). |
| 66 |
|
| 67 |
= Credits = |
| 68 |
|
| 69 |
Thanks a lot to all translators who [help translating Polylang](https://translate.wordpress.org/projects/wp-plugins/polylang). |
| 70 |
Thanks a lot to [Alex Lopez](http://www.alexlopez.rocks/) for the design of the logo. |
| 71 |
Most of the flags included with Polylang are coming from [famfamfam](http://famfamfam.com/) and are public domain. |
| 72 |
Wherever third party code has been used, credit has been given in the code’s comments. |
| 73 |
|
| 74 |
== Installation == |
| 75 |
|
| 76 |
1. Make sure you are using WordPress 6.2 or later and that your server is running PHP 7.2 or later (same requirement as WordPress itself). |
| 77 |
1. If you tried other multilingual plugins, deactivate them before activating Polylang, otherwise, you may get unexpected results! |
| 78 |
1. Install and activate the plugin as usual from the 'Plugins' menu in WordPress. |
| 79 |
1. The [setup wizard](https://polylang.pro/doc/setup-wizard/) is automatically launched to help you get started more easily with Polylang by configuring the main features. |
| 80 |
|
| 81 |
== Frequently Asked Questions == |
| 82 |
|
| 83 |
= Where to find help ? = |
| 84 |
|
| 85 |
* First time users should read [Polylang - Getting started](https://polylang.pro/doc-category/getting-started/), which explains the basics and includes a lot of screenshots. |
| 86 |
* 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/). |
| 87 |
* Search the [community support forum](https://wordpress.org/search/). You will probably find your answers here. |
| 88 |
* Read the sticky posts in the [community support forum](http://wordpress.org/support/plugin/polylang). |
| 89 |
* If you still have a problem, open a new thread in the [community support forum](http://wordpress.org/support/plugin/polylang). |
| 90 |
* [Polylang Pro and Polylang for WooCommerce](https://polylang.pro) users have access to our premium support through helpdesk. |
| 91 |
|
| 92 |
= Is Polylang compatible with WooCommerce? = |
| 93 |
|
| 94 |
* You need [Polylang for WooCommerce](https://polylang.pro/downloads/polylang-for-woocommerce/), premium addon described above, which will make both plugins work together. |
| 95 |
|
| 96 |
== Screenshots == |
| 97 |
|
| 98 |
1. The Polylang languages admin panel |
| 99 |
2. The Strings translations admin panel |
| 100 |
3. Multilingual media library |
| 101 |
4. The Edit Post screen with the Languages metabox |
| 102 |
|
| 103 |
== Changelog == |
| 104 |
|
| 105 |
= 3.7.1 (2025-05-05) = |
| 106 |
|
| 107 |
* Pro: Do not display ACF fileds translations settings when language location is set. |
| 108 |
* Pro: Fix ACF taxonomy field terms not synchronized when "Save Terms" and "load terms" settings are activated. |
| 109 |
* Pro: Fix duplicate options when using numeric keys for ACF choice fields. |
| 110 |
|
| 111 |
= 3.7 (2025-04-22) = |
| 112 |
|
| 113 |
* Requires PHP 7.2 as minimum version |
| 114 |
* Pro: Add DeepL machine translation for strings |
| 115 |
* Pro: Consider Polylang Pro as equivalent to Polylang for plugin dependencies |
| 116 |
* Pro: Add the details block and several labels in other blocks to XLIFF files and machine translation |
| 117 |
* Pro: Allow to translate metas stored as objects |
| 118 |
* Pro: Enhanced multilingual support of archive template hierarchy |
| 119 |
* Pro: Wrap the language switcher block in a nav tag |
| 120 |
* Pro: Support automatic IDs translation in blocks with new filters `pll_sync_block_rules_for_attributes` and `pll_sync_blocks_xpath_rules` |
| 121 |
* Pro: Complete rewrite of ACF integration |
| 122 |
* Pro: Add support for ACF blocks, post types and taxonomies. |
| 123 |
* Pro: Remove the possibility to translate ACF field groups |
| 124 |
* Pro: Add languages in ACF locations |
| 125 |
* Pro: Add translation of ACF labels in the strings translations page |
| 126 |
* Pro: Fix incorrect count of translated strings when importing strings translations |
| 127 |
* Pro: Fix incorrect translation when an XLIFF import updates a term sharing its slug |
| 128 |
* Pro: Fix term hierarchy with machine translation |
| 129 |
* Pro: Fix indented items of a list block not translated with machine translation |
| 130 |
* Pro: Fix navigation block inserted in the wrong language |
| 131 |
* Update plugin updater to 1.9.4 |
| 132 |
* Add translation of widgets custom html in strings translations #1423 |
| 133 |
* Refactor core to manage the plugin options in an object #1451 |
| 134 |
* Refactor core to give access to languages management in all contexts #1503 |
| 135 |
* Remove the language set from the content option for new installs #1517 |
| 136 |
* Allow numbers in language codes #1546 |
| 137 |
* Display empty fields in the translations table for untranslated strings (instead of duplicating the original) #1574 |
| 138 |
* Add REST API endpoints to manage options and languages #1505 #1569 |
| 139 |
* Improve performance by registering the language taxonomy only once #1359 |
| 140 |
* Add new API functions to insert and update posts and terms in a given language #1500 #1520 |
| 141 |
* Add compatibility with jQuery 4 (planned in core for WP 6.8) #1612 |
| 142 |
* Fix translations not loaded when the language is set from the content #1395 |
| 143 |
* Fix possible term duplication #1490 |
| 144 |
* Fix sanitization of translated options that may impact other strings #1571 |
| 145 |
* Fix home link block not translated #1647 |
| 146 |
* Fix a conflict with WooCommerce Price Based on Country #1638 |
| 147 |
|
| 148 |
See [changelog.txt](https://plugins.svn.wordpress.org/polylang/trunk/changelog.txt) for older changelog |
| 149 |
|
