SuperAPI AI 工具集

drupal-fields

编程与开发

查看项目

更新于 10-16 02:22

技能介绍

Drupal Fields 是 Drupal AI 技能集中专门讲解 Drupal 字段(Fields)的技能,内容围绕字段的创建、管理、配置导出以及在代码中读取字段值展开。

用途 该技能用于指导在 Drupal 中处理字段相关任务,包括选择字段类型、控件与格式化器,通过 Drush 命令行创建字段,管理已有字段,以及在 PHP 代码中访问字段值。

主要能力

  1. 创建字段:技能强调始终使用 drush field:create 而不是手动创建字段配置文件。提供交互式创建方式(推荐首次使用)和非交互式创建方式,后者通过参数指定实体类型、字段名、字段标签、字段类型、控件、是否必填和基数(cardinality)。
  2. 字段类型示例:给出普通字符串字段、实体引用字段(entity_reference,目标类型为 taxonomy_term,基数 -1 表示多值)和图片字段(image)的创建命令示例。
  3. 管理字段:提供查看某内容类型全部字段(drush field:info node article)、删除字段(drush field:delete node.article.field_subtitle)以及发现可用字段类型、控件和格式化器(drush field:types、drush field:widgets、drush field:formatters)的命令。
  4. 配置导出:提示在通过 CLI 修改字段后,始终执行 drush config:export -y 导出配置。
  5. 自定义字段插件:提供生成字段类型、格式化器和控件插件的命令(drush generate plugin:field:type、drush generate plugin:field:formatter、drush generate plugin:field:widget)。
  6. 代码中访问字段值:展示读取单值字段($entity->get('field_name')->value)、实体引用字段($entity->get('field_ref')->entity)以及遍历多值字段(foreach ($entity->get('field_multi') as $item))的写法。

使用方式 该技能以 Drush 命令行为主要操作入口,先通过交互式或带参数的非交互式命令创建字段,再用 field:info、field:delete 等命令进行管理,用 field:types、field:widgets、field:formatters 查询可用选项,变更后导出配置。自定义字段类型通过 drush generate 生成插件骨架。字段值的读取则在 PHP 代码中通过实体对象的 get() 方法完成。

适用场景 适用于需要在 Drupal 站点中新增或管理字段、配置实体引用与图片字段、编写自定义字段插件,以及在模块或主题代码中读取字段值的开发场景。

限制 资料未提供该技能对 Drupal 版本的具体要求、权限或环境依赖,也未说明字段类型、控件与格式化器的完整清单,这些需通过 drush field:types 等命令自行查询。