bluestormdesign / section-field
允许选择 Craft 部分的字段类型。
5.0.1
2024-04-25 16:03 UTC
Requires
- craftcms/cms: ^5.0.0
This package is auto-updated.
Last update: 2024-09-25 17:18:11 UTC
README
此插件提供了一种字段类型,用于选择部分。这允许内容管理员从可用的单个、频道和结构中选择。使用此字段的条目可以在模板中访问这些选择。
要求
- Craft CMS ^5.0
安装
- 打开终端并导航到您的项目文件夹
cd /path/to/project
- 通过 Composer 下载此软件包
composer require bluestormdesign/section-field
- 在 Craft 控制面板的“设置 -> 插件”页面上安装插件。
--- 或 ---
- 通过命令行安装插件
./craft install/plugin section-field
用法
创建部分字段
- 通过设置 -> 字段面板在 Craft 控制面板中创建一个新的字段。
- 选择 部分 作为字段类型。
- 在 允许的部分 下选择哪些部分将作为选项可用。
- 如有适用,选中 允许多个 复选框。
- 将新字段附加到部分。
编辑部分字段
部分字段的表单控件是根据该字段配置生成的。字段配置为使用允许部分的白名单,并且条目上的部分是白名单和当前用户允许编辑的部分的组合。
-
如果只允许一个选择,该字段是一组单选按钮。如果该字段不是必需的,则提供了一个额外的“无”选项,默认选中。
-
如果允许多个选择,该字段是一组复选框。如果该字段是必需的,则至少必须检查一个框。
使用部分字段进行模板化
在 Twig 模板中,您可以像检索其他字段类型的数据一样检索部分字段的数据。如果该字段配置为允许单个选择,它将以整数的形式提供部分 ID。如果该字段配置为允许多个选择,它将作为数组提供部分 ID。
请参阅下面的示例,其中 mySectionField 是一个部分字段,它确定要显示条目的哪些部分。
{% set sections = entry.mySectionField %}
{% set sectionEntries = craft.entries.sectionId(sections) %}
{% for sectionEntry in sectionEntries %}
{# Display sectionEntry #}
{% endfor %}
由 Craft CMS 的 Charlie Development 构建