README

此模块提供了一种使用 Craft 的自 $element->attachBehavior() 方法将行为附加到您的元素的方式。它为所有提到的元素和插件提供基本转换，元素 API 的抽象层和一些辅助方法。

可用的基本行为

• BaseAssetBehavior
• BaseCategoryBehavior
• BaseEntryBehavior
• BaseGlobalSetBehavior
• BaseMatrixBlockBehavior
• BaseNeoBlockBehavior¹
• BaseProductBehavior²
• BaseSupertableBlockBehavior³
• BaseTagBehavior
• BaseUserBehavior
• BaseVariantBehavior²

其他可用的行为

必须安装相应的插件才能附加这些行为。

• 自由表单
• 导航（verbb）
• Linkit

¹ 必须安装 Neo 插件 ² 必须安装 Craft Commerce 插件 ³ 必须安装 Supertable 插件

安装

要安装此模块，请按照以下步骤操作

• 进入您项目的目录
• 运行 `composer require unionco\headless`

要扩展此模块

• 在您的 Craft 应用程序中创建一个使用 union\\api 命名空间的自定义模块
• 行为将位于 behaviors\\[element]\\[property]Behavior.php;
  • 条目瀑布顺序
    • [EntryTypeHandle]Behavior.php
    • [SectionHandle]Behavior.php
    • BaseEntryBehavior.php
  • 类别和标签基于它们的组句柄
  • 用户和资产目前仅支持基本级别的行为
  • 矩阵块结构（对 fieldHandle 进行 strtolower）
    • behaviors\\matrixblocks\\[fieldHandle]\\[blockTypeHandle]Behavior.php
    • 示例：behaviors\\matrixblocks\\mediagallery\\ImageTypeBehavior.php
    • 基础：behaviors\\matrixblocks\\BaseMatrixBlockBehavior.php
  • Neo 结构（对 fieldHandle 进行 strtolower）
    • behaviors\\neo\\[fieldHandle]\\[blockTypeHandle]Behavior.php
    • 示例：behaviors\\neo\\mediagallery\\ImageTypeBehavior.php
    • 基础：behaviors\\neo\\BaseNeoBlockBehavior.php
  • 产品和变体都基于产品类型句柄

路由器

TODO

特性

TODO

辅助函数

TODO