README

贡献者： aristath, fovoc, igmoweb
标签： 自定义设置器，选项框架，主题，模块，工具包
捐赠链接： http://kirki.org/
至少需要 4.4
测试到 4.8
稳定标签 2.3.8
许可协议： GPLv2 或更新版
许可协议链接： https://gnu.ac.cn/licenses/gpl-2.0.html

使用 WordPress 自定义设置器的主题开发者的终极工具包

描述

Kirki 是一个工具包，允许 WordPress 开发者通过抽象代码并使其更易于每个人创建美观而有意义的用户体验，来利用自定义设置器的先进功能和灵活性。

Kirki 并不替代 WordPress 自定义设置器 API，您仍然可以使用默认的 WordPress 方法，我们建议您熟悉它们。开发者.wordpress.org 网站上可以找到关于 WordPress 自定义设置器的优秀手册。

Kirki 可以为您节省时间... 许多时间！

轻松添加项目配置，创建面板、部分，并轻松添加字段。

自动从您的字段创建 CSS，并使用我们的自动 postMessage 脚本创建使自定义设置器的预览即时化！

使用我们的字体字段添加 Google 字体，添加工具提示以帮助您的用户并构建出色的产品！

您可以在 https://kirki.org 上找到如何使用 Kirki 的详细文档。

安装

只需将其作为正常 WordPress 插件安装并激活。

如果您想在主题或插件中集成 Kirki，请阅读我们文档网站上的说明 。

变更日志

3.0.0

日期 TBT，开发时间：230 小时。

这是一个主要版本。许多内容已经被重构和优化。更新前请保留备份。

• 修复：重构了重置模块。 #1334
• 修复：重构了 postMessage 模块 #1333
• 修复：CodeMirror 上的 PHP 模式。 #1003
• 修复：动态重复标签现在在从选择字段中获取标签时使用标签而不是值。 #1230
• 修复：数字字段的清理。 #1240
• 修复：复选框清理。 #1195
• 修复：编辑器字段中的链接功能。 #968，#1159
• 修复：字段类型编辑器中的问题 #1260
• 修复：可排序控件的问题 #1253，#1197，#1198
• 修复：选项面板的无障碍性问题 #1194
• 修复：字段 "checkbox"、"toggle" 和 "switch" 在 PHP 中不保存为布尔值，而是整数 0/1 #1195
• 修复：开关的提示框未正常工作 #1225
• 修复：在#1228中修复提示框高度问题
• 修复：点击图标外时提示框不关闭 #1226
• 修复：颜色选择器（alpha iris）的视觉表示问题 #1218
• 修复：“重置”为“未定义” #1210
• 修复：保存数组时导致PHP Notice #1199
• 修复：默认禁用了“加载”模块。使用kirki/modules过滤器来启用。
• 修复：重构保存用户元数据（'option_type' => 'user_meta'）。 #1325
• 修复：代码字段重置 #1122
• 修复：排版字段重置 #1193，#1219
• 修复：多颜色字段重置 #916
• 修复：保存后自定义字体在字体列表中未显示为活动状态 #1110
• 修复：使用'transport' => 'auto'时对media_query的支持。 #1184，#1127
• 修复：切换不同重量的Google Fonts时排版字段的bug #1180
• 修复：字体变体输出无效的属性值（排版字段） #1058
• 修复：更新了Web字体。 #1303
• 修复：与postMessage类型不兼容的必需参数。 #1031
• 修复：重复字段中的未定义索引Notice #1291
• 修复：本地主机上的CSS和JS文件的403错误。 #1309
• 修复：如果ACF PRO活动，自定义化器无法加载。 #1302
• 修复：即使未使用，也会排入队列谷歌字体。 #1297
• 修复：默认维度值不好处理百分比单位 #1254，#497
• 修复：编辑器字段与RTL语言的问题 #340
• 修复：Windows Server问题 #1318
• 新增：自动执行复合字段的postMessage。 #694
• 新增：字段依赖中的OR逻辑。 #839
• 新增：单选图像标签。 #1090，#1220
• 新增：支持在输出参数 output 中使用 prefix、suffix 和 value_pattern 字段类型。 #1183
• 新增：重复字段中的多选功能。 #780，#1261
• 新增：现在支持使用 'transport' => 'auto' 实现字体的实时更新。 #1184，#528，#1186
• 新增：现在支持过滤可用的字体。 #1202
• 新增：现在支持加载多个字体变体。 #992，#1082，#1114
• 新增：选择字段现在支持 optgroups。 #1120
• 新增：添加了新的背景控制类型。 #741，#1283，#952
• 新增：将 selectize 替换为 select2。 #1177
• 新增：当值无效时，数字字段将显示通知，这取决于 min/max/step 值。
• 新增：使用 select2 重新构建了字体控制。 cafb89b
• 新增：当使用设置 html 的 js_vars 时，可以使用 value_pattern 参数和 $ 占位符修改值而不是替换它们。 #1137
• 新增：更新了 CodeMirror。 fff6df0
• 新增：在字体控制中添加了 word-spacing。 #1163
• 新增：重构了文件结构，使字段成为独立的实体，更容易解耦和调试。
• 新增：引入了“模块”。
• 新增：重构了工具提示功能（现在是一个模块）。
• 新增：选择性刷新现在是模块。
• 新增：postMessage 现在是模块。
• 新增：重构了部分和面板图标（现在是一个模块）。
• 新增：自定义器样式现在是模块。
• 新增：自定义器品牌现在是模块。
• 新增：CSS 输出现在是模块。
• 新增：从“间距”控制中抽象出了“尺寸”控制。
• 新增：允许保存网站选项（'option_type' => 'site_option'）。 #1326
• 新增：添加了两个新的方法用于加载 Google 字体。请参阅 kirki/{$config_id}/googlefonts_load_method 过滤器。
• 新增：默认情况下，Google 字体现在在样式表中内联添加，以避免额外的 GoogleFonts API 调用。（SEO 和性能改进）。

