README

OptionTree

WordPress 主题选项 UI 构建器。一种简单的方法来创建和保存免费或付费主题的主题选项和元框。

贡献者: valendesigns
标签: 选项, 主题选项, 元框, 设置
至少需要 3.8
测试到 5.2
稳定标签 2.7.3
许可证: GPLv2 或更高版本
捐赠链接: https://bit.ly/2TBvksV
需要 PHP 5.3.0

描述

OptionTree 通过创建与任何其他插件相比都易于使用的响应式选项面板和元框，试图弥合 WordPress 开发者、设计师和最终用户之间的差距。OptionTree 具有许多高级功能，包括放置良好的挂钩和过滤器，以调整用户体验的各个方面。

使用易于使用的拖放界面在本地构建您的主题选项面板，然后导出一个功能性的 theme-options.php 文件，用于生产使用，该文件已准备好进行 i18n 翻译，并自动插入自定义文本域。

此外，只需几行简单的代码，就可以将设置保存到数据库中，具有唯一的数组 ID，这样您的主题选项就不会与其他使用 OptionTree 的主题冲突。

此外，OptionTree 现在充分利用了 WordPress 3.8 中引入的新颜色方案，它看起来和感觉就像是内置的。

主题集成

如果您像我一样，您想知道一切是如何工作的。下载并激活 OptionTree 主题，亲自查看如何将 OptionTree 集成到您自己的项目中。我将带您安装 OptionTree，您将有机会亲眼看到所有不同的选项和过滤器，并在野外亲自体验。

贡献

要贡献或报告错误，请访问 OptionTree Github 仓库。

赞助

OptionTree 是由 ThemeForest 部分赞助的项目，它是网络上最大的 WordPress 主题市场。

选项类型

这是 OptionTree 随附的所有可用选项类型的完整列表。

背景
边框
框阴影
分类复选框
分类选择
复选框
颜色选择器
颜色选择器透明度
CSS
自定义帖子类型复选框
自定义帖子类型选择
日期选择器
日期时间选择器
尺寸
相册
Google 字体
JavaScript
链接颜色
列表项
测量
数字滑块
开启/关闭
页面复选框
页面选择
帖子复选框
帖子选择
单选按钮
单选按钮图片
选择
侧边栏选择
滑块
社交链接
间距
标签页
标签复选框
标签选择
分类复选框
分类选择
文本
文本域
简单文本域
文本块
标题文本块
排版
上传

安装

插件模式

将 option-tree 上传到 /wp-content/plugins/ 目录
通过 WordPress 的 插件 菜单激活插件
点击 WordPress 管理侧边栏菜单中的 OptionTree->文档 链接以获取进一步设置的帮助。

主题模式

下载最新版本的 OptionTree 并解压 .zip 目录。
将 option-tree 目录放在主题根目录下。例如，服务器路径为 /wp-content/themes/theme-name/option-tree/。
您必须停用和/或删除 OptionTree 的插件版本。
将以下代码添加到您的 functions.php 文件开头。

/**
 * Required: set 'ot_theme_mode' filter to true.
 */
add_filter( 'ot_theme_mode', '__return_true' );

/**
 * Required: include OptionTree.
 */
require( trailingslashit( get_template_directory() ) . 'option-tree/ot-loader.php' );

有关所有 OptionTree UI 显示过滤器的列表，请参阅此插件 /assets/theme-mode/ 目录中的 demo-functions.php 文件。此文件是使用主题模式开发主题的起点。

常见问题解答

是否有我可以安装的演示主题？

当然有，我很高兴你问了。下载并激活 OptionTree 主题，并使用详细的说明和技巧亲自尝试设置 OptionTree。

我在激活插件时遇到错误或空白屏幕。这是怎么回事？

最可能的情况是您的主题已经以主题模式安装了 OptionTree。由于插件和主题版本不能同时激活（否则天空会掉下来），您的网站决定放弃。如果这不是您的问题，请提交支持请求，我们将一起解决这个问题。更新：从 OptionTree 2.4.0 开始，如果两个版本都是 2.4.0 或更高版本，则插件版本不会与主题模式版本冲突。

屏幕截图

变更日志

2.7.3

热修复 - 更新对象注入检查的正则表达式以包括 + 绕过和 PHP 序列化类。感谢 @erwanlr

2.7.2

热修复 - 扩展 unfiltered_html iframe 能力以支持额外的 style 属性。

2.7.1

热修复 - 修复无法重新声明 _sanitize_recursive() 的错误。感谢 @shramee
热修复 - 确保对具有 unfiltered_html 能力的用户支持 iframe 的 style 属性。
热修复 - 确保对具有 unfiltered_html 能力的用户支持 noscript。

2.7.0

