Kirki - Version 3.0.1

Version Description

June 22, 2017, dev time: 5 minutes

  • Fix: Undefined index PHP Notice.
Download this release

Release Info

Developer aristath
Plugin Icon 128x128 Kirki
Version 3.0.1
Comparing to
See all releases

Code changes from version 3.0.0 to 3.0.1

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