README

贡献者： jtsternberg, webdevstudios, zao, humanmade
主页： https://cmb2.io
标签： 元框，表单，字段，选项，设置
最低要求 3.8.0
需要 PHP 7.4
测试到 6.4
稳定标签 2.11.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附加帖子字段，由coreymcollins开发：custom_attached_posts，用于将帖子附加到页面。

• CMB2字段类型：Post Search Ajax，由alexis-magina开发：post_search_ajax 将帖子相互关联。与CMB2附加帖子字段类似，但使用Ajax请求，支持多选/单选选项，并具有不同的UI。

• CMB2字段类型：CMB2帖子搜索字段：post_search_text 添加一个帖子搜索对话框，用于搜索/附加其他帖子ID。

• CMB2字段类型：Ajax搜索，由rubengc开发：包含3个具有相同UI的字段，通过AJAX搜索（带有查询参数）用户、帖子类型和分类术语。

• CMB2字段类型：Google Maps，由mustardBees开发：自定义字段类型，用于Google Maps。

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

• CMB2字段类型：Leaflet Maps，由villeristi开发：自定义字段类型，用于Leaflet Maps。

• CMB2字段类型：Select2，由mustardBees开发：使用Select2脚本的自定义字段类型。

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

• CMB字段类型：Slider，由mattkrupnik开发：添加jQuery UI滑动字段。

• WDS CMB2日期范围字段，由dustyf（来自WebDevStudios）开发：添加日期范围字段。

• CMB2远程图像选择字段，由JayWood（来自WebDevStudios）开发：允许用户在文本字段中输入URL并选择单个图像用于帖子元数据。类似于Facebook的特色图像选择器。

• CMB字段类型：Sorter：此插件提供了基于Sorter脚本的两种CMB字段类型。

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

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

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

• CMB 字段类型：CMB2-radio-image：以单选按钮的形式显示图片。

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

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

• CMB2 字段类型：Order（由 rubengc 提供）：允许用户定义预定义选项的顺序。

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

• CMB2 字段类型：Ajax Search（由 rubengc 提供）：基于 CMB2 字段类型：Post Search Ajax，增加了附加帖子/用户/术语的功能，以及限制附加对象最大数量的功能。

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

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

• CMB2 字段 JS 控件（由 rubengc 提供）：显示类似于 WordPress 发布操作的任何字段（帖子/页面 post_status、可见性和 post_date 提交框字段）。

• CMB2 字段类型：Position（由 rubengc 提供）：CMB2 字段类型，用于设置 jQuery UI 位置值。

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

• CMB2 字段类型：Font Awesome（由 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 WooCommerce HPOS 订单：向新的 WooCommerce HPOS 订单页面添加自定义字段的能力。
• CMB2 管理员扩展：向 WordPress 管理员添加创建 CMB2 元框的用户界面。也位于 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 库添加的自定义元字段，添加了一种基于 JavaScript 的方法来重新计算 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. 大功告成。

查看 CHANGELOG

已知问题

• 并非所有字段都能很好地在可重复组中工作。