charliedev/section-field

此包已被废弃且不再维护。未建议替代包。

允许选择Craft区段的字段类型。

1.1.0 2018-08-02 16:03 UTC

This package is auto-updated.

Last update: 2020-02-19 17:10:48 UTC


README

此插件提供了一种选择区段的字段类型。这使得内容管理员可以从可用的单页、频道和结构中选择。使用此字段的条目可以在它们的模板中访问这些选择。

需求

  • Craft CMS 3.0.0-RC1 或更高版本

安装

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

--- 或 ---

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

用法

创建区段字段

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

编辑区段字段

区段字段的表单控件是根据该单个字段的配置生成的。一个字段配置了一个允许使用的区段白名单,而条目上的区段是白名单和当前用户被允许编辑的区段的组合。

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

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

使用区段字段进行模板化

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

请参见下面的示例,其中 mySectionField 是一个确定要显示条目的区段(s)的字段。

{% set sections = entry.mySectionField %}

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

{% for sectionEntry in sectionEntries %}

	{# Display sectionEntry #}

{% endfor %}

Craft CMSCharlie Development 构建