|
| 1 | +  |
| 2 | + |
| 3 | +# Add Polylang support for Customizer [](https://wordpress.org/plugins/add-polylang-support-for-customizer/) |
| 4 | + |
| 5 | +This plugin adds Polylang support for WordPress Customizer. |
| 6 | + |
| 7 | + |
| 8 | +## Features |
| 9 | + |
| 10 | +* Language switcher in Customizer. |
| 11 | +* Localized theme_mods and options for both default and custom made Customizer values. |
| 12 | +* Enable/disable forcing *“The language is set from content”* setting in `Language` > `Settings` > `URL modifications` |
| 13 | + |
| 14 | +## Prerequisite |
| 15 | + |
| 16 | +1. Polylang must be installed and activated. |
| 17 | +2. Languages must be set in **Admin > Languages**. |
| 18 | +3. _If you have a static front page_: |
| 19 | + 1. _Create a front page per each language._ |
| 20 | + 2. _Select the front page in **Admin > Settings > Reading** per language._ |
| 21 | +5. Expect customizer to use setting type = `theme_mod` (default) as in: |
| 22 | + |
| 23 | +`$wp_customize->add_setting( 'setting_id', [ 'type' => 'theme_mod', ] );` |
| 24 | + |
| 25 | +## Installation |
| 26 | + |
| 27 | +This plugin can be installed directly into your plugins folder "as-is"<br/> |
| 28 | +or: |
| 29 | +- go to **Plugins > Add new** and type in Search `Add Polylang support for Customizer` and click **Install** and then **Activate** buttons. |
| 30 | +- if you go to **Admin panel > Plugins > Add new > Upload Plugin** and select the archive containing this plugin. |
| 31 | + |
| 32 | +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. |
| 33 | +License |
| 34 | + |
| 35 | +## License |
| 36 | + |
| 37 | +This plugin is licensed under the GPL v2 or later. |
| 38 | + |
| 39 | +> 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. |
| 40 | +
|
| 41 | +> 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. |
| 42 | +
|
| 43 | +> 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 |
| 44 | +
|
| 45 | +A copy of the license is included in the root of the plugin’s directory. The file is named `LICENSE`. |
| 46 | + |
| 47 | +## Important Notes |
| 48 | + |
| 49 | +### Licensing |
| 50 | + |
| 51 | +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. |
| 52 | + |
| 53 | +For reference, [here's a discussion](http://make.wordpress.org/themes/2013/03/04/licensing-note-apache-and-gpl/) that covers the Apache 2.0 License used by [Bootstrap](http://twitter.github.io/bootstrap/). |
| 54 | + |
| 55 | +# Credits |
| 56 | + |
| 57 | +Original solution made by [@soderlind](https://github.com/soderlind) is available [here](https://github.com/soderlind/customizer-polylang). Share some love! This is WordPress plugin version of his solution. |
0 commit comments