README

GetAsset for Craft 3.1

这个小插件会在特定文件夹中查找最后修改的文件，并在 Twig 中返回其值。

安装

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

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

cd /path/to/project

1. 然后让 Composer 加载插件

composer require youandmedigital/craft-getasset

简介

这个小插件会在特定文件夹中查找最后修改的文件，并在 Twig 中返回其值。

如果以下情况适用于您，这可能对您很有用：

• 您正在运行 Craft 3.1 或更高版本
• 您没有使用 Asset Rev 或 Twigpack for Webpack 等工具
• 您已设置本地构建系统以哈希编译的 CSS 或 JavaScript
• 您正在寻找一种低成本的解决方案来拉取哈希过的 CSS 或 JavaScript 文件并在模板中使用它们

示例

输出目录中最后修改的文件

在 /assets/css 中有 3 个文件，以下是其时间戳：

22 Apr 22:54 c.min.d6df804850.css
22 Apr 22:55 plugin.css
22 Apr 22:54 ie.min.8af08fe73b.css

在我们的 Twig 模板中，我们设置一个变量，并给 GetAssets 提供一个搜索的文件夹路径

{% set settings =
    {
        path: '/assets/css/'
    }
%}
{% set file = craft.getasset.config(settings) %}
<link rel="stylesheet" href="/assets/css/{{ file }}">

此示例 Twig 代码将输出：

<link rel="stylesheet" href="/assets/css/plugin.css">

输出目录中最后修改的文件，该文件匹配正则表达式模式

在 /assets/css 中有 4 个文件，以下是其时间戳：

22 Apr 22:54 c.min.d6df804850.css
22 Apr 22:50 c.min.a8xd808007.css
22 Apr 22:55 p.min.d6df804850.css
22 Apr 22:54 ie.min.8af08fe73b.css

在我们的 Twig 模板中，我们设置一个变量，给 GetAssets 提供一个搜索的文件夹路径和一个用于匹配的正则表达式模式

{% set settings =
    {
        path: '/assets/css/',
        pattern: '/^(c).min.*\\S{10}.css$/'
    }
%}
{% set file = craft.getasset.config(settings) %}  
<link rel="stylesheet" href="/assets/css/{{ file }}">

此示例 Twig 代码将输出：

<link rel="stylesheet" href="/assets/css/c.min.d6df804850.css">

配置 GetAsset

• path (string, required)：GetAsset 搜索的有效文件夹
• pattern (string, optional, default value '*')：用于匹配的正则表达式模式

示例配置

{% set myVarSettings =
    {
        path: '<path>',
        pattern: '<pattern>'
    }
%}
{% set myVar = craft.getasset.config(myVarSettings) %}