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.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字段类型：帖子搜索Ajax由alexis-magina提供：`post_search_ajax`，将帖子相互关联。与CMB2附加帖子字段类似，但使用Ajax请求，多选/单选选项，不同的UI。

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

• CMB2字段类型：Ajax搜索来自rubengc：使用AJAX（带有查询参数）搜索（用户、帖子类型和分类术语）的3个不同字段，UI相同。

• CMB2字段类型：Google地图来自mustardBees：自定义Google地图字段类型。

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

• CMB2字段类型：Leaflet地图来自villeristi：自定义Leaflet地图字段类型。

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

  1. `pw_select`字段的工作方式类似于默认的select字段。然而，它添加了类似于typeahead的搜索，允许您快速从大量列表中进行选择。
  2. `pw_multiselect`字段允许您使用类似于typeahead的搜索选择多个值。值可以拖放以重新排序。

• CMB字段类型：滑块来自mattkrupnik：添加jQuery UI滑块字段。

• WDS CMB2日期范围字段来自dustyf的WebDevStudios：添加日期范围字段。

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

• CMB字段类型：排序器：此插件基于Sorter脚本来提供两种CMB字段类型。

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

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

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

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

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

• CMB2 相关链接：允许用户通过重复字段组添加相关链接。字段输入由上述文档中的 CMB2 字段类型：CMB2 文章搜索字段 驱动，因此每个链接都可以通过点击搜索按钮用现有的 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 发布操作的任何字段（文章/页面 post_status、可见性和 post_date 提交框字段）。

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

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

• CMB2 字段类型：Font Awesome 由 serkanalgur 开发：此插件为 CMB2 添加了选择 Font Awesome 图标的字段类型。

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

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

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

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

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

• CMB2 字段类型：Link 由 scottsawyer 开发：创建带有一些属性的链接字段。非常适合为链接添加样式。

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

其他有用资源

• CMB2 WooCommerce HPOS Orders：向新的 WooCommerce HPOS 订单页面添加自定义字段的能力。
• CMB2 Admin Extension：向 WordPress 管理界面添加用于创建 CMB2 元小部件的 UI。也在 wordpress.org 上。
• WordPress Shortcode Button：使用 CMB2 字段生成用于短代码输入模态的字段。
• WDS-Simple-Page-Builder：使用当前活动主题中的现有模板部分来构建带有可重新排列元素的定制页面。使用 CMB2 构建。
• CMB2 示例主题：演示如何将 CMB2 包含到您的主题中，以及一些有趣的技巧和技巧。
• facetwp-cmb2：FacetWP 与 CMB2 的集成。
• CMB2-grid 来自 origgami：WordPress CMB2 库的网格系统，允许在管理界面中创建列以获得更好的布局。
• CMB2 Metatabs Options 来自 rogerlos：CMO 使得创建具有多个元框的选项页面变得容易——并可选地添加 WordPress 管理标签页。
• CMB2 Conditionals 来自 jcchavezs：允许开发者关联字段，使得一个字段的显示取决于另一个字段的值。
• CMB2 Metabox Code Generator 来自 willthemoor：跳过乏味部分。使用此生成器轻松创建功能齐全的 CMB2 元框。现在支持批量输入！
• Caldera Metaplate 由 CalderaWP：不仅限于 CMB2，但允许创建用于输出自定义字段的模板。
• Yoast CMB2 Field Analysis WP 插件 由 alexis-magina：此插件在更新页面内容时添加了一个基于 JavaScript 的方法来重新计算 Yoast SEO 的内容评分，特别是通过 CMB2 库添加的自定义元字段。
• 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

已知问题

• 并非所有字段都适用于可重复的组。