需要 PHP 5.3+
修复所有 PHPCS 错误和警告。
修复了一个漏洞，如果有人有一个有效的 nonce，则可能会发生对象注入。
在保存和显示之前强制对所有设置进行清理和转义。
添加过滤器 ot_validate_setting_input_safe，它用于验证自定义设置类型的输入值。所有值都必须经过验证！
添加通知，让用户知道自定义设置类型没有正确验证保存的数据，并在保存之前对用户数据执行最佳清理。
修复了 Composer 自动加载问题，并确保只有在我们有访问 WordPress 的情况下才加载 OptionTree。感谢 @infomaniac50
修复了 PHP 7.2+ 中的过时 create_function 通知。感谢 @modesthatred
修复了通知“只能通过引用传递变量”。感谢 @SergeAx
将 wordpress-plugin 项目类型添加到 composer 文件中。感谢 @egifford
删除了翻译文件。
删除了过时的 XML 文件导入方法。
修复了 SQL 语法问题。感谢 @ryanlabelle
修复了元框单选按钮和复选框的样式问题。感谢 @ryanlabelle

2.6.0

修复了由 add_list_item 和 add_social_links Ajax 请求引起的反射型 XSS 漏洞。
修复了 Google Fonts URL，使其通过 W3 Validator。归功于 @BassemN。
修复 global_admin_css，使其仅在需要时排队。
修复 dynamic.css，以便子主题不会加载父主题中保存的样式。
添加过滤器 ot_recognized_post_format_meta_boxes 以支持额外的帖子格式元框。归功于 @BassemN。
添加动作 ot_do_settings_fields_before 和 ot_do_settings_fields_after。归功于 @BassemN 和 @valendesigns。
将文本域添加到插件文件中，以完全支持新的 translate.wordpress.org 语言包。
修复 PHP 7.0.0 中的通知问题。归功于 @Zackio。

2.5.5

热修复 - 允许保存某些选项类型的 0 值。通过 github 的贡献者 @BassemN。
热修复 - 当通过媒体管理器或自定义器上传时，阻止将媒体附加到 OptionTree 帖子类型。通过 github 的贡献者 @earnjam 和 @valendesigns。
热修复 - 添加过滤器 ot_load_dynamic_css，可以显式关闭该功能。
热修复 - 停止加载由其他主题创建的 dynamic.css。

2.5.4

热修复 - 支持 WordPress 4.2 术语拆分。
热修复 - 通过转义移除了 add_query_arg 的潜在 XSS 安全问题。
热修复 - 修复了 Visual Composer 间接销毁 OptionTree 元框值的问题。
热修复 - 修复了选择字段值不可见的问题。通过 github 的贡献者 @sabbirk15。

2.5.3

热修复 - 在 dynamic.css 中添加 inherit 回退到 border 选项类型。
热修复 - 在 dynamic.css 中添加 none 回退到 box-shadow 选项类型。
热修复 - 在 dynamic.css 中添加 inherit 回退到 colorpicker 选项类型。
热修复 - 在 dynamic.css 中添加 inherit 回退到 colorpicker-opacity 选项类型。
热修复 - 添加过滤器 ot_insert_css_with_markers_fallback 以过滤 dynamic.css 回退值。
热修复 - 添加过滤器 ot_type_radio_image_attributes 以过滤每个单选选择的图像属性。通过 github 的贡献者 @BassemN 和 @valendesigns。
热修复 - 重构 ot_insert_css_with_markers，以移除混淆的和不必要的 PHP 语句并修复空白。
热修复 - 修复了 ot_insert_css_with_markers 中的问题，其中 $option_type 变量未正确设置。
热修复 - 修复了多个 Google Fonts 选项类型导致“添加 Google 字体”按钮插入多个下拉列表的问题。

2.5.2

热修复 - 在 dynamic.css 中添加 inherit 回退到 link-color 选项类型。
热修复 - 移除由函数弃用引起的 $.browser.msie JS 错误。
热修复 - 将 hover 改为 mouseenter mouseleave 以停止 jQuery 迁移错误消息。
热修复 - 不要在 ot-google-fonts-css 排队中允许重复的 Google Fonts。
热修复 - 修复了 CSS 和 JavaScript 选项类型在选项卡内不启动的问题。
热修复 - 修复了移动端的元框选项卡样式。
热修复 - 将帖子格式 JS 分离，以便它不会干扰默认行为，并且仅在需要时加载。
热修复 - 向 List Item 选项类型添加 not-sortable 类将移除该选项的排序功能。

2.5.1

热修复 - 重构 Colorpicker Opacity 选项类型，使其保存 rgba 值而不是数组。
热修复 - 添加了在具有 ot-colorpicker-opacity 类的任何颜色选择器上设置透明度的能力。
热修复 - 当保存附件 ID 时，不要使用 esc_url_raw 过滤 Upload 选项类型。通过 github 的贡献者 @RistoNiinemets。
热修复 - 如果无法写入 dynamic.css 文件，向用户显示错误消息。贡献者通过github @johnh10 和 @valendesigns。
热修复 - 在主题切换时强制重建 ot_google_fonts 数组。
热修复 - 停止在 ot-cleanup-api.php 中使用 add_menu_page 时进行主题检查的烦扰。

2.5.0

