supercool/tools

Craft CMS 网站的一些实用工具集合

5.0.0 2024-05-01 11:12 UTC

README

奇思妙想

Craft CMS 网站的实用工具集合。

字段类型

宽度

这允许您定义块的宽度以及左右填充。该字段简单地输出三组类,这些类可以在设置字段时定义。

Width Field Settings Width Field

作者说明

这允许您输出 markdown 而不是字段,这在您有一个没有字段的 Matrix 块时非常有用。

Author Instructions Example

分类(多个组)

一个分类输入,允许您选择多个分类组。

祖先

一个只显示当前条目祖先的条目输入。

搜索字段

类似于标签输入,但用于条目和分类(没有自动创建功能)。如果已安装 Craft Commerce,产品及其变体的搜索字段也可用。

禁用字段

与常规字段相同,但已禁用。在您想与第三方 API 集成并将该信息存储在字段中但不想让用户更改它的情况下非常有用。

以下字段类型目前受支持

  • 条目
  • 分类
  • Lightswitch
  • 数字
  • 纯文本
  • 下拉菜单
  • Commerce 产品
  • Commerce 变体

小部件

自定义

一个简单的组件,允许您将模板分配到您的站点模板文件夹中。尽情发挥。

杂项

下载文件

一个控制器操作,可以下载资产文件。

id 参数是必需的,并且必须是一个有效的资产 ID。

用法

<a href="{{ actionUrl('tools/tools/download-file', { id: entry.assetField.one().id }) }}">Download</a>

配置

默认情况下,所有常规字段类型和小部件都是启用的。只有当 Craft Commerce 已安装并启用时,才启用 commerce 字段类型。您可以通过向项目中的 config/tools.php 文件添加以下内容来禁用每个字段类型和小部件

use spicyweb\oddsandends\fields\AuthorInstructions;
use spicyweb\oddsandends\fields\DisabledProducts;
use spicyweb\oddsandends\widgets\RollYourOwn;

return [
    'disableNormalFields' => [
        AuthorInstructions::class,
    ],
    'disableCommerceFields' => [
        DisabledProducts::class,
    ],
    'disableWidgets' => [
        RollYourOwn::class,
    ],
];

支持多环境配置。有关更多信息,请参阅 Craft 的文档。请参阅此存储库中的 config/tools.php 以了解如何禁用任何字段和小部件的示例。

Supercool 创建
Spicy Web 维护