README

Customize Plus

增强并扩展您主题中的WordPress自定义功能。

贡献者: knitkode, kuus
标签: wordpress, customizer, options framework, theme
至少需要 4.9.4
测试到 4.9.4
稳定标签 1.1.1
许可: GPLv3+
需要PHP 5.2.4
捐赠链接: https://liberapay.com/knitkode/donate

描述

Customize Plus 将强大的自定义控件完全集成到WordPress自定义中。代码、管理UI和API完全类似于WordPress，应该如此。Customize Plus 扩展WordPress API，利用JavaScript API创建所有所需的控件。所有由Customize Plus控件管理的 theme_mods 或 options 都会自动验证和清理。您甚至不需要在检索时定义回退值。最终用户也将从该插件中受益，例如，他们可以将每个控件的控制值单独重置到初始会话或出厂值。这些以及其他许多功能都在 Customize Plus Premium 中扩展，不仅丰富了开发者的自定义体验，也丰富了用户的自定义体验。开发者还将发现插件 Customize Plus Builder 非常有用，可以进一步提高他们的开发体验。

链接

• 项目页面
• 文档
• 开发 和 问题 在 github
• 演示

此插件的功能是什么？

改善主题开发者和其用户的WordPress自定义体验。注意，如果没有积极实现Customize Plus的主题，最终用户将不会有任何好处。

此插件适合谁？

任何对使用WordPress自定义界面感兴趣的人。特别是那些希望为用户提供丰富自定义体验的主题开发者。

我能看到快速演示吗？

是的，您可以尝试始终更新的 官方演示主题。

功能

• 最先进的自动清理和验证（服务器和前端）
• 控件可以单独重置
• 通过 get_theme_mod 或 get_option 获取设置时的自动默认值
• 控件轻量级且响应式
• 控件按需渲染（实验性选项）
• 控件标题和描述支持Markdown
• 选择框提示信息中的可选帮助文本
• UI无缝集成WordPress
• 代码整洁且可通过kkcp API进行扩展
• 已实现自定义控件
  1. 文本 / 电子邮件 / 网址 / 电话 / 密码
  2. 多行文本框 / WordPress编辑器
  3. 数字
  4. 开关 / 切换 / 复选框
  5. 单选框 / 单选图片 / 按钮组
  6. 多选框 / 可排序多选框
  7. 滑块
  8. 颜色 / 透明度 / 调色板 / 透明
  9. 字体家族 / 字体粗细
  10. 选择框 / 下拉列表 / 多选下拉列表 / 可排序多选下拉列表
  11. 可排序
  12. 标签 / 可排序标签
  13. 图标 / dashicons
  14. 内容 / markdown / 警告框
  15. WordPress原生控件*
  16. 动态颜色 (高级版)
  17. 动态大小 (高级版)
  18. 日期选择器 (高级版)
  19. 旋钮 (高级版)
• 即将推出：请查看路线图

安装

安装

只需安装此插件并按标准方式激活。如果您从未这样做过

1. 从您的WordPress管理仪表板转到：插件 > 添加新插件
2. 搜索“Customize Plus”
3. 找到KnitKode的“Customize Plus”插件，并点击“立即安装”按钮。
4. 激活标记为“Customize Plus”的插件。
5. 有关详细设置说明，请访问官方文档页面。

将所有文件解压到/wp-content/plugins/loco-translate目录中。登录WordPress管理后台，通过“插件”菜单激活“Loco Translate”插件。转到左侧菜单中的“Loco Translate > 首页”开始翻译

主题集成

请在此处查看文档。用于简化此任务的工具是Customize Plus Builder，您可以在此处尝试。

翻译

• 英语 - 默认
• 欢迎贡献

注意：此插件已本地化并准备好翻译。您可以帮助将此项目翻译成不同语言。

常见问题解答

在哪里可以找到完整的文档？

文档可以在knitkode.com/docs/customize-plus找到

我如何获得帮助？

帮助仅通过插件支持论坛提供。请访问支持页面以查看其他选项。

我能看到快速演示吗？

是的，您可以尝试始终更新的 官方演示主题。

变更日志

1.1.1: 24/02/2017

• 错误修复
• 将控件模板移动到JavaScript控件类中
• 控件的类现在使用React准备的方法命名和生命周期样式
• 在$validity通知中支持警告

1.0.21: 22/02/2017

• 修复Base输入控件上的“跳舞字符”问题

1.0.21: 22/02/2017

• 修复单选图片控件缺少label->input链接

1.0.2: 22/02/2017

• 对控件行为的基本修复

1.0.0: 21/02/2017

• 第一个官方插件版本

0.0.9：2017年12月

• 第一个插件版本

升级通知

1.0.0

刚刚发布到野外的

鸣谢

除非另有说明，所有插件文件均根据GNU通用公共许可证版本3进行许可，请参阅文件license.txt。此许可证的例外情况如下*

• 由Faruk Ates、Paul Irish、Alex Sexton、Ryan Seddon、Patrick Kettner、Stu Cox、Richard Herrera编写的Modernizr，许可协议为MIT许可协议
• classList.js由Eli Grey编写，已捐献给公共领域
• css-toggle-switch由Ionuț Colceriu编写，许可协议为MIT许可协议
• jQuery-ui-Slider-Pips由Simon Goellner编写，许可协议为MIT许可协议
• locutus由Kevin van Zonneveld及贡献者编写，许可协议为MIT许可协议
• marked.js由Christopher Jeffrey编写，许可协议为MIT许可协议
• selectize.js由Brian Reavis编写，许可协议为Apache v2.0
• spectrum由Brian Grinstead编写，许可协议为MIT许可协议
• validator.js由Chris O'Hara编写，许可协议为MIT许可协议

所有包含在Customize Plus中的插件都采用与GPL兼容的许可协议，这是WordPress.org 插件指南所要求的