ournameismud / sortelements
排序相关元素的字段
Requires
- craftcms/cms: ^4.0.0
This package is auto-updated.
Last update: 2024-09-27 18:15:40 UTC
README
排序已定义的相关元素的字段。
需求
此插件需要 Craft CMS 3.0.0-beta.23 或更高版本。
安装
要安装此插件,请按照以下说明操作。
-
打开您的终端并转到您的 Craft 项目
cd /path/to/project
-
然后让 Composer 加载插件
composer require ournameismud/sortelements
-
在控制面板中,转到设置 → 插件,并点击 Sort Elements 的“安装”按钮。
Sort Elements 概述
Sort Elements 创建了一个自定义字段,用于定义已建立关系的元素的自定义顺序。
配置 Sort Elements
配置在字段类型中进行,您只能指定此字段将用于排序的元素类型。
使用 Sort Elements
Sort Elements 创建了一个自定义字段,用于定义已建立关系的元素的自定义顺序。
例如,Pro Boilers™ 希望对其在产品频道中设置的产品进行分类。您设置了产品类别并将它们分配给单个产品条目,但完成此操作后,他们还希望对某些产品的显示顺序进行排序。
我们不希望设置两次这种关系,这就是插件发挥作用的地方。我们为我们的类别创建了一个字段类型,使我们能够排序已与其相关的元素(来自条目、类别、资产、标签或用户)。一旦我们添加了我们的字段,当编辑类别时,我们可以对它们进行排序,并且该字段将输出一个数组以供我们在前端模板中使用。
在 twig 中使用时,该字段将简单地输出一个 ID 数组。所以,在上面的例子中,我们可以像这样检索和排序我们的产品
{% set ids = category.boilerProducts %}
{% set entries = craft.entries({ id: ids, fixedOrder: true }) %}
需要 fixedOrder
属性来尊重数组中 ID 的顺序。默认情况下(例如,如果特定类别的排序顺序尚未保存),字段将返回 null
。在这种情况下,基于任何其他定义的属性(例如 section
或如果您想设置关系,例如 { relatedTo: category }
),将返回条目查询(或字段相关的任何其他元素)。
Sort Elements 路线图
一些待办事项和潜在功能的想法
- 考虑与元素保存一起更新,例如,如果与类别字段相关联的条目在类别中更新。
由 @cole007 提供,图标由 ProSymbols(来自 Noun Project)创建