2.3.8

2017 年 5 月 28 日，开发时间：15 分钟。

这是一个维护版本，为即将到来的 3.0.0 版本做准备。

• 修复：更新字体。
• 新增：添加了使用升级通知的功能。几天后需要 v3.0。

2.3.7

2016 年 10 月 22 日，开发时间：12 小时。

• 修复：保存后 spacing 控件未更新。
• 新增：现在在自定义器中使用 WP 通知 API 更新间距和尺寸控件（需要 WP 4.6）。
• 修复：当全局配置使用option时，允许通过在字段中使用option_type参数覆盖option_type。
• 修复：禁用了自定义的kirki-preview加载器。未来的版本将需要构建得更加模块化。
• 修复：重构了面板和部分的图标。
• 修复：postMessage现在与滑块控件配合得更好。
• 修复：除非加载了工具提示，否则重置按钮不工作。
• 修复：正确清理link和url字段。
• 修复：自动清理repeater字段。

2.3.6

2016年8月28日，开发时间：3小时。

• 修复：CSS前缀顺序修复（#1042）。
• 修复：在多色控件中支持suffix输出参数（#1042）。
• 修复：Kirki::get_variables()方法应该是静态的（#1050）。
• 修复：为CodeMirror添加换行（#1079）。
• 修复：在选择性刷新类中忽略container_inclusive（#1089）。
• 修复：支持控件的控制参数input_attrs（#1074）。
• 修复：过时的Google-Fonts列表（#1091）。

2.3.5

2016年7月2日。开发时间：6小时。

• 修复：repeater字段中缺少按钮标签。
• 修复：code字段中缺少按钮标签（#1017）。
• 修复：将Kirki嵌入主题时的实现更好（#1025）。
• 修复：更新google-fonts（#1041）。
• 新功能：允许更简单的variables参数格式（#1020）。

2.3.4

2016年6月1日，开发时间：30分钟。

• 修复：由于翻译字符串错误导致的repeater JS问题。

2.3.3

2016年5月31日，开发时间：17小时。

• 修复：编辑器字段覆盖内容（#955）。
• 修复：编辑器切换更平滑的过渡。
• 修复：在"php"模式下使用时，代码字段出现JS错误（#958）。
• 修复：字体设置的postMessage（#528）。
• 修复：翻译字符串（#960）。
• 修复：background-image属性的postMessage（#963）。
• 修复：没有字体家族默认值时重置字体设置控件（#951）。
• 修复：当变体为regular/400时，在CSS输出中缺少字体样式（#977）。
• 修复：在自定义器中放置两个编辑器控件会导致异常行为（#140）。
• 修复：当其值为0时，在CSS输出中缺少字母间距（#978）。
• 修复：允许在部分描述中使用HTML（#976）。
• 修复：防止部分刷新正常工作的bug（#991）。
• 修复：更好的国际化处理。
• 修复：在字体设置中输出错误（#975）。
• 新增：向js_vars添加了新的attr参数（《https://github.com/aristath/kirki/issues/957》#957）。
• 新增：在active_callback数组中实现了AND和OR条件（《https://github.com/aristath/kirki/issues/839》#839）。
• 新增：允许定义要使用的dashicons数组。
• 新增：添加了link控件类型。

