README

这是一个原始CMB2 WordPress插件的维护Fork。在这个Fork中，所有原始功能都将保持可用。

此Fork的目的

有时候拉取请求需要花费很长时间或永远不会得到批准。这个Fork已经将我提交的所有拉取请求合并并准备好使用。

增强功能（非详尽）

1. 重复字段的可拖拽排序。
2. 组的可拖拽排序。
3. 支持组标记中的自定义元素。
4. 从任何元框上下文中移除默认的分类法元框。
5. 修复 rest_value_cb 字段参数
6. 修复没有ID的自定义组
7. 支持在组内、Gutenberg、可排序和可重复的 textarea_code。

安装

composer require lipemat/cmb2

用法

require __DIR__ . '/vendor/autoload.php'

原始自述文件

贡献者： Mat Lipe，jtsternberg，webdevstudios，zao，humanmade 主页： https://cmb2.io 标签： 元框、表单、字段、选项、设置 需要至少： 3.8.0 测试至： 6.1 稳定标签： 2.10.1 许可证： 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字段类型：帖子搜索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 field 字段与默认选择字段类似。但是，它添加了类似于自动完成风格的搜索，允许您快速从大型列表中进行选择。
  2. pw_multiselect 字段允许您使用类似于自动完成风格的搜索选择多个值。值可以拖放以重新排序。

• 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 发布操作的任何字段（文章/页面发布状态、可见性和提交框字段）。

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

• CMB2 字段类型：CMB2 路段，作者：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 字段类型：开关按钮，作者：themevan：此插件为 CMB2 添加了一个自定义开关按钮字段类型。

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

• CMB2 字段类型：地址，作者：scottsawyer：只是一个简单的、可重复的地址字段。它实际上只是来自 CMB2 Snippet Library 的片段，已转换为插件。

• CMB2 字段类型：链接，作者：scottsawyer：创建具有一些属性的链接字段。非常适合链接样式。

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

其他有用的资源

• CMB2 管理员扩展：添加一个用户界面，从 WordPress 管理员创建 CMB2 元框。也位于 wordpress.org。
• WordPress 短代码按钮：使用 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：此插件在更新页面内容时，通过 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. 大功告成。

查看变更日志

已知问题

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