通过 
搜索
搜索karl456 / craft4-section-field
允许选择Craft节区的字段类型。
4.0.0
2022-06-20 13:59 UTC
Requires
- craftcms/cms: ^4.0.0
This package is auto-updated.
Last update: 2024-09-20 19:09:35 UTC
README
此插件提供了一个用于选择节区的字段类型。这允许内容管理员从可用的单个、频道和结构中选择。使用此字段的项目可以在其模板中访问这些选择。
要求
- Craft CMS 4.0.0 或更高版本
安装
- 打开终端并导航到您的项目文件夹
cd /path/to/project
- 需要该软件包，请通过Composer下载
composer require karl456/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 %}