2.3.2

2016年5月2日，开发时间：52小时。

• 新增：完全重构了editor控件。
• 新增：完全重新设计了code控件。
• 新增：添加了新的kirki/{$config_id}/styles过滤器（《https://github.com/aristath/kirki/issues/908》#908）。
• 新增：给所有Kirki控件添加了customize-control-kirki类。
• 修复：字段类型数字：无法读取未定义的属性'min'（《https://github.com/aristath/kirki/issues/911》#911）。
• 修复：所有控件现在都有前缀（《https://github.com/aristath/kirki/issues/918》#918）。
• 修复：颜色-alpha控件中的alpha参数（《https://github.com/aristath/kirki/issues/932》#932）。
• 修复：重复器中的名称属性（props @guillaumemolter）。
• 修复：重复器内复选框控件缺少标签（props @guillaumemolter）。
• 修复：在定制器中放置两个编辑控件会导致异常行为（《https://github.com/aristath/kirki/issues/140》#140）。
• 修复：active_callback与旧的required参数结合使用（《https://github.com/aristath/kirki/issues/906》#906）。
• 修复：js_vars中的双前缀和后缀（《https://github.com/aristath/kirki/issues/943》#943）。
• 修复：字体排印控件返回了相同的'subset'和'subsets'索引（《https://github.com/aristath/kirki/issues/948》#948）。
• 修复：所有控件现在使用严格的JS模式。

2.3.1

2016年4月19日，开发时间：30小时。

• 修复：间距控件JS依赖。
• 修复：多颜色字段中忽略输出属性。
• 修复：重复器中的图像子控件导致JS错误。
• 修复：与Themecheck的文本域兼容性。
• 修复：使用多个元素进行输出时的PostMessage脚本。
• 修复：开关、切换和复选框的默认值。
• 修复：与WP Core的dropdown-pages控件冲突。
• 修复：使用serialized options而不是theme_mods时，自动传输不起作用。
• 修复：value_pattern在js_vars中使用时不起作用。
• 修复：重复器控件修复（props @guillaumemolter）。
• 修复：多选保存单个值。
• 新增：在重复器中添加了对upload控件的支持（props @guillaumemolter）。
• 新增：为重复器中的图像、裁剪图像和上传控件添加mime_type参数（props @guillaumemolter）。
• 新增：在重复器字段中添加了颜色选择器支持（props @guillaumemolter）。

2.3.0

2016年4月10日，开发时间：21小时。

Kirki现在100%符合WordPress编码标准。

• 修复：尽可能逃避google-font URL。
• 修复：仅在需要时排队提示脚本。
• 修复：WordPress编码标准。
• 修复：在字体排印字段中仍然保存未定义的子控件。
• 修复：当在customize_register中添加Kirki字段时，出现“wp.customize”对象未定义的JavaScript控制台错误。
• 修复：编辑器字段中的标记 - props @manuelmoreale。
• 修复：使用js_vars时头部的多个样式。
• 修复：rem单位的清理。
• 修复：多颜色控件的CSS输出。
• 新增：重复器标签现在是动态的 - props @guillaumemolter。
• 新增：重复器的整个头部现在可以拖动 - props @guillaumemolter。
• 微调：字体排印控件更高效的JS代码。

2.2.10

• 修复：当Kirki嵌入主题而不是作为插件安装时，URL有问题。

2.2.9

• 修复：由于一个错误，重复器控件在2.2.8版本中不起作用 - props @guillaumemolter。
• 新增：中继字段现在允许更多控件类型（电子邮件/电话/网址/隐藏）- props @guillaumemolter

2.2.8

2016年4月6日，开发时间：5小时。

• 修复：当使用 WP_DEBUG & WP_DEBUG_SCRIPT 时，缺少入队的资源。
• 修复：复选框未能正确显示其值
• 修复：当未使用 min、max 或 step 时，使用 number 控件会引发 JavaScript 错误。
• 修复：使用 sanitize_callback 时，多选控件存在问题。
• 新增：使中继器内部 cropped_image 子控件的属性动态化（props @guillaumemolter）。

2.2.7

2016年4月5日，开发时间：23小时。

