readme.txt (32061B)
1 === Kirki === 2 Contributors: aristath, fovoc, igmoweb 3 Tags: customizer,options framework, theme, mods, toolkit 4 Donate link: http://kirki.org/ 5 Requires at least: 4.4 6 Tested up to: 4.6.1 7 Stable tag: 2.3.7 8 License: GPLv2 or later 9 License URI: http://www.gnu.org/licenses/gpl-2.0.html 10 11 The ultimate toolkit for theme developers using the WordPress Customizer 12 13 14 == Description == 15 16 [](https://travis-ci.org/aristath/kirki) [](https://scrutinizer-ci.com/g/aristath/kirki/?branch=master) [](https://codeclimate.com/github/aristath/kirki) [](https://raw.githubusercontent.com/aristath/kirki/master/LICENSE) [](https://gitter.im/aristath/kirki?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge&utm_content=badge) 17 18 Kirki is a Toolkit allowing WordPress developers to use the Customizer and take advantage of its advanced features and flexibility by abstracting the code and making it easier for everyone to create beautiful and meaningful user experiences. 19 20 Kirki does not replace the WordPress Customizer API, you can still use the default WordPress methods and we advise you to familiarize yourselves with it. An excellent handbook for the WordPress Customizer can be found on the developer.wordpress.org website. 21 22 What Kirki does is save you time… LOTS of time! 23 24 Easily add configurations for your project, create panels, sections and add fields with ease. 25 26 Automatically create CSS from your fields, and make the customizer’s preview instant with our automatic postMessage scripts creation! 27 28 Add Google Fonts with our typography field, add tooltips to help your users and build awesome products! 29 30 You can find detailed documentation on how to use Kirki on [https://kirki.org](https://kirki.org) 31 32 == Installation == 33 34 Simply install as a normal WordPress plugin and activate. 35 36 If you want to integrate Kirki in your theme or plugin, please read the instructions on [our ducumentation site](https://kirki.org/docs/advanced/integration.html). 37 38 == Changelog == 39 40 = 2.3.7 = 41 42 October 22, 2016, dev time: 12 hours. 43 44 * Fix: `spacing` controls were not updating after save 45 * New: Now using the WP Notifications API in the customizer for spacing & dimension controls (requires WP 4.6). 46 * Fix: Allow overriding `option_type` with `theme_mod` when global config uses `option` by using the `option_type` argument in the fields. 47 * Fix: Disabled the custom kirki-preview loader. This will have to be built more modular in future versions. 48 * Fix: Refactored panel & section icons. 49 * Fix: postMessage now works better with slider controls. 50 * Fix: Reset button not working unless tooltips are loaded. 51 * Fix: Properly sanitize `link` and `url` fields. 52 * Fix: Automate sanitization for `repeater` fields. 53 54 = 2.3.6 = 55 56 August 28, 2016, dev time: 3 hours. 57 58 * Fix: CSS prefixes order fixes ([#1042](https://github.com/aristath/kirki/pull/1042)). 59 * Fix: `suffix` output argument support in Multicolor control ([#1042](https://github.com/aristath/kirki/pull/1042)). 60 * Fix: `Kirki::get_variables()` method should be static ([#1050](https://github.com/aristath/kirki/pull/1050)). 61 * Fix: Add line wrapping to CodeMirror ([#1079](https://github.com/aristath/kirki/pull/1079)). 62 * Fix: `container_inclusive` is disregarded on the selective refresh class ([#1089](https://github.com/aristath/kirki/issues/1089)). 63 * Fix: Support `input_attrs` parameter for controls ([#1074](https://github.com/aristath/kirki/issues/1074)). 64 * Fix: Outdated Google-Fonts list ([#1091](https://github.com/aristath/kirki/issues/1091)). 65 66 = 2.3.5 = 67 68 July 2, 2016. dev time: 6 hours. 69 70 * FIX: Missing button labels in `repeater` fields. 71 * FIX: Missing button label in `code` fields ([#1017](https://github.com/aristath/kirki/issues/1017)). 72 * FIX: Better implementation when embedding Kirki in a theme ([#1025](https://github.com/aristath/kirki/issues/1025)). 73 * FIX: Updated google-fonts ([#1041](https://github.com/aristath/kirki/issues/1041)). 74 * NEW: Allow simpler format for `variables` argument ([#1020](https://github.com/aristath/kirki/issues/1020)). 75 76 = 2.3.4 = 77 78 June 1, 2016, dev time: 30 minutes. 79 80 * FIX: Repeater JS issues due to error in translation strings. 81 82 = 2.3.3 = 83 84 May 31, 2016, dev time: 17 hours. 85 86 * FIX: Editor field covering the content ([#955](https://github.com/aristath/kirki/issues/955)). 87 * FIX: Smoother transition for editor switching. 88 * FIX: Code field JS error when using "php" mode ([#958](https://github.com/aristath/kirki/issues/958)). 89 * FIX: `postMessage` for typography fields ([#528](https://github.com/aristath/kirki/issues/528)). 90 * FIX: translation strings ([#960](https://github.com/aristath/kirki/issues/960)). 91 * FIX: `postMessage` for `background-image` properties ([#963](https://github.com/aristath/kirki/issues/963)). 92 * FIX: Reset Typography Control without font-family default value ([#951](https://github.com/aristath/kirki/issues/951)). 93 * FIX: Typography field: font-style missing in CSS output if variant is regular/400 ([#977](https://github.com/aristath/kirki/issues/977)). 94 * FIX: Placing two editor controls in the customizer leads to odd behavior ([#140](https://github.com/aristath/kirki/issues/140)). 95 * FIX: Typography field: letter-spacing missing in CSS output if its value is 0 ([#978](https://github.com/aristath/kirki/issues/978)). 96 * FIX: Allow using HTML in section descriptions ([#976](https://github.com/aristath/kirki/issues/976)). 97 * FIX: Bug preventing partial refreshes from working properly ([#991](https://github.com/aristath/kirki/issues/991)). 98 * FIX: Better internationalization handling. 99 * FIX: Output errors on typography settings ([#975](https://github.com/aristath/kirki/issues/975)). 100 * NEW: Added a new `attr` argument to `js_vars` ([#957](https://github.com/aristath/kirki/issues/957)). 101 * NEW: Implemented both `AND` and `OR` conditionals in `active_callback` arrays ([#839](https://github.com/aristath/kirki/issues/839)). 102 * NEW: Allow defining an array of dashicons to use. 103 * NEW: Added a `link` control type. 104 105 = 2.3.2 = 106 107 May 2, 2016, dev time: 52 hours. 108 109 * NEW: Completely refactored `editor` controls. 110 * NEW: Completely re-styled `code` controls. 111 * NEW: Added a new `kirki/{$config_id}/styles` filter ([#908](https://github.com/aristath/kirki/issues/908)). 112 * NEW: Added a `customize-control-kirki` class to all Kirki controls. 113 * FIX: Field type number : Cannot read property 'min' of undefined ([#911](https://github.com/aristath/kirki/issues/911)). 114 * FIX: All controls are now prefixed ([#918](https://github.com/aristath/kirki/issues/918)) 115 * FIX: `alpha` argument in color-alpha controls ([#932](https://github.com/aristath/kirki/issues/932)). 116 * FIX: Name attribute in repeaters (props @guillaumemolter). 117 * FIX: Missing label for checkbox controls inside repeaters (props @guillaumemolter). 118 * FIX: Placing 2 editor controls in the customizer leads to odd behaviour ([#140](https://github.com/aristath/kirki/issues/140)). 119 * FIX: `active_callback` conbined with the old `required` argument. ([#906](https://github.com/aristath/kirki/issues/906)). 120 * FIX: Double prefix and suffix in `js_vars` ([#943](https://github.com/aristath/kirki/issues/943)). 121 * FIX: Typography control returns both 'subset' and 'subsets' indexes with the same value ([#948](https://github.com/aristath/kirki/issues/948)). 122 * FIX: Use `strict` JS mode in all controls. 123 124 = 2.3.1 = 125 126 April 19, 2016, dev time: 30 hours. 127 128 * FIX: Spacing control JS dependencies. 129 * FIX: Output property ignored in multicolor field. 130 * FIX: Image sub-controls in repeaters were causing a JS error. 131 * FIX: Text Domain Compliance with Themecheck. 132 * FIX: PostMessage scripts when using more than 1 elements for the output. 133 * FIX: Default values for swithes, toggles & checkboxes. 134 * FIX: Conflict with WP Core's `dropdown-pages` control. 135 * FIX: Auto-transport not working when using serialized options instead of theme_mods. 136 * FIX: `value_pattern` was not working properly when used in `js_vars`. 137 * FIX: Repeater control bugfixes (props @guillaumemolter). 138 * FIX: multi-selects saving single value. 139 * NEW: Added support for `upload` controls in repeaters (props @guillaumemolter). 140 * NEW: Adding mime_type parameter for image, cropped_image, upload controls in repeaters (props @guillaumemolter). 141 * NEW: Added color-picker support in repeater fields (props @guillaumemolter). 142 143 = 2.3.0 = 144 145 April 10, 2016, dev time: 21 hours. 146 147 Kirki is now 100% WordPress Coding Standards compliant. 148 149 * FIX: Escaping google-font URLs when possible. 150 * FIX: Only enqueue the tooltips script if needed. 151 * FIX: WordPress Coding Standards. 152 * FIX: undefined sub-controls were still being saved in typography fields 153 * FIX: Javascript Console Errors: "wp.customize" object undefined when Kirki fields were added in `customize_register` 154 * FIX: markup in editor fields - props @manuelmoreale. 155 * FIX: multiple styles in head when using js_vars 156 * FIX: Sanitization for rem units 157 * FIX: CSS output for multicolor controls 158 * NEW: Repeater labels are now dynamic - props @guillaumemolter. 159 * NEW: The entire header on repeaters is now draggable - props @guillaumemolter. 160 * TWEAK: More efficient JS code for the typography control 161 162 = 2.2.10 = 163 164 * FIX: Issue with URLs when using Kirki embedded in a theme and not installed as a plugin. 165 166 = 2.2.9 = 167 168 * FIX: Repeater controls were not working on 2.2.8 due to a typo - props @guillaumemolter 169 * NEW: Repeater fields now allow more control types (email/tel/url/hidden) - props @guillaumemolter 170 171 = 2.2.8 = 172 173 April 6, 2016, dev time: 5 hours. 174 175 * FIX: Enqueued assets missing when useg WP_DEBUG & WP_DEBUG_SCRIPT 176 * FIX: Checkboxes were not properly displaying their values 177 * FIX: Javascript errors when `number` controls were used without `min`, `max` or `step`. 178 * FIX: Multiselect controls issue with the `sanitize_callback` used. 179 * NEW: Make attributes in `cropped_image` sub-controls inside repeaters dynamic (props @guillaumemolter). 180 181 = 2.2.7 = 182 183 April 5, 2016, dev time: 23 hours. 184 185 * FIX: Properly parsing `postMessage` scripts when `transport` is set to `auto`. 186 * FIX: Background image was outputing CSS even if it was empty. 187 * FIX: Default value for checkboxes. 188 * FIX: Issue with plugin URLs in the customizer, when the plugin was embedded in a theme. 189 * FIX: Descriptions were now shown in `sortable` fields. 190 * FIX: Reset not working for textarea fields. 191 * FIX: In some cases only the first element in `output` arguments was being processed. 192 * FIX: edge-case bugfix for select controls when data saved if the db was somehow mis-formatted. 193 * FIX: Repeater controls now use image IDs instead of image URLs. Props @guillaumemolter 194 * NEW: Added `text-align` ability in `typography` fields. 195 * NEW: Added `text-transform` ability in `typography` fields. 196 * NEW: Introduce `value_pattern` argument for `output` & `js_vars`. 197 * NEW: Started refactoring the `Kirki_Field` class. Now each field can have its own sub-class extending the main Kirki_Field object. 198 * NEW: `multicolor` control. 199 * NEW: Added `cropped_image` support in `repeater`. Props @guillaumemolter 200 * TWEAK: Renamed `Kirki_Customizer_Scripts_Loading` to `Kirki_Scripts_Loading`. 201 * TWEAK: Renamed `Kirki_Customizer_Scripts_Tooltips` to `Kirki_Scripts_Tooltips`. 202 * TWEAK: Renamed `Kirki_Customizer_Scripts_Icons` to `Kirki_Scripts_Icons`. 203 * TWEAK: More inline comments, docs & coding-standards improvements. 204 * DEPRECATED: Removed the `Kirki_Colourlovers` class. 205 206 = 2.2.6 = 207 208 March 26, 2016, dev time: 10 hours 209 210 * FIX: Invalid variants for google fonts were getting enqueued due to a mischeck. 211 * FIX: Repeater rows are now minimized by default. 212 * FIX: Styling for the `dropdown-pages` control. 213 * FIX: `switch` controls now properly resize based on the label used in the `choices` argument. 214 * FIX: It is now possible to use `calc()` in CSS value controls. 215 * FIX: Styles were being applied to the customizer even if they were not defined in the `kirki/config` filter. 216 * FIX: Removed unnecessary class inheritances & other code cleanups. 217 * NEW: Allow resetting options per-section. 218 * NEW: Added new `color-palette` control. 219 * NEW: Added `'transport' => 'auto'` to auto-calculate postMessage scripts from the `output` argument when possible. 220 * NEW: Added Material design palettes in the `Kirki_Helper` class. 221 * NEW: Allow changing the "Add Row" text on repeater fields. 222 * NEW: Allow setting a limit for repeater rows. 223 224 = 2.2.5 = 225 226 March 23, 2016, dev time: 7 hours 227 228 * FIX: Google fonts now loaded via a PHP array instead of a JSON file. 229 * FIX: CSS issue due to escaped quotes on standard fonts. 230 * FIX: Issue when using `units` on `js_vars` combined with the `style` method. 231 * FIX: Missing textdomain on a string. 232 * NEW: Refactored postMessage scripts. 233 * NEW: Allow passing options to iris using the `choices` argument on color controls. 234 * NEW: Allow disabling the custom loader using the `disable_loader` argument in the `kirki/config` filter. 235 236 = 2.2.4 = 237 238 March 20, 2016, dev time: 6 hours 239 240 * FIX: Removed unnecessary CSS echoed by the `typography` control 241 * FIX: Color Calculation class improvements 242 * FIX: CSS improvement for `toggle` controls 243 * NEW: Added `dashicons` field 244 * NEW: Added the ability to limit the number of rows in `repeater` controls (props @fovoc) 245 246 = 2.2.3 = 247 248 March 19, 2016 249 250 * FIX: Selecting a color inside typography controls was throwing a JS error (typo) 251 * FIX: CSS alignment for descriptions in toggle controls 252 * FIX: Default value for letter-spacing setting in typography controls (props @andreg) 253 254 = 2.2.2.1 = 255 256 March 18, 2016, dev time: 5 minutes 257 258 * FIX: Backwards-compatibility bugfix 259 260 = 2.2.2 = 261 262 March 17, 2016, dev time: 10 minutes 263 264 * FIX: PHP notice for non-standard controls when the `element` defined in an `output` argument is of type `array`. 265 266 = 2.2.1 = 267 268 March 17, 2016, dev time: 3 hours 269 270 * FIX: Alpha channel was always enabled for color controls 271 * FIX: PHP Notices in the class-kirki-output-control-typography.php file 272 * FIX: PHP Fatal error on PHP 5.2 273 * FIX: PHP Notice in the class-kirki-field.php file 274 * FIX: PHP Fatal error when using background-position in the output argument 275 * TWEAK: Removed unused languages from CodeMirror to reduce the plugin's size 276 277 = 2.2.0 = 278 279 March 16, 2016, dev time: 120 hours 280 281 * FIX: Improved & simplified the `number` control. 282 * FIX: Improved & simplified the `spacing` control. 283 * FIX: Minor bugfix on the `select` control. 284 * FIX: WP Coding standards improvements. 285 * FIX: Bugfix for radio controls. 286 * FIX: Fixed repeater remove image not triggering save button to activate, and added a placeholder when the image is removed. (props @sayedwp) 287 * FIX: Fixed bug when using negative numbers as min value in the `number` field 288 * FIX: Typo in the textdomain for some strings (some strings were using "Kirki" instead of "kirki"). 289 * FIX: Complete refactor & rewrite of the google-fonts implementation. 290 * FIX: IE11 bug on radio-image controls. 291 * FIX: Radio-image bug when used with serialized options. 292 * NEW: Complete refactor & rewrite of typography control. 293 * NEW: Refactored the CSS output methods. 294 * NEW: Added new mothods for detecting dependencies. 295 * NEW: Added font-subsets in typography controls. 296 * NEW: Google fonts now only show valid variants & subsets in typography controls. 297 * NEW: Implemented partial refreshes for WP 4.5 using a "partial_refresh" argument (formatted as an array). 298 * NEW: Better autoloader & improved file structure. 299 * NEW: Deprecated the `Kirki_Field_Sanitize` class in favor of a more simplified & robust implementation. 300 * NEW: Completely refactored the `Kirki_Field` class, we're migrating to a more OOP model. 301 * NEW: Added a new `kirki-generic` control. 302 * NEW: Deprecated the custom text control and used the new `kirki-generic` control instead. 303 * NEW: Deprecated the custom textarea control and used the new `kirki-generic` control instead. 304 * NEW: Renamed the `help` argument to `tooltip`. `help` will continue to work as an alias. 305 * NEW: Merged the `color` & color-alpha` controls. We now use the `color-alpha` control for all colors, and just modify the `data-alpha` property it has. 306 * NEW: Started an OOP rewrite of many classes 307 * NEW: Started rewriting the PHPUNIT tests & tweaked them so they can now run on localhosts (like VVV) and not just on travis-ci. 308 * NEW: Included the ariColor library for color calculations (https://aristath.github.io/ariColor/) 309 * TWEAK: Other code refactoring for improved performance 310 * TWEAK: Updated `grunt` packages. 311 312 = 2.1.0.1 = 313 314 February 17, 2016, dev time: 5 minutes 315 316 * FIX: PHP Notices (undefined index) 317 318 = 2.1.0 = 319 320 February 17, 2016, dev time: 4 hours 321 322 * FIX: Image field issues inside the Repeater field (props @sayedwp) 323 * NEW: Allow disabling output per-config 324 * NEW: Introduce 'postMessage' => 'auto' option in config (will auto-create `js_vars` using the `output` argument) 325 * NEW: New color control using a js-based template 326 * TWEAK: Branding script rewrite 327 * TWEAK: Color controls styling 328 * TWEAK: Coding improvements & cleanups 329 330 = 2.0.9 = 331 332 February 13, 2016, dev time: 1 hour. 333 334 * FIX: Google fonts bug (use double quotes when font name contains a space character) 335 * FIX: Checkbox control bug (checkboxes were always displayed as checked, regardless of their actual value) 336 * NEW: Intruducing KIRKI_NO_OUTPUT constant that disables CSS output completely when set to true. 337 338 = 2.0.8 = 339 340 February 10, 2016, dev time: 2 hours 341 342 * FIX: Only load Kirki styles when in the customizer 343 * FIX: Performance issue with Google Fonts 344 * NEW: Added radio-image controls to repeaters 345 * TWEAK: Better color handling in the Kirki_Color class 346 347 = 2.0.7 = 348 349 January 19, 2016, dev time: 1 hour 350 351 * FIX: Narrow the scope of "multicheck" modification checker (props @chetzof) 352 * FIX: PHP warnings due to invalid callback method 353 * FIX: postMessage bug introduced in 2.0.6 (2 lines commented-out) 354 355 = 2.0.6 = 356 357 January 18, 2016, dev time: 7 hours 358 359 * FIX: Fix active callback for multidimensional arrays. (props @andrezrv) 360 * FIX: Correctly check current value of checkbox control. (props @andrezrv) 361 * FIX: Bug in the sortable field (props @daviedR) 362 * FIX: Fixed some bugs that occured when using serialized options instead of theme_mods 363 * NEW: Added an image sub-field to repeater fields (props @sayedwp) 364 * NEW: Added a JS callback to js_vars (props @pingram3541) 365 * TWEAK: Settings sanitization 366 * TWEAK: Removed demo theme from the plugin. This is now provided separately on https://github.com/aristath/kirki-demo 367 368 = 2.0.5 = 369 370 December 23, 2015, dev time: 2.5 hours 371 372 * FIX: Disabled the ajax-loading method for stylesheets. All styles are now added inline. Will be re-examined for a future release. 373 * FIX: Number controls were not properly triggering changes 374 * FIX: Styling for number controls 375 * FIX: In some cases the dynamic CSS was added before the main stylesheet. We now add them using a priority of 999 to ensure they are enqueued afterwards. 376 377 = 2.0.4 = 378 379 December 19, 2015, dev time: 3 hours 380 381 * NEW: Added units support to the Typography field 382 * NEW: Default methods of enqueuing styles in now inline. 383 * NEW: Added 'inline_css' argument to config. set to false to add styles using AJAX. 384 * FIX: HTML mode for CodeMirror now functional 385 * FIX: PHP Notices when the config filter is used wrong 386 * FIX: Monor bugfix for text inputs 387 * FIX: Indentation & coding standards 388 * FIX: failing PHPUNIT test. 389 * TWEAK: Remove passing click event object 390 391 = 2.0.3 = 392 393 December 6, 2015, dev time: 45 minutes 394 395 * Bugfix for updates 396 397 = 2.0.2 = 398 399 December 6, 2015, dev time: 30 minutes 400 401 * FIX: Fatal error on update (not on new installations) 402 * FIX: Typo 403 404 = 2.0.1 = 405 406 December 6, 2015, dev time: 10 minutes 407 408 * FIX: Some configurations were failing with the new autoloader. Reverted to a simpler file structure. 409 410 = 2.0 = 411 412 December 6, 2015, dev time > 140 hours 413 414 * NEW: Added support for `sanitize_callback` arguments on each item in the CSS `output`. 415 * NEW: Added the ability to define an array as element in the `output`. 416 * NEW: Auto-prefixing CSS output for cross-browser compatibilities. 417 * NEW: Allow using arrays in settings. 418 * NEW: Dimension Field. 419 * NEW: Repeater Field. 420 * NEW: Code Field using the ACE editor. 421 * NEW: Typography Control. 422 * NEW: Preset Field. 423 * NEW: Demo theme. 424 * NEW: Spacing Control. 425 * REMOVED: Redux Framework compatibility. 426 * FIX: Minor bugfixes to the Kirki_Color class. 427 * FIX: kirki_get_option now uses Kirki::get_option(). 428 * FIX: Various bugfixes. 429 * TWEAK: Converted the `checkbox` control to use the JS templating system. 430 * TWEAK: Converted the `custom` control to use the JS templating system. 431 * TWEAK: Converted the `multicheck` control to use the JS templating system. 432 * TWEAK: Converted the `number` control to use the JS templating system. 433 * TWEAK: Converted the `palette` control to use the JS templating system. 434 * TWEAK: Converted the `radio-buttonset` control to use the JS templating system. 435 * TWEAK: Converted the `radio-image` control to use the JS templating system. 436 * TWEAK: Converted the `radio` control to use the JS templating system. 437 * TWEAK: Converted the `select` control to use the JS templating system. 438 * TWEAK: Converted the `slider` control to use the JS templating system. 439 * TWEAK: Converted the `switch` control to use the JS templating system. 440 * TWEAK: Converted the `textarea` control to use the JS templating system. 441 * TWEAK: Converted the `toggle` control to use the JS templating system. 442 * TWEAK: `radio-buttonset` controls are now CSS-only. 443 * TWEAK: `radio-image` controls are now CSS-only. 444 * TWEAK: `select` controls nopw use [selectize](http://brianreavis.github.io/selectize.js/) instead of [Select2](https://select2.github.io/). 445 * TWEAK: Deprecated `select2` and `select2-multiple` controls. We now have a global `select` control. Previous implementations gracefully fallback to the current one. 446 * TWEAK: `switch` controls are now CSS-only. 447 * TWEAK: `toggle` controls are now CSS-only. 448 * TWEAK: Sliders now use an HTML5 "range" input instead of jQuery-UI. 449 * TWEAK: Better coding standards. 450 * TWEAK: Descriptions styling. 451 * TWEAK: Improved controls styling. 452 * TWEAK: Compiled CSS & JS for improved performance. 453 * TWEAK: Added prefix to the sanitized output array. 454 * TWEAK: Updated google-fonts. 455 * TWEAK: Grunt integration. 456 * TWEAK: Some Code refactoring. 457 458 = 1.0.2 = 459 460 July 17, 2014, dev time: 5 minutes 461 462 * NEW: Added 'disable_output' and 'disable_google_fonts' arguments to the configuration. 463 464 = 1.0.1 = 465 466 July 17, 2014, dev time: 1 hour 467 468 * FIX: Issues when using serialized options instead of theme_mods or individual options. 469 * FIX: Issues with the `output` argument on fields. 470 * FIX: Other minor bugfixes 471 472 = 1.0.0 = 473 474 July 11, 2014, dev time: 177 hours 475 476 * NEW: Added PHPUnit tests 477 * NEW: Use wp_add_inline_style to add customizer styles 478 * NEW: Rebuilt the background fields calculation 479 * NEW: Now using Formstone for switches & toggles 480 * NEW: Added a new API. See https://github.com/aristath/kirki/wiki for documentation. 481 * NEW: Minimum PHP requirement is now PHP 5.2 482 * NEW: Added a Select2 field type. 483 * NEW: Introducing the Kirki::get_option() method to get values. 484 * NEW: added 'media_query' argument to output. 485 * NEW: Added ability to get variables for CSS preprocessors from the customizer values. See https://github.com/aristath/kirki/wiki/variables for documentation 486 * NEW: now supporting 'units' to all outputs to support '!important' 487 * NEW: Ability to create panels & sections using the new API. 488 * NEW: added a get_posts method to the Kirki class. 489 * NEW: Implement width argument in the styling options. See https://github.com/aristath/kirki/wiki/Styling-the-Customizer 490 * NEW: add 'kirki/control_types' filter 491 * FIX: Properly saving values in the db when using serialized options 492 * FIX: Check if classes & functions exist before adding them (allows for better compatibility when embedded in a theme) 493 * FIX: PHP Warnings & Notices 494 * FIX: Other minor bugfixes 495 * FIX: Now using consistently `option_type` instead of `options_type` everywhere 496 * FIX: `Kirki::get_option()` method now works for all fields, including background fields. 497 * FIX: avoid errors when Color is undefined in background fields 498 * FIX: Use WP_Filesystem to get the google fonts array from a json file 499 * FIX: Radio-Button styling 500 * FIX: PHP Notices 501 * FIX: Typos 502 * FIX: Properly sanitizing rgba colors 503 * FIX: Properly sanitize numbers 504 * FIX: Make sure all variables are escaped on output 505 * TWEAK: Simplify the Colourlovers integration. 506 * TWEAK: Improve sanitization 507 * TWEAK: Improve the Kirki_Styles_Customizer class 508 * TWEAK: Code cleanups 509 * TWEAK: Added more inline docs (lots of them) 510 * TWEAK: Use active_callback for required arguments instead of custom JS 511 * TWEAK: Updated translation files 512 * TWEAK: Better color manipulation in the Kirki_Color class 513 * TWEAK: Move secondary classes instantiation to the Kirki() function. 514 * TWEAK: set a $kirki global 515 * TWEAK: deprecate getOrThrow method in the Kirki_Config class. 516 * TWEAK: Move sanitisation functions to a Kirki_Sanitize class. 517 * TWEAK: Rename Kirki_Framework to Kirki_Toolkit. 518 * TWEAK: Move variables to the new API 519 * TWEAK: simplify Kirki_Controls class 520 * TWEAK: move the kirki/fields & kirki/controls filters to the new API 521 * REMOVED: remove the 'stylesheet_id' from the configuration. 522 523 = 0.8.4 = 524 525 April 6, 2014, dev time: 0.5 hours 526 527 * FIX: Color sanitization was distorting 0 characters in the color hex. 528 * FIX: Properly sanitizing ColorAlpha controls 529 * FIX: Sanitizing more properties in the Fields class 530 * FIX: removing remnant double-sanitization calls from the controls classes 531 532 = 0.8.3 = 533 534 April 5, 2014, dev time: 28 hours 535 536 * NEW: Introduce a Field class 537 * NEW: Introduce a Builder class 538 * TWEAK: Code Cleanups 539 * NEW: Added ability to use 'option' as the setting type 540 * Fix : Bugs in the color calculation class 541 * TWEAK: Everything gets sanitized in the "Field" class 542 * FIX: Bugs in sortable field 543 * FIX: Editor control had no description 544 * NEW: Added a color-alpha control. To use it just set an rgba color as the default value. 545 * TWEAK: SCSS & CSS improvements 546 * FIX: Various PHP notices and warnings when no fields are defined 547 * TWEAK: More efficient color sanitization method 548 * TWEAK: Improved number control presentation 549 * TWEAK: Improved the way background fields are handled 550 * TWEAK: Checkboxes styling 551 * NEW: Allow using rgba values for background colors 552 * FIX: CSS fix - :focus color for active section 553 * NEW: Add a static 'prepare' method to the ScriptRegistry class 554 * FIX: Issues with the URL when Kirki is embedded in a theme 555 556 = 0.8.2 = 557 558 March 30, 2015, dev time: 5 minutes 559 560 * FIX: Autoloader could not properly include files due to strtolower() 561 562 = 0.8.1 = 563 564 March 30, 2015, dev time: 30 minutes 565 566 * FIX: Translation strings now overridable using the config filter. 567 568 = 0.8.0 = 569 570 March 30, 2015, dev time: 32 hours 571 572 * Improvement: OOP redesign (props @vpratfr) 573 * NEW: Added Palette control 574 * NEW: Added Editor control (WYSIWYG - uses TinyMCE) 575 * NEW: Added Custom control (free html) 576 * NEW: Added a Kirki_Colourlovers class to use palettes from the colourlovers API 577 * NEW: Added a composer file (props @vpratfr) 578 * FIX: Wrong settings IDs 579 * FIX: Color calculation on RGBA functions were off 580 * TWEAK: Restructuring the plugin (props @vpratfr) 581 * NEW: added a functional kirki_get_option() function 582 * TWEAK: Simplified configuration options. 583 * NEW: Turn Kirki into a singleton and a facade (props @vpratfr) 584 * TWEAK: Completely re-written the customizer styles 585 * NEW: Using SASS for customizer styles 586 * TWEAK: Deprecating the group_title control in favor of the new custom control 587 * TWEAK: Changed the CSS for checkboxes 588 589 = 0.7.1 = 590 591 March 15, 2015, dev time: 2 hours 592 593 * REMOVED: Remove the `kirki_get_option` function that was introduced in 0.7 as it's not working properly yet. 594 * FIX: Undefined index notice when a default value for the control was not defined 595 * TWEAK: `logo_image` now injects an `img` element instead of a `div` with custom background 596 * NEW: Added `description` argument in the kirki configuration (replaces the theme description) 597 598 = 0.7 = 599 600 March 14, 2015, dev time: 10 hours 601 602 * FIX: Array to string conversion that happened conditionally when used with googlefonts. (props @groucho75) 603 * FIX: Background opacity affects background-position of bg image 604 * FIX: font-weight not being applied on google fonts 605 * NEW: Added `kirki_get_option( $setting );` function that also gets default values 606 * TWEAK: Singleton for main plugin class 607 * FIX: Prevent empty help tooltips 608 * NEW: Added `toggle` control 609 * NEW: Added `switch` control 610 * FIX: Color controls were not being reset to default: 611 * TWEAK: Tooltips now loaded via jQuery 612 * TWEAK: Renamed `setting` to settings for consistency with WordPress core 613 * TWEAK: Renamed `description` to `help` and `subtitle` to `description for consistency with WordPress core 614 * TWEAK: Backwards-compatibility improvements 615 * NEW: Allow hiding background control elements by not including default values for them 616 * TWEAK: Performance improvements 617 * TWEAK: Using WordPress core controls instead of custom ones when those are available 618 * TWEAK: Separate logic for multiple-type controls that were using the "mode" argument. This has been deprecated in favor of completely separate control types. 619 620 = 0.6.2 = 621 622 March 2, 2015, dev time: 3 hours 623 624 * FIX: Frontend styles were not properly enqueued (props @dmgawel) 625 * NEW: Allow multiple output styles per control defined as an array of arrays. 626 * FIX: Background control styles 627 * FIX: Serialise default values for the sortable control. Now you can define default values as an array. 628 * FIX: Required script 629 * FIX: \'_opacity\' was added to a lot of controls by mistake. Removed it and wrote a migration script. 630 631 = 0.6.1 = 632 633 February 25, 2015, dev time: 1 hours 634 635 * FIX: Sortables controls had a JS conflict 636 * FIX: Switches & Toggles were not properly working 637 638 = 0.6.0 = 639 640 February 25, 2015, dev time: 9 hours 641 642 * FIX: Tooltips now properly working 643 * NEW: Added checkbox switches 644 * NEW: Added checkbox toggles 645 * FIX: Generated CSS is not properly combined & minified 646 * FIX: Re-structuring files hierarchy 647 * FIX: Simplify the way controls are loaded 648 * NEW: Only load control classes when they are needed 649 * NEW: Introducing Kirki_Customize_Control class 650 * FIX: CSS tweaks 651 * NEW: Sortable control (creating one is identical to a select control, but with `\'type\' => \'sortable\'`) 652 * FIX: Double output CSS (props @agusmu) 653 * NEW: Google fonts now parsed from a json file. 654 655 = 0.5.1 = 656 657 January 22, 2015 658 659 * FIX: Transport defaults to refresh instead of postMessage 660 * FIX: undefined index notice. 661 662 = 0.5 = 663 664 January 21, 2015 665 666 * NEW: Automatic output of styles for generic controls. 667 * NEW: Automatic output of styles + scripts for fonts (including googlefonts ) 668 * NEW: The \'output\' argument on background controls is now an array for consistency with other controls. Older syntax is still compatible though. :) 669 * NEW: Add the ability to auto-generate styles for colors. 670 * FIX: Add a blank stylesheet if we need one and no stylesheet_id has been defined in the config options. 671 * FIX: CSS-only tooltips. Fixes issue with tooltips now showing up on WP >= 4.1 672 * FIX: Code cleanups 673 * NEW: Added support for WordPress\'s transport arguments 674 * FIX: All controls now have a sanitization callback. Users can override the default sanitizations by adding their own \'sanitize_callback\' argument. 675 * FIX: OOP rewrite 676 * FIX: Strip protocol from Google API link 677 * FIX: Loading order for some files 678 * FIX: Removed deprecated less_var argument 679 680 = 0.4 = 681 682 October 25, 2014 683 684 * FIX: bugfix for selector 685 * NEW: Change the Kirki theme based on which admin theme is selected. 686 * FIX: Tranlsation domain issue 687 * NEW: Added a \"group_title\" control 688 * FIX: Updated the required script 689 * FIX: Updating CSS 690 * Other minor improvements and bugfixes 691 692 = 0.3 = 693 694 May 26, 2014 695 696 * NEW: added background field 697 * NEW: added \'output\' argument to directly output the CSS 698 699 = 0.2 = 700 701 May 9, 2014 702 703 * Initial version