bluestormdesign/section-field

允许选择 Craft 部分的字段类型。

5.0.1 2024-04-25 16:03 UTC

This package is auto-updated.

Last update: 2024-09-25 17:18:11 UTC


README

此插件提供了一种字段类型,用于选择部分。这允许内容管理员从可用的单个、频道和结构中选择。使用此字段的条目可以在模板中访问这些选择。

要求

  • Craft CMS ^5.0

安装

  1. 打开终端并导航到您的项目文件夹
cd /path/to/project
  1. 通过 Composer 下载此软件包
composer require bluestormdesign/section-field
  1. 在 Craft 控制面板的“设置 -> 插件”页面上安装插件。

--- 或 ---

  1. 通过命令行安装插件
./craft install/plugin section-field

用法

创建部分字段

  1. 通过设置 -> 字段面板在 Craft 控制面板中创建一个新的字段。
  2. 选择 部分 作为字段类型。
  3. 允许的部分 下选择哪些部分将作为选项可用。
  4. 如有适用,选中 允许多个 复选框。
  5. 将新字段附加到部分。

编辑部分字段

部分字段的表单控件是根据该字段配置生成的。字段配置为使用允许部分的白名单,并且条目上的部分是白名单和当前用户允许编辑的部分的组合。

  • 如果只允许一个选择,该字段是一组单选按钮。如果该字段不是必需的,则提供了一个额外的“无”选项,默认选中。

  • 如果允许多个选择,该字段是一组复选框。如果该字段是必需的,则至少必须检查一个框。

使用部分字段进行模板化

在 Twig 模板中,您可以像检索其他字段类型的数据一样检索部分字段的数据。如果该字段配置为允许单个选择,它将以整数的形式提供部分 ID。如果该字段配置为允许多个选择,它将作为数组提供部分 ID。

请参阅下面的示例,其中 mySectionField 是一个部分字段,它确定要显示条目的哪些部分。

{% set sections = entry.mySectionField %}

{% set sectionEntries = craft.entries.sectionId(sections) %}

{% for sectionEntry in sectionEntries %}

	{# Display sectionEntry #}

{% endfor %}

Craft CMSCharlie Development 构建