• 修复：当 transport 设置为 auto 时，正确解析 postMessage 脚本。
• 修复：即使为空，背景图片也输出 CSS。
• 修复：复选框的默认值。
• 修复：当插件嵌入主题时，自定义器中的插件 URL 存在问题。
• 修复：现在在 sortable 字段中显示描述。
• 修复：重置对 textarea 字段不起作用。
• 修复：在某些情况下，仅处理 output 参数中的第一个元素。
• 修复：当数据库格式错误时，select 控件保存数据的边缘情况。
• 修复：中继控件现在使用图像 ID 而不是图像 URL。Props @guillaumemolter
• 新增：在 typography 字段中添加 text-align 功能。
• 新增：在 typography 字段中添加 text-transform 功能。
• 新增：为 output & js_vars 引入 value_pattern 参数。
• 新增：开始重构 Kirki_Field 类。现在每个字段都可以有自己的子类，扩展主 Kirki_Field 对象。
• 新增：multicolor 控件。
• 新增：在 repeater 中添加 cropped_image 支持。Props @guillaumemolter
• 微调：将 Kirki_Customizer_Scripts_Loading 重命名为 Kirki_Scripts_Loading。
• 微调：将 Kirki_Customizer_Scripts_Tooltips 重命名为 Kirki_Scripts_Tooltips。
• 微调：将 Kirki_Customizer_Scripts_Icons 重命名为 Kirki_Scripts_Icons。
• 微调：更多内联注释、文档和编码标准改进。
• 弃用：已移除 Kirki_Colourlovers 类。

2.2.6

2016年3月26日，开发时间：10小时

• 修复：由于误检，无效的 google fonts 变体被入队。
• 修复：中继行默认最小化。
• 修复：dropdown-pages 控件的样式。
• 修复：switch 控件现在根据 choices 参数中使用的标签正确调整大小。
• 修复：现在可以在 CSS 值控件中使用 calc()。
• 修复：即使在 kirki/config 过滤器中未定义，也会应用到自定义器中的样式。
• 修复：删除不必要的类继承和其他代码清理。
• 新增：允许按部分重置选项。
• 新增：添加新的 color-palette 控件。
• 新增：在可能的情况下，添加 'transport' => 'auto' 以自动从 output 参数计算 postMessage 脚本。
• 新增：在 Kirki_Helper 类中添加 Material design 调色板。
• 新增：允许更改中继字段上的 "添加行" 文本。
• 新增：允许为中继行设置限制。

2.2.5

2016年3月23日，开发时间：7小时

• 修复：现在通过 PHP 数组而不是 JSON 文件加载 google fonts。
• 修复：由于标准字体中的转义引号而导致的 CSS 问题。
• 修复：当使用 style 方法结合 js_vars 上的 units 时，存在问题。
• 修复：字符串上缺少 textdomain。
• 新增：重构 postMessage 脚本。
• 新增：允许通过颜色控件上的 choices 参数向 iris 传递选项。
• 新增：允许在 kirki/config 过滤器中使用 disable_loader 参数禁用自定义加载器。

2.2.4

2016年3月20日，开发时间：6小时

• 修复：移除了由 typography 控件产生的多余CSS
• 修复：颜色计算类的改进
• 修复：对 toggle 控件的CSS改进
• 新功能：添加了 dashicons 字段
• 新功能：添加了对 repeater 控件中行数的限制能力（props @fovoc）

2.2.3

2016年3月19日

• 修复：在 typography 控件中选择颜色时抛出JS错误（拼写错误）
• 修复：切换控件中描述的CSS对齐
• 修复：在 typography 控件中字母间距设置的默认值（props @andreg）

2.2.2.1

2016年3月18日，开发时间：5分钟

• 修复：向后兼容性错误修复

2.2.2

2016年3月17日，开发时间：10分钟

• 修复：当 output 参数中定义的 element 类型为 array 时，非标准控件的PHP通知

2.2.1

2016年3月17日，开发时间：3小时

• 修复：颜色控件始终启用alpha通道
• 修复：在 class-kirki-output-control-typography.php 文件中的PHP通知
• 修复：PHP 5.2上的PHP致命错误
• 修复：在 class-kirki-field.php 文件中的PHP通知
• 修复：在输出参数中使用 background-position 时的PHP致命错误
• 微调：从CodeMirror中移除了未使用的语言以减小插件的大小

2.2.0

2016年3月16日，开发时间：120小时

