Installation
You can install the addon directly from the Statamic interface after installing it. You can also install it directly from composer with the command:
composer require gioppy/statamic-aggregate-assets
How to use
After installing the addon, create a new disk in the config/filesystems.php file:
'aggregated' => [
'driver' => 'local',
'root' => public_path('aggregated'),
'url' => '/aggregated',
'visibility' => 'public',
]
You can customize the root directory according to your needs. The only constraint is that the disc visibility must be publicly visible.
To aggregate files use tags pair {{ aggregate:css }} and {{ aggregate:js }} in your layout.antlers.html file.
For better usage, use Aggregate in conjunction with {{ yield }}:
<!doctype html>
<html lang="{{ site:short_locale }}">
<head>
<meta charset="utf-8">
{{ aggregate:css }}
{{ yield:css }}
{{ /aggregate:css }}
</head>
<body>
{{ template_content }}
{{ aggregate:js }}
{{ yield:js }}
{{ /aggregate:js }}
</body>
</html>
In your blueprint .antlers.html file use as always:
...
{{ section:css }}
<link rel="stylesheet" href="/theme/styles/style1.css" />
<link rel="stylesheet" href="/theme/styles/style2.css" />
{{ /section:css }}
{{ section:js }}
{{ /section:js }}
Remember that the contents of the {{ aggregate }} tags will be replaced with a single CSS or JavaScript tag: insert only locally CSS and JavaScript files.
Finally, remember that aggregation does not rewrite url() within CSS files.