=== Kirki Customizer Framework ===
Contributors: themeum
Tags: customizer, options framework, theme, toolkit
Requires at least: 5.3
Tested up to: 6.9
Stable tag: 5.2.3
Requires PHP: 7.4
License: MIT
License URI: https://opensource.org/licenses/MIT

The Ultimate Customizer Framework for WordPress Theme Developers

== Description ==

[Kirki](https://github.com/themeum/kirki) is a Customizer toolkit for WordPress. An open-source initiative by [Themeum](https://github.com/themeum) for WordPress theme developers.

Kirki allows you to build themes faster and more easily. With over 30 custom controls—ranging from simple sliders to advanced typography controls with Google Fonts integration—and features like automatic CSS generation and `postMessage` support, Kirki makes theme development a breeze.


### Features ✅ ###
* Increased Performance
* Simplified API
* Automatic CSS Generation
* Automatic postMessage Generation
* Partial Refresh
* Conditional Logic
* GDPR Compliance
* Improved Page Speed
* And more!

### Controls 🎛️ ###
* [Background Customizer Control](https://docs.themeum.com/kirki/controls/background/)
* [Code Customizer Control](https://docs.themeum.com/kirki/controls/code/)
* [Checkbox Customizer Control](https://docs.themeum.com/kirki/controls/checkbox/)
* [Color Customizer Control](https://docs.themeum.com/kirki/controls/color/)
* [Color Palette Customizer Control](https://docs.themeum.com/kirki/controls/color-palette/)
* [Dashicons Customizer Control](https://docs.themeum.com/kirki/controls/dashicons/)
* [Date Customizer Control](https://docs.themeum.com/kirki/controls/date/)
* [Dimension Customizer Control](https://docs.themeum.com/kirki/controls/dimension/)
* [Dimensions Customizer Control](https://docs.themeum.com/kirki/controls/dimensions/)
* [Dropdown Pages Customizer Control](https://docs.themeum.com/kirki/controls/dropdown-pages/)
* [Editor Customizer Control](https://docs.themeum.com/kirki/controls/editor/)
* [Generic Customizer Control](https://docs.themeum.com/kirki/controls/generic/)
* [Image Customizer Control](https://docs.themeum.com/kirki/controls/image/)
* [Link Customizer Control](https://docs.themeum.com/kirki/controls/url/)
* [Multiple Checkbox Customizer Control](https://docs.themeum.com/kirki/controls/multicheck/)
* [Multicolor Customizer Control](https://docs.themeum.com/kirki/controls/multicolor/)
* [Number Customizer Control](https://docs.themeum.com/kirki/controls/number/)
* [Radio Customizer Control](https://docs.themeum.com/kirki/controls/radio/)
* [Radio Buttonset Customizer Control](https://docs.themeum.com/kirki/controls/radio-buttonset/)
* [Radio Image Customizer Control](https://docs.themeum.com/kirki/controls/radio-image/)
* [Repeater Customizer Control](https://docs.themeum.com/kirki/controls/repeater/)
* [Select Customizer Control](https://docs.themeum.com/kirki/controls/select/)
* [Slider Customizer Control](https://docs.themeum.com/kirki/controls/slider/)
* [Sortable Customizer Control](https://docs.themeum.com/kirki/controls/sortable/)
* [Switch Customizer Control](https://docs.themeum.com/kirki/controls/switch/)
* [Text Customizer Control](https://docs.themeum.com/kirki/controls/text/)
* [Textarea Customizer Control](https://docs.themeum.com/kirki/controls/textarea/)
* [Toggle Customizer Control](https://docs.themeum.com/kirki/controls/toggle/)
* [Typography Customizer Control](https://docs.themeum.com/kirki/controls/typography/)
* [Upload Customizer Control](https://docs.themeum.com/kirki/controls/upload/)
* [Margin & Padding Controls](https://docs.themeum.com/kirki/extensions/margin-padding/)
* [Headlines & Dividers](https://docs.themeum.com/kirki/extensions/headlines-dividers/)
* [Responsive Controls](https://docs.themeum.com/kirki/extensions/responsive-controls/)
* [Input Slider](https://docs.themeum.com/kirki/extensions/input-slider/)
* [Tabs](https://docs.themeum.com/kirki/extensions/tabs/)

### Documentation 📖 ###
You can find detailed documentation on how to use Kirki on https://www.themeum.com/kirki/

== Installation ==
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](https://docs.themeum.com/kirki/getting-started/integration/).

== Changelog ==

= 5.2.3 - April 10, 2026

Update: Performance optimizations and random fixes.

= 5.2.2 - February 17, 2026

Fix: Color palette not displaying in the Customizer in certain cases.
Fix: Select field inside Repeater control not retaining the selected value.

= 5.2.1 - February 10, 2026

Fix: Fixed an issue where the file path was used incorrectly.

= 5.2.0 - February 09, 2026

Update: Performance optimizations across the platform.
Update: Added compatibility with WordPress 6.9.

= 5.1.0 - March 22, 2024

Fix: We've resolved the issue with fonts not loading properly, ensuring your designs look sleek and professional.
Fix: Addressed deprecated errors to boost compatibility and keep your site running smoothly.
Update: We've ensured compatibility with the latest WordPress 6.4 and PHP 8.2, so you can stay up-to-date with the latest technologies. 
 
= 5.0.0 - June 21, 2023

Update: Free and Pro merged  

= 4.2.0 - June 13, 2023

Fix:: Deprecated PHP issue
Update: PHP 8.1 and 8.2 compatibility
Update: WordPress latest (v6.2.2) compatibility

= 4.1.1 - February 08, 2023

Update: Rename kirki packages dir & composer vendor-dir

= 4.1.0 - February 07, 2023

New: Settings page to allow users to clear the Kirki font cache.
Tweak: Bundled all individual packages into the main repository, reducing the number of repositories used in development. This simplifies development by eliminating the need to work on multiple repositories.