添加了Google字体选项类型。贡献者通过github @maimairel 和 @valendesigns。
添加了边框选项类型。贡献者通过github @doitmax 和 @valendesigns。
添加了阴影选项类型。贡献者通过github @doitmax 和 @valendesigns。
添加了颜色选择器不透明度选项类型。贡献者通过github @doitmax 和 @valendesigns。
添加了尺寸选项类型。贡献者通过github @doitmax 和 @valendesigns。
添加了JavaScript选项类型。
添加了链接颜色选项类型。贡献者通过github @doitmax 和 @valendesigns。
添加了间距选项类型。贡献者通过github @doitmax 和 @valendesigns。
修复了颜色选择器在 change 或 clear 事件上无法解析条件的问题。
修复了移动设备上的颜色选择器样式问题。
当值无效时，在错误消息字符串中显示颜色选择器设置ID。
向数字滑块隐藏输入添加了 'on change' 触发器。贡献者通过github @cubell。
停止主题检查对在主题模式下使用 register_post_type() 函数的抱怨。
添加了清理外观的样式，以改善部分选项卡中包含的Font Awesome图标的显示。
修复了由WP Review插件创建的jQuery UI样式冲突。
将上传选项类型的清理函数从 sanitize_text_field 更改为 esc_url_raw。
添加了过滤器 ot_dequeue_jquery_ui_css_screen_ids 以按屏幕ID取消加载 jquery-ui-css。
添加了过滤器 ot_on_off_switch_on_value 以过滤开启按钮的值。贡献者通过github @BassemN 和 @valendesigns。
添加了过滤器 ot_on_off_switch_on_label 以过滤开启按钮的标签。贡献者通过github @BassemN 和 @valendesigns。
添加了过滤器 ot_on_off_switch_off_value 以过滤关闭按钮的值。贡献者通过github @BassemN 和 @valendesigns。
添加了过滤器 ot_on_off_switch_off_label 以过滤关闭按钮的标签。贡献者通过github @BassemN 和 @valendesigns。
添加了过滤器 ot_on_off_switch_width 以过滤开启/关闭开关的宽度。
添加了过滤器 ot_type_date_picker_readonly 以过滤readonly属性的添加。
添加了过滤器 ot_type_date_time_picker_readonly 以过滤readonly属性的添加。
添加了过滤器 ot_admin_menu_priority 以过滤 admin_menu 动作钩子的优先级。
添加了爱沙尼亚翻译。贡献者通过github @tjuris 和 @RistoNiinemets。
修复了在 theme-options.php 上的更改需要第二次页面加载的问题。
修复了清理脚本，它只在没有东西要清理时显示。不再显示菜单项！
更新演示文件，以包含最新的选项类型。
更改 ot_css_file_paths 保存的位置，以便更好地支持 dynamic.css 文件。
在多站点中更改默认的 dynamic.css 文件路径为 dynamic-{current-blog-id}.css。

2.4.6

热修复 - 添加了一个清理脚本，以合并孤立的媒体帖子并删除旧的和未使用的 wp_option_tree 表。
热修复 - 修复了 ot_get_media_post_ID() 永远无法设置 ot_media_post_ID 选项值的问题，因为它已经设置为空。导致 ot_create_media_post() 函数创建多个媒体帖子。

2.4.5

热修复 - 修复了 ot_get_media_post_ID() 将 ot_media_post_ID 选项值设置为 null 的问题。导致 ot_create_media_post() 函数创建多个媒体帖子。将在 2.5.0 中添加清理脚本。

2.4.4

热修复 - 修复了由简写条件引起的未定义索引问题。
热补丁 - 修复了Easy Digital Downloads插件创建的jQuery UI样式冲突。
热补丁 - 在背景图像中添加了占位符。由github @BassemN贡献。

2.4.3

热补丁 - WordPress 4.0兼容。
热补丁 - 修复了一个问题，即所有媒体都被附加到默认的OptionTree媒体帖子。
热补丁 - 删除了已弃用的screen_icon()函数。
热补丁 - 修复了ot_line_height_range_interval过滤器被误命名为ot_line_height_unit_type的问题。由github @youri--贡献。
热补丁 - 修复了在使用前端媒体上传器时与“Frontend Publishing Pro”冲突的问题。
热补丁 - 提高条件性能。由github @designst贡献。
热补丁 - 在列表项设置中添加自定义样式类。由github @designst贡献。
热补丁 - 在ot_get_media_post_ID()中检查post_title而不是post_name。由github @clifgriffin贡献。
热补丁 - 将ot_get_media_post_ID()的返回值存储在选项表中，作为ot_media_post_ID。
热补丁 - 为列表项选项添加填充，以反映与单个选项相同的UI。由github @valendesigns和@designst贡献。
热补丁 - 修复了一个导致社交链接选项类型无法正确导入的bug。

2.4.2

热补丁 - 修复了当背景选项类型中的background-size未定义时创建的PHP通知。
热补丁 - 修复了上传选项类型的问题，在附件ID模式下，其值没有存储。
热补丁 - 在文档中将load_template替换为require。
热补丁 - 添加了一个基于主题选项UI构建器中设置标签文本的设置ID自动填充。由github @valendesigns和@Ore4444贡献。
热补丁 - 添加了过滤器ot_override_forced_textarea_simple，允许将文本区域选项类型移动到DOM中，并在元框和列表项中不替换为文本区域简单选项类型。

