Contributors: davidvongries, aristath, dannycooper, wplemon, igmoweb Tags: customizer, options framework, theme, mods, toolkit, gutenberg Requires at least: 4.9 Tested up to: 5.8 Stable tag: 3.1.9 License: MIT License URI: https://opensource.org/licenses/MIT
The ultimate customizer framework for WordPress theme developers.
Kirki allows theme developers to build themes quicker & more easily.
With over 30 custom controls ranging from simple sliders to complex typography controls with Google-Fonts integration and features like automatic CSS & postMessage
script generation, Kirki makes theme development a breeze.
- Increased Performance
- Simplified API
- Automatic CSS Generation
- Automatic postMessage Generation
- Partial Refresh
- Conditional Logic
- GDPR Compliance
- Improved Page Speed
- & more!
- Background Customizer Control
- Code Customizer Control
- Checkbox Customizer Control
- Color Customizer Control
- Color Palette Customizer Control
- Custom Customizer Control
- Dashicons Customizer Control
- Date Customizer Control
- Dimension Customizer Control
- Dimensions Customizer Control
- Dropdown Pages Customizer Control
- Editor Customizer Control
- Generic Customizer Control
- Image Customizer Control
- Link Customizer Control
- Multiple Checkbox Customizer Control
- Multicolor Customizer Control
- Number Customizer Control
- Radio Customizer Control
- Radio Buttonset Customizer Control
- Radio Image Customizer Control
- Repeater Customizer Control
- Select Customizer Control
- Slider Customizer Control
- Sortable Customizer Control
- Switch Customizer Control
- Text Customizer Control
- Textarea Customizer Control
- Toggle Customizer Control
- Typography Customizer Control
- Upload Customizer Control
Page Builder Framework's customizer settings are a prime example of what can be achieved with Kirki.
Conditional Logic, Partial Refresh, postMessage and a variety of controls - It has all of it.
You can find detailed documentation on how to use Kirki on kirki.org
Kirki PRO is currently in development. You can sign up for the waiting list here to be notified about updates.
Theme developers should be familiar with the Customizer API before starting to build a theme using Kirki. An excellent handbook for the WordPress Customizer can be found on the developer.wordpress.org website.
Simply install as a normal WordPress plugin and activate.
If you want to integrate Kirki in your theme or plugin, please read the instructions on our documentation site.
Bugfixes:
- The CSS output of
control-react-colorful
was empty when the value is a string - On
control-radio
, the control id wasn't outputted causing broken behavior - The sanitize callback of field-dimensions wasn't implemented
- Output on Gutenberg editing screen was affecting the whole page instead of only the editing content
- The margin-top & margin-bottom of
field-typography
wasn't rendered in frontend styles - The
kirki/fonts/standard_fonts
wasn't implemented when it's hooked AFTER adding the fields (in user's usage) - The default browser font-family (from v3) was missing
- The custom font families grouping was missing
- Custom variants set on standard fonts wasn't implemented
Improvement:
- The
control-react-select
choices now accept an array of objects (used by a variant in field-typography)
Refactor:
- Bring back the v3 style/model of font's variant in
field-typography
- Now controls are developed (and available) as composer packages
- Some controls are using React for their JS part
- Much improvement over color control (using
react-colorful
) also includes new features - Improved typography field
- Improved color palette control
- Improved multicolor field
- Improved dimensions field
- Improved select controls (including dropdown pages control)
- Some other improvements
- Bugfixes!
- Use Parcel as the build tool (it's nice!)
- Fixed: Styling issue in Switch control.