• 修复：改进并简化了 number 控件。
• 修复：改进并简化了 spacing 控件。
• 修复：对 select 控件进行的小错误修复。
• 修复：WP编码标准改进。
• 修复：单选按钮控件的错误修复。
• 修复：修复了移除重复图像时不会触发保存按钮激活的问题，并在移除图像时添加了占位符。（props @sayedwp）
• 修复：在 number 字段中使用负数作为最小值时的错误修复
• 修复：某些字符串文本域中的拼写错误（一些字符串使用“Kirki”而不是“kirki”）。
• 修复：对 google-fonts 实现进行了完全重构和重写。
• 修复：IE11上的单选按钮图像控件错误。
• 修复：与序列化选项一起使用时的单选按钮图像错误。
• 新功能：对字体样式控件进行了完全重构和重写。
• 新功能：重构了CSS输出方法。
• 新功能：添加了检测依赖项的新方法。
• 新功能：在字体样式控件中添加了字体子集。
• 新功能：现在在字体样式控件中仅显示有效的变体和子集。
• 新功能：实现了WP 4.5的局部刷新，使用“partial_refresh”参数（格式为数组）。
• 新功能：更好的自动加载和改进的文件结构。
• 新功能：弃用了 Kirki_Field_Sanitize 类，转而使用更简单、更健壮的实现。
• 新功能：完全重构了 Kirki_Field 类，我们正在迁移到更面向对象的模型。
• 新功能：添加了新的 kirki-generic 控件。
• 新功能：弃用了自定义文本控件，并使用新的 kirki-generic 控件代替。
• 新功能：弃用了自定义文本区域控件，并使用新的 kirki-generic 控件代替。
• 新功能：将 help 参数重命名为 tooltip。help 将继续作为别名使用。
• 新功能：合并了 color 和 color-alpha 控件。我们现在使用 color-alpha 控件来处理所有颜色，只需修改它具有的 data-alpha 属性。
• 新功能：开始对许多类进行面向对象的重新编写
• 新功能：开始重新编写PHP单元测试，并对它们进行了调整，以便它们现在可以在本地主机（如VVV）上运行，而不仅仅是在travis-ci上。
• 新功能：包含ariColor库进行颜色计算（https://aristath.github.io/ariColor/）
• 微调：其他代码重构以改进性能
• 微调：更新 grunt 包。

2.1.0.1

2016年2月17日，开发时间：5分钟

• 修复：PHP通知（未定义索引）

2.1.0

2016年2月17日，开发时间：4小时

• 修复：Repeater字段中的图片字段问题（props @sayedwp）
• 新增：允许按配置禁用输出
• 新增：在配置中引入 'postMessage' => 'auto' 选项（将自动使用 output 参数创建 js_vars）
• 新增：使用基于js的模板的新颜色控制
• 微调：品牌脚本重写
• 微调：颜色控制样式
• 微调：编码改进和清理

2.0.9

2016年2月13日，开发时间：1小时。

• 修复：Google字体错误（当字体名称包含空格字符时使用双引号）
• 修复：复选框控件错误（复选框始终显示为选中状态，而不管它们的实际值如何）
• 新增：引入 KIRKI_NO_OUTPUT 常量，当设置为 true 时将完全禁用 CSS 输出。

2.0.8

2016年2月10日，开发时间：2小时

• 修复：仅在自定义设置中加载 Kirki 样式
• 修复：Google 字体的性能问题
• 新增：向重复器添加了单选图像控件
• 微调：在 Kirki_Color 类中改进颜色处理

2.0.7

2016年1月19日，开发时间：1小时

• 修复：缩小 "multicheck" 修改检查的范围（props @chetzof）
• 修复：由于无效的回调方法导致的 PHP 警告
• 修复：2.0.6 中引入的 postMessage 错误（2 行注释）

2.0.6

2016年1月18日，开发时间：7小时

• 修复：修复了多维数组中活动的回调。 (props @andrezrv)
• 修复：正确检查复选框控件的当前值。 (props @andrezrv)
• 修复：排序字段中的错误（props @daviedR）
• 修复：使用序列化选项而不是 theme_mods 时出现的某些错误
• 新增：向重复器字段添加了图像子字段（props @sayedwp）
• 新增：向 js_vars 添加了 JS 回调（props @pingram3541）
• 微调：设置清理
• 微调：从插件中删除了演示主题。现在它将单独在 https://github.com/aristath/kirki-demo 上提供

2.0.5

2015年12月23日，开发时间：2.5小时

• 修复：禁用了样式表的 AJAX 加载方法。现在所有样式都是内联添加的。将在未来的版本中重新审查。
• 修复：数字控件没有正确触发更改
• 修复：数字控件的样式
• 修复：在某些情况下，动态 CSS 在主样式表之前添加。现在我们使用优先级 999 添加它们，以确保它们在队列中之后添加。

2.0.4

