Skip to content

knitkode/customize-plus

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Customize Plus

Enhance and extend the WordPress Customize in your themes.

Contributors: knitkode, kuus
Tags: wordpress, customizer, options framework, theme
Requires at least: 4.9.4
Tested up to: 4.9.4
Stable tag: 1.1.1
License: GPLv3+
Requires PHP: 5.2.4
Donate link: https://liberapay.com/knitkode/donate

Description

WordPress plugin GitHub release Codacy Badge

Customize Plus brings powerful custom controls fully integrated in the WordPress Customize. The code, the admin UI and the API totally looks like WordPress, as it should be. Customize Plus extends the WordPress API to create all the controls you need leveraging the JavaScript API. All the theme_mods or options managed by Customize Plus controls are automatically validated and sanitized. You do not even need to define the fallback value when retrieving them. End users will also benefit from this plugin, for instance they will be able to separately reset the control values of each control to the initial session or factory value. This and many other features are extended in Customize Plus Premium enriching the Customize experience not only for developers but also for users. Developers will also find useful the plugin Customize Plus Builder to further improve their development experience.

Links

What does this plugin do?

Improve the WordPress Customize experience both for theme developers and their users. Note that themes' end users will not have any benefit without a theme that actively implements Customize Plus.

Who is this Plugin ideal for?

Anyone interested in using the WordPress Customize interface. Especially theme developers who want to build rich Customize experiences for their users.

Can I see a quick demo?

Yes, try out the always up to date official demo theme.

Features

  • State of the art automatic sanitization and validation (both server and frontend side)
  • Controls can be reset individually
  • Automatic default value when retrieving settings via get_theme_mod or get_option
  • Controls are lightweight and responsive
  • Controls are rendered on demand (experimental opt-in)
  • Markdown supported in control's titles and descriptions
  • Optional help text in tooltips (on each input choice for choice based controls)
  • UI seamlessy fits into WordPress
  • Code is clean and extendable via kkcp API
  • Custom controls implemented
    1. text / email / url / tel / password
    2. textarea / wp_editor
    3. number
    4. toggle / switch / checkbox
    5. radio / radio image / buttonset
    6. multicheck / sortable multicheck
    7. slider
    8. color / alpha / palette / transparent
    9. font family / font weight
    10. select / dropdown / multiselect / sortable multiselect
    11. sortable
    12. tags / sortable tags
    13. icons / dashicons
    14. content / markdown / alert
    15. WordPress native controls*
    16. dynamic color (Premium)
    17. dynamic size (Premium)
    18. datepicker (Premium)
    19. knob (Premium)
  • COMING SOON: take a look at the roadmap here

Installation

Installation

Just install this plugin and activate it in the standard way. If you have never done it:

  1. From your WordPress Admin Dashboard go to: Plugins > Add New
  2. Search for "Customize Plus"
  3. Locate the "Customize Plus" plugin by KnitKode and click the Install Now button.
  4. Activate the plugin labeled "Customize Plus".
  5. For detailed setup instructions, vist the official documentation page.

Unzip all files to the /wp-content/plugins/loco-translate directory Log into WordPress admin and activate the ‘Loco Translate’ plugin through the ‘Plugins’ menu Go to Loco Translate > Home in the left-hand menu to start translating

Theme integration

Checkout the documentation here. A tool to facilitate this task is Customize Plus Builder, you can try it here.

Translations

  • English - default
  • Contributions are welcome

Note: This plugin is localized and translation ready. You can help translating this project into different languages here.

Frequently Asked Questions

Where can I find complete documentation?

Documentation can be found at knitkode.com/docs/customize-plus

How do I get help?

Help is provided via the plugin support forum only. Please visit the support page to see other options.

Can I see a quick demo?

Yes, try out the always up to date official demo theme.

Changelog

1.1.1: 24/02/2017

  • Bugfixing
  • Moved control templates to JavaScript control's classes
  • Control's classes use now a React ready methods naming and lifecycle style
  • Support warnings in $validity notifications

1.0.21: 22/02/2017

  • Fix 'dancing char' on Base Input Control

1.0.21: 22/02/2017

  • Fix radio image control missing label->input link

1.0.2: 22/02/2017

  • Basic fixes to controls behaviour

1.0.0: 21/02/2017

  • First official plugin release

0.0.9: December 2017

  • First plugin release

Upgrade Notice

1.0.0

Just released into the wild

Credits

Unless otherwise specified, all the plugin files are licensed under GNU General Public License version 3, see file license.txt. The exceptions to this license are as follows*:

*All plugins included in Customize Plus adopt a GPL-compatible license as required by the WordPress.org plugins guidelines