为Craft插件增强Matrix字段,添加分组、标签等功能!

安装: 231

依赖项: 0

建议者: 0

安全: 0

星标: 0

关注者: 2

分支: 7

类型:craft-plugin

3.1.0 2018-09-04 12:03 UTC

This package is auto-updated.

Last update: 2024-09-20 22:07:23 UTC


README

增强Matrix字段,添加分组、标签等功能!

Icon

使用Spoon来分组Matrix块,隐藏块和/或字段,并使用标签来组织块布局。

Spoon不会触及你的内容,它只是在核心Matrix字段类型之上的一层,所以如果你不想使用它,只需选择蓝色药丸并卸载即可。

或者它是红色药丸。哪个是真正的幻觉?!

注意:此插件的许可费为59美元,通过Craft插件商店购买。

要求

此插件需要Craft CMS 3.0.15或更高版本。

安装

要安装此插件,请按照以下说明操作。

  1. 打开你的终端并转到你的Craft项目

     cd /path/to/project
    
  2. 然后告诉Composer加载插件

     composer require angellco/spoon
    
  3. 在控制面板中,转到设置→插件,并为Spoon点击“安装”按钮。

概述

将长列表的块组织成更小的组,以便更清晰地选择。

block type groups example

将字段组织到每个块类型上的标签组中。

block type field layouts example

仅使用一个Matrix字段,并根据条目类型、分类组等隐藏和显示块或字段。

group block types button

路线图

如果您想跟进此项目的进度,可以在GitHub项目中这样做。

支持

所有支持请求应通过GitHub问题提交,如果您需要更深入的帮助,请通过Craft Slack(@joshangell)或通过电子邮件联系我 - josh@angell.io

用法

Spoon的工作方式是通过允许你在多个上下文中创建你的块类型组和字段布局。

例如,你有一个很大的Matrix字段,它驱动了网站上大部分的内容,你希望它在控制面板的大部分地方都能以相同的方式工作,但通常有几个地方你需要对其进行微调。你可能需要一个额外的块类型来处理特定部分,或者在某些地方不显示某些字段,因为在那种上下文中它们不适用。

我们通过使用上下文来实现这一点。每次运行代码来操作你的Matrix字段的输出时,我们都会检查页面的上下文,以查看是否有针对该上下文的特定配置,如果没有,则回退到你可能设置的任何默认值。

以下是目前支持的上下文

  • 条目类型
  • 分类组
  • 全局集
  • 用户

您可以通过访问每个字段的字段布局设计器,点击任何活动Matrix字段的齿轮图标,并选择“分组块类型”来覆盖特定上下文的默认设置。

group block types button

设置默认值

要为所有Matrix字段创建默认的块类型组和字段布局,请转到设置→Spoon。在这里,您将找到当前所有Matrix字段的列表。

点击字段名称以启动块类型组编辑器。它看起来可能像这样

block type groups editor

现在您可以像为部分创建字段布局一样分组块类型

block type groups editor filled in

如果您省略了任何块类型,则它们将不会显示。

一旦您创建了一些组,您可以进一步自定义特定块的字段布局 - 只需单击齿轮图标并选择“编辑字段布局”。

block type field layout

就这样!现在您应该可以浏览到使用该字段的地方,并看到您的新组和字段布局的实际效果。

配置设置

Spoon支持插件设置的配置.php多环境友好配置文件。只需将config.php复制到Craft的config/目录中作为spoon.php,您就可以以多环境友好的方式配置设置。

  • nestedSettings - 将此设置为应使用嵌套设置菜单显示模式的Matrix字段处理数组

nested settings menu

Angell & Co提供

这个项目以前在Craft 2中以不同的名称存在,但出于明显的原因,我将其重命名。

非常感谢Supercool团队允许我接管这个项目。