2.4.1

热补丁 - 修复了与social-links相关的示例主题选项中的错误。
热补丁 - 修复了在主题模式下IIS和Linux之间的语言目录路径冲突。
热补丁 - 修复了一个样式问题，其中选择字段会溢出其父元素。
热补丁 - 修复了当测量选项类型没有保存值时创建的PHP通知。

2.4.0

添加了过滤器'ot_post_formats'，用于加载特定于帖子格式的元框。
添加了社交链接选项类型。
修复了由于同时激活插件和主题版本而导致的OptionTree冲突。由github @valendesigns和@bitcommit贡献。
添加了一个管理员通知，当UI构建器被自定义主题选项覆盖时。
允许通过将ot-upload-attachment-id添加到元素的class属性中，将上传选项类型存储为附件ID。由github @valendesigns和@krisarsov贡献。
修复了CSS选项类型在分割为标签内容的多标签框中不显示Ace编辑器的问题。
修复了缺失的选项类型翻译字符串。由github @RistoNiinemets贡献。
将mysql函数替换为wpdb等效函数。由github @joshlevinson贡献。
修复了contains条件字符串的搜索顺序。由github @designst贡献。
如果设置中定义了自定义字段类，则添加元框字段包装器类。由github @designst贡献。
添加了过滤器'ot_type_select_choices'，以动态更改选择项。由github @maimairel和@valendesigns贡献。
修复了添加了不必要的目录分隔符到load_theme_textdomain()的$path变量的bug。由github @PatrickDelancy和@valendesigns贡献。
修复了拖放事件后的元框单选按钮状态。由github @themovation和@valendesigns贡献。
修复了在列表项内条件不正确工作的问题。
修复了在使用元框中的标签时出现的最小高度问题。
添加了过滤器 ot_recognized_font_sizes，可以通过字段 ID 动态更改字体大小。
添加了过滤器 ot_recognized_letter_spacing，可以通过字段 ID 动态更改字母间距。
添加了过滤器 ot_recognized_line_heights，可以通过字段 ID 动态更改行高。
修复了元框中的列表项标签样式显示不正确的问题。
修复了WooCommerce插件会改变产品页面元框标签样式的问题。

2.3.4

热修复 - 修复了条件编号值被当作字符串处理而不是返回正确的布尔响应的问题。

2.3.3

热修复 - 修复了与使用反斜杠而不是正斜杠的Windows版本的子文件夹兼容性问题。贡献者通过github @primozcigler 和 @valendesigns。
热修复 - 修复了演示文件中缺失的文本域。贡献者通过github @jetonr。
热修复 - 添加了过滤器 ot_migrate_settings_id，以迁移使用 option_tree_settings 的主题，现在使用自定义设置 ID。
热修复 - 添加了过滤器 ot_migrate_options_id，以迁移使用 option_tree 的主题，现在使用自定义选项 ID。
热修复 - 添加了过滤器 ot_migrate_layouts_id，以迁移使用 option_tree_layouts 的主题，现在使用自定义布局 ID。

2.3.2

热修复 - 修复了 ot_create_media_post 函数创建多个 option-tree 帖子的问题。
热修复 - 将布局管理选项类型的图标更改为与编辑按钮区分开来。
热修复 - 抑制背景选项类型中 "Invalid argument supplied for foreach()" 的PHP警告。贡献者通过github @tomkwok。
热修复 - 添加了过滤器 ot_type_date_picker_date_format，以更改日期选择器选项类型的日期格式。
热修复 - 添加了过滤器 ot_type_date_time_picker_date_format，以更改日期时间选择器选项类型的日期格式。

2.3.1

热修复 - 修复了画廊选项类型的一个错误，该错误会在没有任何附加内容时显示媒体窗口中的附件。
热修复 - 添加了将画廊保存为短语的选项，通过在元素 class 属性中添加 ot-gallery-shortcode 实现。
热修复 - 修复了在点击“添加新”后直接点击时条件不会生效的问题。贡献者通过github @bitcommit。

2.3.0

