README

如何创建新的 Carbon Field 的分步指南。

简介

Carbon Fields 库包含许多内置字段，但您可能需要根据特定项目需求定义新的字段类型。

以下教程将解释如何创建自定义的 Carbon Field。

为了使过程尽可能简单，我们已准备了一个包含 PHP Carbon Field 类框架和 webpack 构建过程的 Carbon Field 模板。

模板结构

在所有文件中将 YOURFIELDNAME 和 yourfieldname（区分大小写）占位符替换。同时重命名包含占位符的文件。

注意！ 如果您的字段名包含多个单词，例如图片库，您的类名应如下所示

执行 yarn start 在开发过程中持续构建包。注意，您应该将 define( 'SCRIPT_DEBUG', true ); 添加到您的 wp-config.php 文件中，以便加载由开发构建过程生成的文件。

以下是您可以自定义的一些方法概述

to_json()

您可以使用此方法修改传递给代表字段的 React 组件的字段属性。

field_type_activated

用于调用一次每个字段类型（例如设置本地化文件）的初始化过程。

admin_enqueue_scripts()

用于添加 CSS/JavaScript 文件。

admin_init()

当字段初始化时为每个字段实例调用。（后端）

init()

当字段初始化时为每个字段实例调用。（后端、前端）