README

注意

虽然我们承认Redux过去可以嵌入主题或插件中，但我们不再支持这种做法。太多开发者没有及时更新他们的Redux代码（这可以通过Composer轻松完成）。当项目的用户遇到问题时，他们会向我们寻求支持，而我们无法提供帮助，除非建议他们联系项目作者（您）并要求您更新供应商代码。这会让您的用户处于中间位置，我们更愿意不再这样做。

因此，针对ace_editor的供应商支持插件/扩展已被停止。ACE编辑器将仅通过CDN加载。如果您的项目需要本地安装ACE编辑器JavaScript（大小相当大），请将其包含在您的项目中，并使用redux/<opt_name>/fields/ace/script过滤器指定该脚本的URL。该ace_editor字段将使用该URL来排队ACE库。

感谢您对此事的关注。

4.4版本新增

• 内容字段
• 颜色方案扩展。
• 标签页扩展。
• 分类元框！
• 用户配置文件元框！
• 图标选择扩展。
• Extendify模板和模式库已从Redux中拆分。要继续使用Extendify，请从WordPress.org存储库下载独立的插件：https://wordpresstheme.cn/plugins/extendify

4.3版本新增

• 元框！
• 重复扩展！
• 社交媒体配置文件扩展！
• 自定义字体扩展！
• 多媒体扩展。
• 日期时间扩展。
• JS按钮扩展。
• 谷歌地图扩展
• 小工具区域扩展（仅适用于经典小工具）。
• 古腾堡模板库已更新到新的Extendify库。有关此升级和如何访问旧版库的更多信息，请参阅此处：https://redux.io/gutenberg-template-library-upgrade。

4.2版本新增

请参阅示例文件夹以查看新改进的字段示例。

• 附加的排版功能：顶部和底部边距，文字阴影。
• 新的媒体图片过滤器（灰度，棕褐色，不透明度，对比度，反转，模糊，饱和度，亮度，色调旋转）。
• 新的渐变字段过滤器（类型，范围，角度），包括自动生成的CSS输出。
• 新的阴影字段，包括自动生成的CSS输出。
• 新的飞出子菜单：flyout_submenus全局参数。
• 颜色字段的新Alpha颜色选项：color_alpha字段参数用于支持颜色选择器的字段。
• 已删除：async_typography全局参数。Google不再支持它。使用font_display与以下之一：auto|block|swap|fallback|optional。请参阅：https://mdn.org.cn/en-US/docs/Web/CSS/@font-face/font-display
• 即使没有Pro订阅，也能自动更新Google字体。

加入我们的Slack

Redux Slack

在社交媒体上关注我们！

变更日志

请参阅Changelog.md

文档

需要一点关于 Redux 的帮助吗？来了解一下我们全新的文档网站吧，网址是 devs.redux.io，这里充满了教程和示例！

帮助我们翻译 Redux

请转到插件页面，了解您如何帮助我们快速翻译 Redux。任何翻译都受欢迎。我们感谢您的帮助！https://translate.wordpress.org/projects/wp-plugins/redux-framework/

功能

• 使用 WordPress 设置 API
• 多种内置字段类型
• 多种布局字段类型
• 可以通过回调函数为自定义字段类型重载字段
• 通过创建字段类轻松扩展
• 内置验证类
• 通过创建验证类轻松扩展
• 自定义验证错误处理，包括每个部分的错误计数，以及错误字段的自定义样式
• 自定义验证警告处理，包括每个部分的警告计数，以及警告字段的自定义样式
• 多个自定义钩子点
• 导入/导出功能——包括跨站设置导入
• 通过类轻松添加页面帮助
• 完全响应式选项面板
• 更多功能

版本 4 的新功能是什么？

核心重构

我们的代码库已经从头开始重建。通过模块化代码、自动加载和类继承，Redux 现在比以往任何时候都要快和高效！

顶级安全！

Redux 符合 WordPress 编码标准、WordPress VIP 标准和 ThemeForest 指南中规定的安全标准。重点包括转义、清理、验证非ces和数据库查询准备/缓存。

自动 Google Font 更新。

这是 Redux v4 的一个亮点！您的用户将能够根据更新的可用性或自动的“幕后”更新来更新 Google Fonts。不再需要等待更新，也不需要 API 密钥！

字段清理

字段清理允许您将函数名称的数组作为参数传递给一个字段，其返回值将是清理字符串。此功能仅适用于基于文本的字段，包括文本、文本区域和 multi_text（不包括 ACE 编辑器和 WP 编辑器）。

可以使用任何现有函数，包括 PHP 函数、WordPress 函数和自定义编写的函数。任何使用的函数的返回值必须是字符串。任何其他返回值将被忽略。

请查看 sample-config.php 文件以获取具体示例。

Select2 AJAX 加载

select2 字段的 AJAX 加载例程已修复/完成。请查看演示面板中的 'capabilities' 字段以获取示例。

在此期间，此功能仅在使用 data 参数（即获取 WordPress 数据的那个参数）时才会工作。

要设置 AJAX 加载，请将 'ajax' => true 参数添加到您的选择字段中。也可以添加 min_input_length 参数以指定在显示结果之前应键入多少个字符。默认值是 1。

字段/部分禁用

多年来，这一功能被多次要求。现在可以通过在部分或字段中添加 'disabled' => true 参数来禁用字段和部分。然后部分或字段将显示为“灰色”，并且不会响应用户输入。这在提供产品高级版本预告片时很有用。

由于稍微懂一些CSS的人可以很容易地使用CSS重新激活禁用字段，我们采取了额外的预防措施，让Redux移除禁用字段/部分的任何name属性。这样，即使一个聪明的用户重新激活了该字段，它也永远不会保存。

更新后的面板界面

选项面板界面已经更新，以符合当前的WordPress管理员设计。现在它也“主题感知”。面板颜色将遵循所选管理员主题。

改进的字段验证

由于需要多个字段验证，Redux现在支持一个验证数组，而不是之前限制的单个参数。验证结果现在在保存后实时显示，无需刷新页面。

完全向后兼容v3

我们非常重视向后兼容性，并努力保持它。Redux v4的设计是为了作为一个即插即用的替代品，提供新功能而不破坏现有功能。

常见问题解答

1. 为什么我们应该使用require_once而不是get_template_part？

• 首先，因为get_template_part是用来...没错，就是主题！Redux旨在与主题和插件一起使用。
• 其次，阅读这篇文章。

1. 为什么我们不应该编辑插件目录中的sample-config.php？

• 因为每次更新插件时都会替换sample-config.php。你将丢失所有的工作。