添加了选项卡选项类型。
将Ace编辑器添加到CSS选项类型。贡献者通过github @imangm 和 @valendesigns。
添加了对WordPress 3.8颜色方案的支持。
添加了对RTL语言的支持。贡献者通过github @omid-khd 和 @valendesigns。
添加了在排序列表和脚本之前和之后执行的操作。
添加了日期选择器选项类型。贡献者通过github @jetonr 和 @valendesigns。
添加了日期时间选择器选项类型。贡献者通过github @jetonr 和 @valendesigns。
添加了过滤器 'ot_list_item_title_label'，以更改列表项所需标题字段的标签。
添加了过滤器 'ot_list_item_title_desc'，以更改列表项所需标题字段的描述。
添加了过滤器 'ot_options_id'，以将 'option_tree' 选项 ID 更改为唯一值。
添加了过滤器 'ot_settings_id'，以将 'option_tree_settings' 选项 ID 更改为唯一值。
添加了过滤器 'ot_layouts_id'，以将 'option_tree_layouts' 选项 ID 更改为唯一值。
添加了过滤器 'ot_header_logo_link'，以更改OptionTree头部中的标志链接。
添加了过滤器 'ot_header_version_text'，以更改OptionTree头部中的版本文本。
添加了操作 'ot_header_list'，以向OptionTree头部添加特定主题的额外列表项。
添加了过滤器 'ot_upload_text'，以更改 "Send to OptionTree" 文本。
除了添加到元素的类之外，还将CSS类字段值添加到父
。现在每个类都附加了-wrap。
添加了对Composer的支持。通过github @designst的贡献者。
添加了对将I18n文本域添加到导出的theme-options.php文件的支持。
修复了一个在使用ot_type_background_size_choices过滤器时导致UI无法显示的bug。
修复了一个导致画廊选项类型保存单个空格而不是null的bug。
修复了背景、测量和排版选项类型的返回值。如果没有将值保存到数组中，它们现在将返回null。
修复了一个当选择数组设置为空字符串时导致PHP警告的bug。
更新了文档，包括此readme.txt和一个新的与OptionTree平行的OptionTree主题。贡献者通过github @valendesigns。
添加了过滤器'ot_type_radio_image_src'，允许更改单选图像选项类型源URI。贡献者通过github @bitcommit。

2.2.3

热修复 - 允许空条件值。例如，field_id:is()或field_id:not()现在将是有效的语法。
热修复 - 修复了init_upload_fix JavaScript方法中的bug。
热修复 - 修复了url_exists JavaScript方法中的bug。代码将不再检查另一个域名上的URL是否存在。

2.2.2

热修复 - 添加了对大小写条件操作符的支持。
热修复 - 更新了内联代码的颜色和字体大小。
热修复 - 修复了IE过滤器的问题，并更新了开/关选项类型的样式。
热修复 - 添加了不透明度到单选图像，以提高区分度。贡献者通过github @jetonr。

2.2.1

热修复 - 修复了一个UI bug，该bug导致布局输入覆盖wp菜单。
热修复 - 将屏幕截图移动到WordPress SVN资产目录。

2.2.0

添加了画廊选项类型。
添加了开/关选项类型。
用默认的WP颜色选择器替换了旧的颜色选择器。
添加了WordPress 3.8的UI支持。贡献者通过github @AlxMedia和@valendesigns。
添加了对设置字段条件切换的支持。贡献者通过github @maimairel、@valendesigns、@doitmax和@imangm。
将OptionTree图像图标替换为字体版本。
将'background-size'添加到背景选项类型。
在显示没有标题的帖子时，为各种选项类型添加了回退文本。
添加了过滤器'ot_recognized_background_fields'，以显示/隐藏背景选项类型的字段。
添加了过滤器'ot_filter_description'，允许在显示之前过滤主题选项描述。
在主题模式下添加了子文件夹兼容性。贡献者通过github @doitmax和@valendesigns。
修复了在加载动态CSS文件时使用'home_url'导致的bug。
修复了一个问题，您不能将元框文本字段值保存为"0"。贡献者通过github @sparkdevelopment和@valendesigns。
修复了主题模式下损坏的本地化目录路径。贡献者通过github @youri--和@valendesigns。
修复了数值滑块的缺失自定义类。贡献者通过github @doitmax。
添加了过滤器'ot_type_category_checkbox_query'，允许您过滤分类复选框的get_categories()参数。
添加了过滤器'ot_type_category_select_query'，允许您过滤分类选择器的get_categories()参数。
添加了过滤器'ot_type_taxonomy_checkbox_query'，允许您过滤分类复选框的get_categories()参数。
添加了过滤器'ot_type_taxonomy_select_query'，允许您过滤分类选择器的get_categories()参数。
添加了'ot_echo_option'函数。贡献者通过github @joshlevinson。
添加了过滤器 'ot_theme_options_contextual_help'，允许您在主题选项页面上筛选上下文帮助。
添加了过滤器 'ot_theme_options_sections'，允许您在主题选项页面上筛选部分。贡献者通过github @joshlevinson。
添加了过滤器 'ot_theme_options_settings'，允许您在主题选项页面上筛选设置。贡献者通过github @joshlevinson。

2.1.4

热修复 - 修复了数字滑块在新添加的列表项内不工作的问题。
热修复 - 修复了数字滑块的回退值被设置为0，现在如果没有设置标准，它将成为最小值。
热修复 - 当导出 theme-options.php 时，允许在 std 和 choice 值中使用单引号。贡献者通过github @maimairel。
热修复 - 添加了额外的 Themecheck 绕过，用于必需的函数。贡献者通过github @maimairel。
热修复 - 修复了加载修订版时丢失帖子元信息的问题。贡献者通过github @live-mesh。
热修复 - 在选项类型中移除了模板查询。贡献者通过github @live-mesh。

2.1.3

热修复 - 将 OptionTree 加载在 'init' 动作上被证明是错误的，现在它在 'after_setup_theme' 上加载。
热修复 - 由于使用了错误的路径变量，布局没有被正确导入。

2.1.2

热修复 - 修复了一个JS错误，导致在列表项和滑块中上传不会打开媒体上传器，直到保存。
热修复 - 在 'init' 动作上加载 OptionTree，这允许在不处于主题模式下时 UI 过滤器能够正确工作。

