README

为原生 Matrix 字段类型添加功能。

功能概述

• 条目重复
• 如果条目类型列表非常长，则顶部有额外的删除按钮
• 条目复制和粘贴，包括条目类型之间
• 条目类型分组
  • 展开或分组未分组的类型
• 条目的拖放，包括条目类型之间（实验性）

需求

此插件需要 Craft CMS 5.1.0 或更高版本，以及 PHP 8.2 或更高版本。

安装

您可以从插件商店或使用 Composer 安装此插件。

从插件商店

转到项目控制面板中的插件商店，搜索“Matrix Extended”，然后按“安装”。

使用 Composer

打开您的终端并运行以下命令

# go to the project directory
cd /path/to/my-project.test

# tell Composer to load the plugin
composer require vandres/craft-matrix-extended

# tell Craft to install the plugin
./craft plugin/install matrix-extended

配置

您可以使用控制面板中的设置对话框。但我建议在您的配置文件夹中创建一个 matrix-extended.php。这也是目前唯一的方法（目前），以配置分组按钮。它可能看起来像这样

return [
    'extraDeleteButton' => true,
    'experimentalFeatures' => true,
    'enableDragDrop' => false,
    'expandMenu' => true,
    'expandUngrouped' => false,
    'ungroupedPosition' => 'start',
    'fields' => [
        'dyncontent' => [ // matrix field handle
            'groups' => [
                [
                    'label' => \Craft::t('app', 'Simple'),
                    'types' => ['header', 'text'], // entry type handles
                ],
            ],
        ],
        'simplecontent' => [ // matrix field handle
            'oneLiner' => true, // prevent buttons from wrapping
            'groups' => [
                [
                    'label' => \Craft::t('app', 'Simple'),
                    'types' => ['header', 'text'], // entry type handles
                ],
            ],
        ]
    ]
];

路线图

• 重复条目（完成）
• 将条目复制和粘贴到相同或不同条目类型的另一个位置（测试中）
• 将条目复制和粘贴到另一个部分（测试中）
• “添加上方块”Neo样式（测试中）
  • 尊重 canAddMoreEntries
• 允许“添加上方块”通过设置展开（测试中）
  • 如果空间不足，则显示为下拉菜单（目前不是）
  • 允许分组按钮（测试中）
    • 通过配置
    • 通过设置/后端模块（目前不是）
• 用扩展逻辑替换“新建条目”（测试中）
• 剪切和粘贴条目（目前不是）
• 条目类型之间的拖放（实验性，测试中）
  • 拖放多个
  • 拖放到“空”矩阵中（实验性，测试中）
  • 尊重 canAddMoreEntries
  • 让拖放和拖动排序共存
  • 消除警告

支持我的工作

PayPal： https://www.paypal.com/donate/?hosted_button_id=3WDU85HZCKMPA

买我一杯咖啡： https://buymeacoffee.com/vandres