Kirby Plugin to use laravel-mix's Versioning / Cache Busting.
Place kirby-laravel-mix-helper.php
into /site/plugins/kirby-laravel-mix-helper
folder.
You can also install this plugin through composer. Execute the following command in the root of your kirby plugin. Composer will place the files automatically in the plugins directory.
composer require wnx/kirby-laravel-mix-helper
If you have a custom folder structure in your kirby project, you can also adjust the installation path within your composer.json
. Add the following setting:
"extra": {
"installer-paths": {
"dist/site/plugins/kirby-laravel-mix-helper": ["wnx/kirby-laravel-mix-helper"]
}
}
git submodule add https://github.com/stefanzweifel/kirby-laravel-mix-helper.git site/plugins/kirby-laravel-mix-helper
After installing the plugin the mix()
helper is available to you. In your template you can then use it in your link
- and script
-tags like this:
<link rel="stylesheet" href="<?php echo mix('/assets/css/main.css') ?>">
The mix
helper will read your mix-manifest.json
file and append the cache busting ID to the asset path.
The rendered HTML will look like this:
<link rel="stylesheet" href="/assets/css/main.css?id=0ae511c15cfbd440f579">
The plugin comes with one configuration option: mix.manifest
.
Add it to your config.php
file if your mix-manifest.json
file is stored at a custom path.
c::set('mix.manifest', 'assets/mix-manifest.json');
MIT