knucklepuck/carbon-field-radio-image-enhanced

Carbon Fields 扩展，添加了 Radio_Image_Enhanced 字段类型。

维护者

详细信息

github.com/Knucklepuck/carbon-field-radio-image-enhanced

主页

源代码

问题

安装: 34

依赖项: 0

建议者: 0

安全性: 0

星标: 0

关注者: 4

分支: 0

开放问题: 0

语言：JavaScript

3.1.2 2022-08-25 21:39 UTC

GPL-2.0+ bb9cfdde970a6b3daee8bf7665322813a12df8d3

wordpresscarbon-fieldcarbon-field-radio-image-enhanced

This package is auto-updated.

Last update: 2024-09-26 02:05:58 UTC

README

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

介绍

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

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

步骤 1：下载模板

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

您可以从这里下载模板：https://github.com/htmlburger/carbon-field-template

模板结构

  • /src - 字段文件文件夹
  • /languages - .po、.mo 和 .pot 文件文件夹
  • /core - 所有 .php 文件文件夹
  • /field.php - 引导 php 代码

步骤 2：命名您的字段

在所有文件中替换 Radio_Image_Enhanced 和 radio_image_enhanced (区分大小写) 占位符。同时重命名包含占位符的文件。

注意！ 如果您的字段名包含多个单词，例如 Image Gallery，则类名应如下所示

  • PHP 类： Image_Gallery_Field
  • 字段组件注册： image_gallery (参考 registerFieldType@/src/index.js)

步骤 3：构建资源

  1. 执行 composer dump-autoload 以创建所需的 autoload.php，该文件需要包含在您的主题中。
  2. 在根目录中执行 yarn install 以安装所有构建过程需求。
  3. 执行 yarn build 以构建最终的最小化包
可选

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

步骤 4：自定义

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

PHP

to_json()

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

field_type_activated

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

admin_enqueue_scripts()

用于添加 CSS/JavaScript 文件。

admin_init()

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

init()

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