2015年12月19日，开发时间：3小时

• 新增：在 Typography 字段中添加了对单位的支持
• 新增：现在内联排队的样式队列的默认方法。
• 新增：向配置中添加了 'inline_css' 参数。设置为 false 以使用 AJAX 添加样式。
• 修复：CodeMirror 的 HTML 模式现在功能正常
• 修复：当使用错误的配置过滤器时，出现 PHP 通知
• 修复：文本输入的一些错误
• 修复：缩进和编码标准
• 修复：失败的 PHPUNIT 测试。
• 微调：删除传递的点击事件对象

2.0.3

2015年12月6日，开发时间：45分钟

• 更新时的错误修复

2.0.2

2015年12月6日，开发时间：30分钟

• 修复：更新时出现致命错误（不在新安装上）
• 修复：错别字

2.0.1

2015年12月6日，开发时间：10分钟

• 修复：某些配置在新的自动加载器中失败。恢复到更简单的文件结构。

2.0

2015年12月6日，开发时间 > 140小时

• 新增：在 CSS 输出的每个项目上添加了对 sanitize_callback 参数的支持。
• 新增：可以在 output 中定义数组作为元素。
• 新增：自动添加 CSS 输出以实现跨浏览器兼容性。
• 新增：允许在设置中使用数组。
• 新增：维度字段。
• 新增：重复器字段。
• 新增：使用 ACE 编辑器的代码字段。
• 新增：Typography 控制器。
• 新增：预设字段。
• 新增：演示主题。
• 新增：间距控制。
• 移除：Redux 框架兼容性。
• 修复：修复 Kirki_Color 类的少量小错误。
• 修复：kirki_get_option 现在使用 Kirki::get_option()。
• 修复：各种小错误。
• 微调：将 checkbox 控件转换为使用 JS 模板系统。
• 微调：将 custom 控件转换为使用 JS 模板系统。
• 微调：将 multicheck 控件转换为使用 JS 模板系统。
• 微调：将 number 控件转换为使用 JS 模板系统。
• 微调：将 palette 控件转换为使用 JS 模板系统。
• 微调：将 radio-buttonset 控件转换为使用 JS 模板系统。
• 微调：将 radio-image 控件转换为使用 JS 模板系统。
• 微调：将 radio 控件转换为使用 JS 模板系统。
• 微调：将 select 控件转换为使用 JS 模板系统。
• 微调：将 slider 控件转换为使用 JS 模板系统。
• 微调：将 switch 控件转换为使用 JS 模板系统。
• 微调：将 textarea 控件转换为使用 JS 模板系统。
• 微调：将 toggle 控件转换为使用 JS 模板系统。
• 微调：现在 radio-buttonset 控件仅使用 CSS。
• 微调：现在 radio-image 控件仅使用 CSS。
• 微调：现在 select 控件使用 selectize 而不是 Select2。
• 微调：弃用了 select2 和 select2-multiple 控件。我们现在有一个全局的 select 控件。之前的实现会优雅地回退到当前的实现。
• 微调：现在 switch 控件仅使用 CSS。
• 微调：现在 toggle 控件仅使用 CSS。
• 微调：滑块现在使用 HTML5 "range" 输入而不是 jQuery-UI。
• 微调：更好的编码标准。
• 微调：描述样式。
• 微调：改进控件样式。
• 微调：编译 CSS & JS 以提高性能。
• 微调：向输出数组添加前缀。
• 微调：更新了 google-fonts。
• 微调：Grunt 集成。
• 微调：一些代码重构。

1.0.2

2014年7月17日，开发时间：5分钟

• 新增：将 'disable_output' 和 'disable_google_fonts' 参数添加到配置中。

1.0.1

2014年7月17日，开发时间：1小时

• 修复：当使用序列化选项而不是 theme_mods 或单个选项时的问题。
• 修复：字段上的 output 参数的问题。
• 修复：其他小错误

1.0.0

2014年7月11日，开发时间：177小时

