Add Polylang support for Customizer

Description

Add Polylang support for Customizer

This plugin adds Polylang support for WordPress Customizer.

Support

We provide direct support via our Frontbee Discord server

Features

• Language switcher in Customizer.
• Localized theme_mods and options for both default and custom made Customizer values.
• Enable/disable forcing “The language is set from content” setting in Language->Settings->URL modifications

Prerequisite

1. Polylang must be installed and activated.
2. Languages must be set in Admin > Languages.
3. If you have a static front page:
   1. Create a front page per each language.
   2. Select the front page in Admin > Settings > Reading per language.

4. Expect customizer to use setting type = theme_mod (default) as in:

   $wp_customize->add_setting( ‘setting_id’, [ ‘type’ => ‘theme_mod’, ] );

   License

   This plugin is licensed under the GPL v2 or later.

This program is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License, version 2, as published by the Free Software Foundation.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along with this program; if not, write to the Free Software Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA

A copy of the license is included in the root of the plugin’s directory. The file is named LICENSE.

Important Notes

Licensing

This plugin is licensed under the GPL v2 or later; however, if you opt to use third-party code that is not compatible with v2, then you may need to switch to using code that is GPL v3 compatible.

Credits

Original solution made by @soderlind is available here. Share some love! This is WordPress plugin version of his solution.

Screenshots

Installation

This plugin can be installed directly into your plugins folder \”as-is\”

or if you go to Admin panel > Plugins > Add new > Upload Plugin and select the archive containing this plugin.

It\’s safe to activate the plugin at this point. Because the plugin just injects some functionality – there will be no plugin menus or settings to play with.This plugin can be installed directly into your plugins folder \”as-is\”
or if you go to Admin panel > Plugins > Add new > Upload Plugin and select the archive containing this plugin.

Reviews

Working with 6.5.5 2024

webig July 14, 2024

This is a lifesaver…I had a problem with the footer translations…only one footer translation for all languages…not even polylang was able to fix it..well partially we fixed that…but only for pages and posts…for an ecom store…product categories and pages like my acc..still one footer translation for all of the languages…this one saved my life..would appreciate an update of the plugin…:)

Doesn’t work

cheazeh February 3, 2023

The language button does appear quite all right on Appearance->Customize. However, whatever language you customize in, the text gets copied to the other language. For example, once you customize in English, and then switch to French and customize, the English text immediately changes to the French and vice versa. Probably doesn’t work with the latest Polylang update.

Offer helpful customization for a multilingual website, but there are some issue

czysta July 11, 2022 1 reply

This plugin provides useful customisation for a multilingual website, but there are some problems and it appears that it has been some time since this plugin had a bug fix update.

Great functionality

KentAjans December 1, 2021

Thanks for the awesome plugin

Exactly what I needed

Bigue Nique July 14, 2021 1 reply

Allowed me to use Polylang to translate customizer strings for a theme (Bosa) that would otherwise not have been usable for this specific multi-language project. Very simple to understand and use. Works flawlessly! Thanks for sharing this plugin!

fantastic plugin

rik1234 June 30, 2021

fantastic plugin, really useful in addition to Polylang. @developer: Please keep developing it!

Contributors & Developers

Changelog

1.0.1

• First release

1.0.2

• Fixed issues with option rewriting and polylang translatable strings.

1.1.2

• Fixed issues with pll_current_language() missing due to Polylang API being not included.

1.1.2

• Added settings page & Enable/disable forcing “The language is set from content” setting in Language->Settings->URL modifications

1.1.2

• Added quick settings link

1.1.2

• Fixed missing includes

1.2.0

• Fixed 404 page & removed prefered language dismissal. Thanks @penhtech

1.3.0

• If Polylang is not active, don’t run the app and throw an error notice

1.3.1

• Changed way Polylang API is called

1.3.2

• fixed API.php location error for multisites.

1.3.3

• Changed how API.php is included.

1.3.4

• Added Polylang PRO dir check

1.3.5

• Added Polylang PRO dir check

1.3.6

• Added Polylang PRO dir check

1.3.7

• Fixed no language selection issue on customizer.

1.3.8

• Fixed no language selection issue on customizer.

1.4.0

• Fixed premature Polylang API initialization error while activating/deactivating Polylang.

1.4.1

• Fixed non existing function (early) call for some 3rd party plugins.

1.4.2

• Added support up to WordPress 5.8

1.4.3

• Workaround for update version mismatch

1.4.5

• Added support URL

1.4.5

• Compatibility test