2.1.1

热修复 - OT_SHOW_SETTINGS_EXPORT 常量被错误地设置为默认值 false。

2.1

添加了对 WordPress 3.6 的支持。
UI 进行了小但必要的更新，现在更符合 WordPress。
为 Text、Textarea 和 Textarea Simple 选项类型以及列表项添加了 WPML 支持，即使在拖放后也支持。
上传现在使用 WordPress 3.5 中引入的媒体上传器。贡献者通过github @htvu、@maimairel 和 @valendesigns。
添加了一个横向数字滑块选项类型。贡献者通过github @maimairel 和 @valendesigns。
添加了一个侧边栏选择选项类型。贡献者通过github @maimairel。
移除了 PHP 中额外的废弃的返回值赋值。
修复了在 CPT 中缺少 "发送到 OptionTree" 按钮。贡献者通过github @jomaddim。
修复了使用 $count 而不是数组键来选择选项值的一些选项类型。
创建了用于注册主题选项和设置页面的函数，并具有更好的筛选功能。
为单选图象选择添加了相对路径支持。
在单选图象源路径中添加了对 'OT_URL' 和 'OT_THEME_URL' 的动态替换。
使 '0' 成为字段值。验证空字符串而不是空()。贡献者通过github @maimairel。
'ot_theme_options_capability' 过滤器现在为不同的权限如编辑器工作。
'ot_display_by_type' 过滤器现在被分配给一个值。
添加了过滤器 'ot_show_options_ui'，允许您隐藏主题选项 UI 构建器。
添加了过滤器 'ot_show_settings_import'，允许您在导入页面上隐藏设置导入选项。
添加了过滤器 'ot_show_settings_export'，允许您在导出页面上隐藏设置导出选项。
添加了过滤器 'ot_show_docs'，允许您隐藏文档。
添加了过滤器 'ot_use_theme_options'，允许您隐藏 OptionTree 主题选项页面（不推荐初学者使用）。
添加了过滤器 'ot_list_item_description'，允许您更改默认列表项描述文本。
添加了过滤器 'ot_type_custom_post_type_checkbox_query'，允许您筛选自定义帖子类型复选框的 get_posts() 参数。
添加了过滤器 'ot_type_custom_post_type_select_query'，允许您筛选自定义帖子类型选择框的 get_posts() 参数。
添加了过滤器 'ot_type_page_checkbox_query'，允许您筛选页面复选框的 get_posts() 参数。
添加了过滤器 'ot_type_page_select_query'，允许您筛选页面选择框的 get_posts() 参数。
添加了过滤器 'ot_type_post_checkbox_query'，允许您筛选帖子复选框的 get_posts() 参数。
添加了过滤器 'ot_type_post_select_query'，允许您过滤 Post Select 的 get_posts() 参数。

2.0.16

修复了一个紧急的 JS 回退错误，该错误导致上传选项类型损坏。代码由 @anonumus 通过 github 贡献。
将 'font-color' 添加到排版过滤器。

2.0.15

添加了对子主题模式的支持。
改进了手动设置时处理标准值的方法。
添加了 CSS 插入值的过滤器。
添加了 'ot_before_theme_options_save' 动作钩子。
修复了在没有上传的情况下关闭上传时出现的 'indexOf' JS 错误。
当选项类型为 'textarea'、'textarea-simple' 或 'css' 时，添加 textarea 标准值。
移除 load_template 并恢复为 include_once。
修复了 2.0.13 版本中 dynamic.css 的回退，导致文件无法保存。

2.0.14

移除了 PHP 中过时的返回值分配。
修复了使用 load_template 在主题检查更新后插件中使用的 PHP 通知回退的补丁。
修复了 OT_Loader::add_layout 中缺少必需参数的问题。
移除了字体家族检查中的 esc_attr()。
在 ot-ui-theme-options.php 中添加了 'ot_theme_options_parent_slug' 过滤器。
修复了使用 wp_get_remote() 而不是 file_get_contents() 导致的 WP_Error。

2.0.13

在 'ot_theme_mode' 时移除了几乎所有主题检查警告信息。
修复了某些服务器上媒体上传停止工作的问题。

2.0.12

添加了构建主题选项 UI 的数组中额外的过滤器。
使 Option-Tree 帖子类型为私有。
在 ot-ui-admin.php 中将权限恢复为 manage_options。
上传现在将选定的图像尺寸的 URL 发送到 OptionTree。
添加了字体大小、字母间距和行高的新范围间隔过滤器。
允许通过过滤器过滤掉 UI 中的 Typography 字段。

2.0.11

添加了构建主题选项 UI 的数组中的过滤器。
添加了 .format-setting-wrap div，以允许更复杂的 CSS 布局。
为 Colorpicker 选项类型添加了更好的命名空间。
修复了 theme-options.php 导出时添加额外逗号的问题。

2.0.10