• 新增：添加了 PHPUnit 测试
• 新增：使用 wp_add_inline_style 添加自定义器样式
• 新增：重新构建了背景字段计算
• 新增：现在使用 Formstone 进行开关 & 切换
• 新增：添加了新的 API。有关文档，请参阅 https://github.com/aristath/kirki/wiki。
• 新增：最低 PHP 要求现在是 PHP 5.2
• 新增：添加了 Select2 字段类型。
• 新增：引入 Kirki::get_option() 方法来获取值。
• 新增：向输出添加 'media_query' 参数。
• 新增：从自定义器值获取 CSS 预处理器变量的能力。有关文档，请参阅 https://github.com/aristath/kirki/wiki/variables。
• 新增：现在支持所有输出使用 'units' 以支持 '!important'。
• 新增：使用新 API 创建面板 & 部分。
• 新增：向 Kirki 类添加 get_posts 方法。
• 新增：在样式选项中实现宽度参数。有关文档，请参阅 https://github.com/aristath/kirki/wiki/Styling-the-Customizer
• 新增：添加 'kirki/control_types' 过滤器
• 修复：在使用序列化选项时正确保存数据库中的值
• 修复：在添加类和函数之前检查它们是否存在（允许在主题中嵌入时具有更好的兼容性）
• 修复：PHP 警告和提示
• 修复：其他小错误
• 修复：现在在所有地方都一致地使用 option_type 而不是 options_type
• 修复：Kirki::get_option() 方法现在适用于所有字段，包括背景字段。
• 修复：避免在背景字段中颜色未定义时出错
• 修复：使用 WP_Filesystem 从 JSON 文件中获取 google fonts 数组
• 修复：单选按钮样式
• 修复：PHP 提示
• 修复：拼写错误
• 修复：正确清理 rgba 颜色
• 修复：正确清理数字
• 修复：确保所有变量在输出时都被转义
• 微调：简化 Colorlovers 集成。
• 微调：改进清理
• 微调：改进 Kirki_Styles_Customizer 类
• 微调：代码清理
• 微调：添加更多内联文档（很多）
• 微调：使用 active_callback 而不是自定义 JS 作为必需参数
• 微调：更新翻译文件
• 微调：在 Kirki_Color 类中改进颜色操作
• 微调：将次要类实例化移至 Kirki() 函数。
• 微调：设置 $kirki 全局变量
• 微调：弃用 Kirki_Config 类中的 getOrThrow 方法。
• 微调：将清理函数移至 Kirki_Sanitize 类。
• 微调：将 Kirki_Framework 重命名为 Kirki_Toolkit。
• 微调：将变量移至新 API
• 微调：简化 Kirki_Controls 类
• 微调：将 kirki/fields 和 kirki/controls 过滤器移至新 API
• 移除：从配置中移除 'stylesheet_id'。

0.8.4

2014 年 4 月 6 日，开发时间：0.5 小时

• 修复：颜色清理扭曲了颜色十六进制中的 0 个字符。
• 修复：正确清理 ColorAlpha 控制器
• 修复：在 Fields 类中清理更多属性
• 修复：从控件类中移除冗余的双重清理调用

0.8.3

2014 年 4 月 5 日，开发时间：28 小时

• 新功能：引入 Field 类
• 新功能：引入 Builder 类
• 微调：代码清理
• 新功能：添加使用 'option' 作为设置类型的可能性
• 修复：颜色计算类中的错误
• 微调：在 "Field" 类中清理一切
• 修复：可排序字段中的错误
• 修复：编辑器控制没有描述
• 新功能：添加颜色-alpha 控制器。要使用它，只需将 rgba 颜色设置为默认值。
• 微调：SCSS & CSS 改进
• 修复：没有定义字段时的各种 PHP 提示和警告
• 微调：更有效的颜色清理方法
• 微调：改进数字控件展示
• 微调：改进处理背景字段的方式
• 微调：复选框样式
• 新功能：允许使用 rgba 值作为背景颜色
• 修复：CSS 修复 - 激活部分的 :focus 颜色
• 新功能：向 ScriptRegistry 类添加静态 'prepare' 方法
• 修复：当 Kirki 在主题中嵌入时 URL 出现问题

0.8.2

2015 年 3 月 30 日，开发时间：5 分钟

• 修复：由于 strtolower()，自动加载器无法正确包含文件

0.8.1

2015 年 3 月 30 日，开发时间：30 分钟

• 修复：现在可以使用配置过滤器覆盖翻译字符串。

0.8.0

2015 年 3 月 30 日，开发时间：32 小时

• 改进：面向对象的重设计（感谢 @vpratfr）
• 新功能：添加调色板控制
• 新功能：添加编辑器控制（WYSIWYG - 使用 TinyMCE）
• 新功能：添加自定义控制（自由 HTML）
• 新功能：添加 Kirki_Colourlovers 类以使用颜色爱好者 API 中的调色板
• 新功能：添加 composer 文件（感谢 @vpratfr）
• 修复：设置 ID 错误
• 修复：RGBA 函数中的颜色计算不正确
• 微调：重构插件（感谢 @vpratfr）
• 新功能：添加了功能性的 kirki_get_option() 函数
• 微调：简化配置选项。
• 新功能：将 Kirki 转换为单例和外观（感谢 @vpratfr）
• 微调：完全重写自定义器样式
• 新增：使用SASS自定义定制器样式
• 调整：弃用group_title控件，改用新的自定义控件
• 调整：更改了复选框的CSS

