README

贡献者： jtsternberg, webdevstudios, zao, humanmade
主页： https://cmb2.io
标签：元盒、表单、字段、选项、设置
至少需要 3.8.0
测试到 5.0.3
稳定标签 2.6.0
许可协议：GPLv2 或更新版本
许可协议URI： https://gnu.ac.cn/licenses/gpl-2.0.html

完整的贡献者列表在这里找到： github.com/CMB2/CMB2/graphs/contributors

描述

CMB2 是一款用于构建 WordPress 元盒、自定义字段和表单的开发者工具包，它将使您感到惊讶。轻松管理文章、术语、用户、评论的元数据，或创建自定义选项页面。

在 wordpress.org 上下载插件

CMB2 是对 Custom Metaboxes and Fields for WordPress 的完全重写。要开始，请参考包含的 example-functions.php 文件中的示例，并查看 基本使用说明。

您可以在 这里 查看可用的字段类型列表。

如果您来自原始的 "Custom Metaboxes and Fields for WordPress" 插件，请阅读 这篇文章 了解 CMB2 的背景故事。

贡献

开发发生在 Github 上，欢迎所有贡献。请阅读 CONTRIBUTING 文档以获取更多详细信息。

所有优秀贡献者的完整列表在这里找到： github.com/CMB2/CMB2/graphs/contributors

特性

• 创建用于文章编辑屏幕的元盒。
• 创建用于选项页面的表单。.
• 创建用于处理用户元数据并在用户资料添加/编辑页面上显示的表单。
• 创建用于处理术语元数据并在您使用的任何分类法中显示的表单。
• 灵活的 API 允许您几乎在任何地方使用 CMB 表单，甚至在前端.
• 包括多种字段类型.
• 自定义 API 钩子，允许您创建自己的字段类型.
• 有大量的钩子和过滤器，允许您修改库的许多方面（而无需直接编辑它）。
• 大多数字段类型都支持可重复的字段，以及可重复的字段组。
• CMB2 可以安全地与任何项目捆绑。它将只加载系统中的最新版本。

翻译

如果您想提供语言翻译文件，请通过 WordPress 插件翻译 完成。

第三方资源

自定义字段类型

• CMB2 字段类型：CMB Attached Posts Field 来自 coreymcollins：custom_attached_posts，用于将文章附加到页面。

• CMB2 字段类型：Post Search Ajax 由 alexis-magina 提供：post_search_ajax 将帖子相互关联。与 CMB2 Attached Posts Field 相同的方法，但使用 Ajax 请求，多选/单选选项，以及不同的用户界面。

• CMB2 字段类型：CMB2 Post Search 字段：post_search_text 为搜索/关联其他帖子 ID 添加了一个搜索对话框。

• CMB2 字段类型：CMB2 User Search 字段 由 Mte90 提供：user_search_text 为搜索/关联其他用户 ID 添加了一个用户搜索对话框。

• CMB2 字段类型：Google Maps 由 mustardBees 提供：用于 Google Maps 的自定义字段类型。

  pw_map 字段存储纬度和经度值，您可以使用这些值在主题中显示地图。

• CMB2 字段类型：Leaflet Maps 由 villeristi 提供：用于 Leaflet 地图的自定义字段类型。

• CMB2 字段类型：Select2 由 mustardBees 提供：使用 Select2 脚本的自定义字段类型。

  1. pw_select 字段 的行为类似于默认的选择字段。然而，它添加了类似于自动完成风格的搜索，允许您快速从大量列表中进行选择。
  2. pw_multiselect 字段允许您使用类似于自动完成风格的搜索选择多个值。值可以拖放以重新排序。

• CMB 字段类型：Slider 由 mattkrupnik 提供：添加了一个 jQuery UI Slider 字段。

• WDS CMB2 Date Range Field 由 dustyf 的 WebDevStudios 提供：添加了一个日期范围字段。

• CMB2 Remote Image Select 由 JayWood 的 WebDevStudios 提供：允许用户在文本字段中输入 URL 并选择用于帖子元数据的单个图像。类似于 Facebook 的特色图像选择器。

• CMB 字段类型：Sorter：此插件根据 Sorter 脚本提供两种 CMB 字段类型。

• CMB 字段类型：Tags：CMB2 的类似 WordPress 标签的字段类型。注意：此选项不设置帖子标签，而只是提供一个唯一的文本输入

• CMB 字段类型：Link Picker：使用 CMB2 控件的 Link Picker，您可以从您的 WordPress 网站中选择链接或手动输入链接。您还可以标识链接是否应在新窗口中打开。

• CMB字段类型：MultidatesPicker：创建一个CMB2字段类型，它允许使用多日期日历。它使用一个名为MultiDatesPicker v1.6.3 for jQuery UI的插件。

• CMB字段类型：CMB2-radio-image：将图像作为单选按钮。

• CMB2术语选择：一种特殊的CMB2字段，允许用户为术语定义一个自动完成文本字段。注意：这将设置分类术语，但有一个选项（'apply_term' => false）可以禁用它并将术语ID作为数据保存（如选项页面等）。

• CMB2相关链接：允许用户通过重复字段组添加相关链接。字段输入由上述文档中的CMB2字段类型：CMB2 Post Search字段提供支持，因此可以通过点击搜索按钮将每个链接填充为现有WordPress内容。注意：这不是一个标准字段类型，而是一个与CMB2::add_field()结合使用的功能。