修复了 Textarea 行数对于列表项不起作用的问题。
添加了对导出的 theme-options.php 文件的 apply_filter。
为选项卡和设置添加了 CSS id。
允许通过过滤器隐藏主题选项页上的“新布局”部分。
修复了 Colorpicker 在列表项中未正确关闭的问题。
将权限从 manage_options 更改为 edit_theme_options。
在列表项和元盒中移除 Textblock 标题。
修复了 Spark 提交的基于对象计数的不正确添加 ID 的列表项错误。
修复了插件和主题模式中不正确的文本域路径。
修复了 UI 可排序容器高度计算不正确的问题。
修复了 Select 下拉选择器错误 - 由 Manfred Haltner 提交。
修复了 Radio Image 移除类错误 - 由 designst 提交。
添加了新的 Typography 字段 - 由 darknailblue 提交。
为新的 Typography 字段添加了动态 CSS 支持。
为 Typography 字段添加了新的过滤器，包括低/高范围和单位类型。

2.0.9

修复了 Textarea Simple 和 CSS 选项类型神秘地通过 wpautop 运行的问题。
为 Textarea、Textarea Simple 和 CSS 选项类型添加了缺少的类设置。
修复了 theme-options.php 导出的数组中标签值不正确的问题。
将所有 AJAX 调用的 GET 改为 POST，以修复一些服务器不允许在 GET 变量中传递长字符串的 bug。
将 'ot_after_validate_setting' 过滤器添加到验证函数中。
在 ot_validate_setting() 中添加 $field_id 以实现更精确的过滤。
添加了 ot_reverse_wpautop() 函数，您可以通过它运行输入，以防万一您需要它。
更新了文档，包括为什么不允许在元框中使用 WYSIWYG 编辑器，以及它们将回退到 Textarea Simple 的信息。
更新 option-tree.pot 文件。

2.0.8

添加了向后兼容旧 1.x 文件的自动导入。
添加了将设置导出到一个完全功能的theme-options.php的能力。
修复了关于过滤器示例代码文档中的错误。
删除了章节和上下文帮助标题中的斜杠。
使颜色选择器输入字段的对齐更兼容多个浏览器。

2.0.7

修复了加载顺序，使其与认为get_option_tree()函数尚未存在的1.x版本主题兼容。
已测试与Cudazi主题兼容，但警告信息仍然可见。

2.0.6

在导入数据和布局时对'option_tree'数组进行验证。
修复了一个错误，即列表项和滑块不允许用户选择输入字段。
添加了一个过滤器，允许您在不使用它们的情况下不加载元框的资源。
更新 option-tree.pot 文件。

2.0.5

更改了'option_tree_settings'数组验证的方式。删除那些该死的斜杠！

2.0.4

在从1.0分支升级到2.0分支时对'option_tree'数组进行验证。
修复了滑块数组中的错误，由于错误的数组键，第一次保存textarea时未保存。

2.0.3

有一个不正确的条件语句导致插件尝试创建已创建的'option-tree'图像附件页面。
上述内容还解决了与'The Events Calendar'插件冲突的问题。

2.0.2

添加了I18n支持，翻译开始。option-tree.pot文件位于languages目录中。
删除了导入的选择数组中的空白。
修复了CSS插入函数没有保存值的错误。

2.0.1

导入表现在正确映射设置。

2.0

从头开始完全重写。
更好的主题选项UI构建器。
新增内嵌文档。
全新的响应式UI。
添加了新的选项类型，最值得注意的是列表项，它最终将取代滑块。
添加了更简单的ot_get_option()函数，最终将取代get_option_tree()。
添加了对元框的支持。
添加了主题模式，您现在可以直接在主题中包含插件。
对保存的数据进行了更好的验证。
简化了导入过程。
添加了对上下文帮助的支持。
永久将主题选项移动到外观选项卡。
添加了大量过滤器。
对代码库进行了巨大改进，并进行了严格的测试。

1.1.8.1

由于主题冲突，在WordPress管理区域中删除了get_option_tree()。
根据WordPress的要求，在资产文件夹中删除了示例文件。

1.1.8

修复了在非常高的页面上的滚动问题。
现在可以通过用户配置文件页面显示/隐藏设置和文档。
添加了背景选项类型。
添加了字体选项类型。
添加了CSS选项类型。
在1=是，2=否的选择中，'1'是值，'是'是选择中的文本，使选择看起来更好。
使AJAX消息的CSS更突出。
functions.load.php现在只有在查看OT管理页面时才会加载选项类型函数。
在查看OptionTree页面时注销了'Cispm Mail Contact'插件中的自定义jQuery UI。
现在可以从主题选项页面保存布局。
现在可以通过针对特定的"选项键"来更改滑块字段。
修改了上传，以便在手动输入相对路径的情况下使用。
允许在WP管理中使用get_option_tree()函数。
更改了权限为edit_theme_options。

1.1.7.1

重置functions.load.php，将在下一个版本中修复和更新。

1.1.7