0.7.1

2015年3月15日，开发时间：2小时

• 移除：移除0.7版本中引入的kirki_get_option函数，因为它尚未正确工作。
• 修复：当未定义控件默认值时，出现未定义索引通知
• 调整：logo_image现在注入一个img元素，而不是带有自定义背景的div
• 新增：在kirki配置中添加了description参数（替换了主题描述）

0.7

2015年3月14日，开发时间：10小时

• 修复：与googlefonts一起使用时，发生条件性的数组转换为字符串。（props @groucho75）
• 修复：背景不透明度影响背景图片的背景位置
• 修复：在google fonts上不应用font-weight
• 新增：添加了kirki_get_option( $setting );函数，它也可以获取默认值
• 调整：主要插件类的单例
• 修复：防止空的帮助工具提示
• 新增：添加了toggle控件
• 新增：添加了switch控件
• 修复：颜色控件没有重置为默认值
• 调整：现在通过jQuery加载工具提示
• 调整：将setting重命名为settings，以与WordPress核心保持一致
• 调整：将description重命名为help，将subtitle重命名为`description`，以与WordPress核心保持一致
• 调整：向后兼容性改进
• 新增：允许通过不包括默认值来隐藏背景控件元素
• 调整：性能改进
• 调整：当可用时，使用WordPress核心控件而不是自定义控件
• 调整：为使用“mode”参数的多个类型控件分离逻辑。这已被弃用，以完全分开的控制类型取代。

0.6.2

2015年3月2日，开发时间：3小时

• 修复：前端样式没有正确排队（props @dmgawel）
• 新增：允许每个控件定义多个输出样式，定义为一个数组数组。
• 修复：背景控件样式
• 修复：序列化可排序控件的默认值。现在您可以将默认值定义为数组。
• 修复：必需的脚本
• 修复：错误地将'_opacity'添加到许多控件中。已移除它并编写了一个迁移脚本。

0.6.1

2015年2月25日，开发时间：1小时

• 修复：可排序控件有JS冲突
• 修复：开关和切换未正确工作

0.6.0

2015年2月25日，开发时间：9小时

• 修复：工具提示现在正确工作
• 新增：添加了复选框开关
• 新增：添加了复选框切换
• 修复：生成的CSS没有正确合并和最小化
• 修复：重新结构化文件层次结构
• 修复：简化加载控件的方式
• 新增：仅在需要时加载控件类
• 新增：引入Kirki_Customize_Control类
• 修复：CSS调整
• 新增：可排序控件（创建一个与选择控件相同，但带有\'type\' => \'sortable\'）
• 修复：双输出CSS（props @agusmu）
• 新增：Google字体现在从json文件中解析。

0.5.1

2015年1月22日

• 修复：传输默认为刷新而不是postMessage
• 修复：未定义索引通知。

0.5

2015年1月21日

• 新增：自动输出通用控件的样式。
• 新增：自动输出样式+脚本用于字体（包括Google字体）
• 新增：背景控件的'output'参数现在是一个数组，以与其他控件保持一致。尽管如此，旧语法仍然兼容。 :)
• 新增：添加自动生成颜色样式的功能。
• 修复：如果需要且配置选项中没有定义stylesheet_id，则添加一个空样式表。
• 修复：纯CSS工具提示。修复了在WP >= 4.1中工具提示现在显示的问题
• 修复：代码清理
• 新增：支持WordPress的传输参数
• 修复：所有控件现在都有一个净化回调函数。用户可以通过添加自己的'sanitize_callback'参数来覆盖默认的净化。
• 修复：面向对象的重写
• 修复：从Google API链接中删除协议
• 修复：某些文件的加载顺序
• 修复：移除了过时的less_var参数

0.4

2014年10月25日

• 修复：选择器bug修复
• 新增：根据选定的管理主题更改Kirki主题。
• 修复：翻译域问题
• 新增：添加了"group_title"控件
• 修复：更新了必需的脚本
• 修复：更新CSS
• 其他小改进和bug修复

0.3

2014年5月26日

• 新增：添加了背景字段
• 新增：添加了'output'参数，可以直接输出CSS

0.2

2014年5月9日

• 初始版本