README

WordPress options builder class 是一个库，帮助你通过几行代码设置主题或插件选项，并将数据存储在数据库中。

在 5.0 版本中更新

• 更新 WordPress 编码标准
• 改进了 Composer 配置
• 添加了对 .editorconfig 标准 的支持
• 将密码字段类型的加密重写为使用 OpenSSL 而不是 mcrypt
• 移除了 Markdown 字段类型
• 重构库代码

由 CircleCI 保护构建：

目录

• 安装
• 升级到 5.x 版本
• 用法

安装

Composer 风格（推荐）

1. 通过在你的插件根目录的 composer.json 文件中创建或添加以下内容来包含你的插件

   {
     "require": {
       "WordPress-Phoenix/wordpress-options-builder-class": "^5.0.0"
     }
   }

2. 使用 which composer 确认你的开发环境中已安装 composer。
3. 在插件根目录中打开 CLI 并运行 composer install。
4. 确认它已在插件中创建了 vendor 文件夹。
5. 在你的插件主文件中，在包含其他文件的代码附近放置以下内容

   if ( file_exists( dirname( __FILE__ ) . 'vendor/autoload.php' ) ) {
     include_once dirname( __FILE__ ) . 'vendor/autoload.php';
   }

手动安装

1. 从 https://api.github.com/repos/WordPress-Phoenix/wordpress-options-builder-class/zipball 下载此存储库的最新副本
2. 解压缩 zip 文件，并将 PHP 文件复制到你的插件项目中。
3. 在插件中包含 src/class-wordpress-options-panels.php 文件。

升级到 5.x 版本

5.0 版本是 WordPress Phoenix 选项面板的重写，需要几个更新步骤。

• 如果不使用自动加载器，包含 src/class-wordpress-options-panels.php（而不是 wpop-init.php）
• 引用 \WPOP\V_5_0\* 命名空间而不是 \WPOP\V_4_1\*
• 如果你没有使用自动加载器，则手动将类文件加载到内存中

  \WPOP\V_5_0\WordPress_Options_Panels::load_files();

• Markdown 字段类型已被移除；请考虑切换到 include_partial 并通过你选择的 PHP 类渲染 Markdown（WordPress Phoenix 选项面板 4.x 使用了 erusev/parsedown）
• 更新你的 $args 数组以包含 new \WPOP\V_5_0\Page( $args, $fields );，并包含一个 installed_dir_uri 键和值，代表此库的公共 URL 路径（用于加载用于设计选项面板的 CSS 和 JS 资产）

用法

• 在描述面板、部分和部分架构的 Wiki 中 开始使用
• 在 WPOP 示例插件中 查看完整示例
• 使用 WordPress 开发工具包 和 Abstract Plugin Base 生成工作副本。