| 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.2 |
| 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.2 (2020-09-08) = |
| 82 |
|
| 83 |
* Pro: Fix posts sharing the same slug displayed on the same page |
| 84 |
* Fix: Don't use a javascript localized string removed in WP 5.5 #568 |
| 85 |
* Fix fatal error in site health when no language is defined #563 |
| 86 |
* Fix various issues with Yoast SEO 14.x #65, #503, #505 |
| 87 |
* Fix fatal error with MU Domain Mapping when saving domains in Polylang settings #569 |
| 88 |
|
| 89 |
= 2.8.1 (2020-08-25) = |
| 90 |
|
| 91 |
* Pro: Fix fatal error with WP 4.9 |
| 92 |
* Fix pll_the_languages() with 'raw' option returning html flag instead of flag url #558 |
| 93 |
* Fix compatibility with Duplicate Posts not correcly loaded #557 |
| 94 |
* Fix custom flag size in admin bar language switcher #559 |
| 95 |
* Fix tag clouds mixed in the classic editor #561 |
| 96 |
|
| 97 |
= 2.8 (2020-08-17) = |
| 98 |
|
| 99 |
* Pro: Add a language switcher block |
| 100 |
* Pro: Add compatibility with block image edition introduced in WP 5.5 |
| 101 |
* Pro: Fix our private taxonomies being displayed in the ACF field group rules. |
| 102 |
* Pro: Fix incorrect flags loaded from the block editor |
| 103 |
* Pro: Fix SSO causing a wrong redirect when using subdomains (introduced in 2.7.4) |
| 104 |
* Pro: Fix a performance issue on the plugins list |
| 105 |
* Pro: Fix option to automatically duplicate media in all languages when uploading a new file not honored in block image |
| 106 |
* Use composer for autoload and Polylang Pro dependency on Polylang |
| 107 |
* Display a flag for each post in the posts list tables (same for terms). #515 |
| 108 |
* Add test for the homepage translations to Site Health |
| 109 |
* Add debug information to Site Health |
| 110 |
* Add compatibility with the sitemaps introduced in WP 5.5 #451 |
| 111 |
* Always filter WP_Query by the current language |
| 112 |
* Support wildcards in "admin-texts" parent keys in wpml-config.xml |
| 113 |
* Fix sticky posts showed for all languages when the admin language filter is active #469 |
| 114 |
* Fix a performance issue on the pages list |
| 115 |
* Fix dependency to jQuery Migrate removed from WP 5.5 #539 |
| 116 |
* Fix: output secure cookie when using a cache plugin and ssl #542 |
| 117 |
* Fix the possibility to create 2 terms with the same name in the same language, without specifying the second slug. |
| 118 |
* Fix sticky posts appearing 2 times in WP 5.5 |
| 119 |
|
| 120 |
See [changelog.txt](https://plugins.svn.wordpress.org/polylang/trunk/changelog.txt) for older changelog |
| 121 |
|