添加了布局（主题变体）支持，具有保存/删除/激活/导入/导出功能。
允许在主题选项页面上更改布局。
通过手动添加xml MIME类型以导入选项，实现了完全的多站点兼容性。
用preg_match()替换eregi()以实现5.3+兼容性。
已更改资产目录中的测试数据以适应新的布局选项。
当滑块和上传图片改变时，它会在失焦时反映。
给滑块图片添加了一个上传按钮。
在退出前将do_action('option_tree_import_data')添加到option_tree_import_data()函数中。
在退出前将do_action('option_tree_array_save')添加到option_tree_array_save()函数中。
在退出前将do_action('option_tree_save_layout')添加到option_tree_save_layout()函数中。
在退出前将do_action('option_tree_delete_layout')添加到option_tree_delete_layout()函数中。
在退出前将do_action('option_tree_activate_layout')添加到option_tree_activate_layout()函数中。
在重定向前将do_action('option_tree_import_layout')添加到option_tree_import_layout()函数中。
在所有管理页面之前添加了do_action('option_tree_admin_header')钩子。
修复了用户可以添加没有哈希值的颜色的bug。
仅在主题选项页面上加载选项类型函数。
使用绝对路径加载资源，不再使用相对路径。
修复了上传器创建额外的option-tree草稿页面的bug。
修复了滑块切换bug，现在在打开另一个或创建新的幻灯片时滑块会关闭。

1.1.6

添加了主题集成。
使上传XML文件符合openbase_dir。

1.1.5

修复了多个滑块问题。

1.1.4

为get_option_tree() $is_array设置为false但仍返回数组的问题添加了补丁。

1.1.3

添加了带有可选字段过滤器的Slider选项类型。
修复了选项重置后显示的测量选项类型的文本。
为测量单位添加了过滤器。
在option_tree_array_save()函数中进行了代码清理。
修复了前端显示中的双引号。

1.1.2

修复了Textarea选项类型中的双引号。
为CSS值添加了测量选项类型。
修复了Post选项类型仅返回5个项的问题。
为大于10的复选框添加了滚动窗口。

1.1.1

修复了当没有上传内容时'删除'图标会显示的问题。

1.1

当WP_DEBUG设置为true时，修复了Undefined index: notices。

1.0.0

初始版本。

升级通知

2.7.0

所有自定义设置类型必须使用ot_validate_setting_input_safe过滤器来清理用户输入数据。OptionTree将尝试清理数据，但保存自定义设置类型时可能会发生数据丢失，因此请更新它们。此外，请在升级您的实时网站之前，在测试服务器上安装OptionTree或备份您的数据库。这个版本包含破坏性更改！

2.3.0

与每个主要版本一样，请在升级您的实时网站之前，在测试服务器上安装OptionTree。

2.1.4

如果您不是这个主题的开发者，请在升级之前要求他们测试与版本2.1的兼容性。如果您是开发者，我强烈建议您在受控环境中进行相同的测试。

2.0.16

上传选项类型的JavaScript存在问题，不允许将除图像之外的内容发送到编辑器。这个紧急问题现在已修复，这也是为什么这个版本改动较少的原因。

2.0.12

插件进行了完全的重构！如果您不是主题开发者，我强烈建议您在升级之前联系那个人并要求他们测试主题的兼容性。

1.1.8.1

由于主题冲突，在WordPress管理区域中删除了get_option_tree()。

1.1.8

添加了排版、背景和CSS选项类型。还有许多方法可以扩展它们。

1.1.7

添加了许多功能，没有一个是关键的，只是为了娱乐。添加了布局和上传到滑块。此外，开始包括用于扩展和与其他插件集成的动作钩子。

1.1.6

为开发者添加了主题集成。现在可以在主题中包含默认的XML文件来填充主题选项，并隐藏设置和文档页面。有关更多信息，请参阅插件内置文档。

1.1.5

多个滑块导致JavaScript中的命名冲突，现已修复。请尽快升级以在UI中获得多个滑块。

1.1.4

修复了当 $is_array 设置为 false 时，get_option_tree() 函数返回的值。如果您创建了任何滑动或测量选项类型，请阅读更新后的文档，了解如何在主题中使用它们的示例。

valendesigns / option-tree

维护者

详细信息

README

OptionTree

描述

主题集成

贡献

赞助

选项类型

安装

常见问题解答

是否有我可以安装的演示主题？

我在激活插件时遇到错误或空白屏幕。这是怎么回事？

屏幕截图

变更日志

2.7.3

2.7.2

2.7.1

2.7.0

2.6.0

2.5.5

2.5.4

2.5.3

2.5.2

2.5.1

2.5.0

2.4.6

2.4.5

2.4.4

2.4.3

2.4.2

2.4.1

2.4.0

2.3.4

2.3.3

2.3.2

2.3.1

2.3.0

2.2.3

2.2.2

2.2.1

2.2.0

2.1.4

2.1.3

2.1.2

2.1.1

2.1

2.0.16

2.0.15

2.0.14

2.0.13

2.0.12

2.0.11

2.0.10

2.0.9

2.0.8

2.0.7

2.0.6

2.0.5

2.0.4

2.0.3

2.0.2

2.0.1

2.0

1.1.8.1

1.1.8

1.1.7.1

1.1.7

1.1.6

1.1.5

1.1.4

1.1.3

1.1.2

1.1.1

1.1

1.0.0

升级通知

2.7.0

2.3.0