README

此模块为 Twig 添加了一些额外功能。

需求

此模块需要 Craft CMS 3.0.0-RC1 或更高版本。

安装

需要 composer 包

composer require lewiscom/twigextensions

将模块添加到 config/app.php

return [
    'modules' => [
        'twigextensions' => [
            'class' => lewiscom\twigextensions\TwigExtensionsModule::class
        ],
    ],
    'bootstrap' => [
        'twigextensions'
    ],
];

设置

如果您需要根据环境禁用某些扩展，只需复制下面的配置文件，将其命名为 'twigextensions.php'，并将其放置在您的 craft/config 文件夹中。在这里，它将遵循其他 craft 配置相同的环境规则。

<?php

return [
    // All environments
    '*' => [
        'disabled' => [
            lewiscom\twigextensions\extensions\PhoneNumberExtension::class,
        ],
    ],
    'production' => [
        'disabled' => [
            lewiscom\twigextensions\extensions\DumpDieExtension::class,
        ],
    ],
    'dev' => [
        'disabled' => [
            lewiscom\twigextensions\extensions\RegExpExtension::class,
        ],
    ],
];

扩展

CaseExtension

添加各种大小写转换辅助函数

DumpDieExtension

使 larapack/dd 函数在 twig 模板中可用

GlobalVariablesExtension

Twig 2.x 改变了变量的作用域方式，此扩展可以帮助恢复您可能不想导入到每个模板中的某些全局变量。您可以添加尽可能多的全局变量，并根据环境设置不同的值。

<?php

return [
    '*' => [
        'globals' => [
            'conf' => Craft::$app->config->getGeneral()
        ],
    ],
];

RelativeDateExtension

默认情况下，它将日期对象转换为相对于当前日期和时间的可读相对日期。

示例

{{ entry.createdAt|relativeDate }}

2 hours ago

{{ entry.createdAt|relativeDate(false, 3) }}

4 months, 3 weeks, 4 days ago

{{ entry.createdAt|relativeDate(futureDate, 1, 'from now') }}

4 days from now

RegExpExtension

添加各种正则表达式函数

由 Lewis Communications 提供