• CMB2字段类型：Order by rubengc：允许用户定义预定义选项的自定义顺序。

• CMB2字段类型：Animation by rubengc：允许用户从Animate.css中选择动画（包括所选动画的预览）。

• CMB2字段类型：Ajax Search by rubengc：基于CMB2字段类型：Post Search Ajax，添加了附加文章/用户/术语的能力，以及限制附加对象最大数量的能力。

• CMB2字段类型：Visual Style Editor by rubengc：CMB2的自定义字段，允许通过一组小控件自定义样式。

• CMB2字段类型：Content Wrap by rubengc：CMB2的自定义字段，用于存储内容包装值（填充、边距或边框宽度）。

• CMB2字段JS控件 by rubengc：显示任何类似于WordPress发布操作的字段（文章/页面提交状态、可见性和提交框字段）。

• CMB2字段类型：Position by rubengc：CMB2字段类型，用于设置jQuery UI位置值。

• CMB2字段类型：CMB2 Roadway Segments by pixelwatt：此插件添加了一个新的CMB2字段类型，用于在地图上绘制道路段，并提供了显示的短代码。

• CMB2字段类型：Font Awesome by serkanalgur：此插件添加了一个新的CMB2字段类型，用于选择Font Awesome图标。

• CMB2 字段类型：字体排印，由eduplessis开发：此插件添加了新的 CMB2 字段类型 "字体排印"，并使用 jQuery fontselect 进行字体选择。

• CMB2 字段类型：Markdown，由Rekenna开发：此插件添加了新的 CMB2 字段类型 "CMB2 Markdown"，您可以在其中输入 markdown 并实时预览结果，或通过按钮将其转换为 html。

• CMB2 字段类型：开关按钮，由themevan开发：此插件为 CMB2 添加了自定义开关按钮字段类型。

• CMB2 字段类型：select_plus，来自manzoorwanijk：选择字段类型，其功能类似于默认的 select 字段。然而，它增加了对 optgroup 的支持以及具有 multiple 属性的值的保存。

• CMB2 字段类型：地址，由scottsawyer开发：这是一个简单可重复的地址字段。它实际上只是将来自 CMB2 代码片段库 的代码片段转换为插件。

• CMB2 字段类型：链接，由scottsawyer开发：创建一个带有一些属性的链接字段。非常适合用于链接样式。

• CMB2 字段类型：小工具选择器，由scottsawyer开发：需要一个字段，让您（或您的编辑器）选择/显示现有的小工具实例？那么这个插件就是为您准备的。

其他有用资源

• CMB2 管理员扩展：在 WordPress 管理界面中添加创建 CMB2 元框的 UI。也位于 wordpress.org。
• WordPress 短代码按钮：使用 CMB2 字段生成短代码输入模态的字段。
• WDS-简单页面构建器：使用当前激活主题中现有的模板部分来构建一个可重新排列元素的定制页面。使用 CMB2 构建。
• CMB2 示例主题：演示如何将 CMB2 包含到您的主题中，以及一些酷炫的小技巧和窍门。
• facetwp-cmb2：FacetWP 与 CMB2 的集成。
• CMB2-grid，来自origgami：WordPress CMB2 库的网格系统，允许创建列以在管理界面中创建更好的布局。
• CMB2 元标签选项，来自rogerlos：CMO 使创建带有多个元框的选项页面变得容易，以及可选的 WordPress 管理标签。
• CMB2 Conditionals 来自 jcchavezs：允许开发者将字段关联起来，一个字段的显示取决于另一个字段的值。
• CMB2 Metabox Code Generator 来自 willthemoor：跳过无聊的部分。使用此生成器轻松创建完全功能的 CMB2 metabox，现在支持批量输入！
• Caldera Metaplate 由 CalderaWP：不仅限于 CMB2，但允许创建用于输出自定义字段的模板。
• Yoast CMB2 Field Analysis WP 插件 由 alexis-magina：此插件在更新页面内容时，通过 CMB2 库添加的自定义元字段，添加了一个基于 js 的方法来重新计算 Yoast SEO 的内容评分。
• Skeleton 由 awethemes：WordPress 的完整框架，使用 CMB2 引擎。
• WP Simple Iconfonts 由 awethemes：图标字体管理器，并为 CMB2 提供字体图标选择器。
• CMB2 Nav Menus 由 nsrosenqvist：允许您在导航菜单条目中使用 CMB2。

链接

• 项目主页
• Github 项目页面
• 文档（GitHub wiki）
• 代码片段库

安装

如果从 wordpress.org 安装插件

1. 将整个 /CMB2 目录上传到 /wp-content/plugins/ 目录。
2. 通过 WordPress 中的 '插件' 菜单激活 CMB2。
3. 将 example-functions.php（如果需要，可以重命名）复制到您的主题或插件的目录中。
4. 编辑以仅包含所需的字段并重命名函数。
5. 成功。

如果将库包含在您的插件或主题中

1. 将 CMB2 目录放置在您的主题或插件内部。
2. 将 example-functions.php（如果需要，可以重命名）复制到 CMB2 目录 上方 的文件夹中，或者将整个内容的全部复制到主题的 functions.php 文件中。
3. 编辑以仅包含所需的字段并重命名函数（为了方便更新库，CMB2 目录应保持未编辑状态）。
4. 成功。

查看 CHANEGLOG

已知问题

• 并非所有字段都适合在可重复的组中使用。