@mightyplow/eleventy-plugin-cache-buster

A plugin for eleventy which adds a unique query parameter to css and js resources.
This allows to set unlimited caching for those resources and ensure that they get properly reloaded when they change.
See this article on Cache Busting.

By default the hash is created out of the resource content (see notes).

Installation

```
npm i @mightyplow/eleventy-plugin-cache-buster -D
``

Usage

In your projects' _.eleventy.js_ file, add the plugin.

``.js
const cacheBuster = require('@mightyplow/eleventy-plugin-cache-buster');

module.exports = function(eleventyConfig) {
const cacheBusterOptions = {};
eleventyConfig.addPlugin(cacheBuster(cacheBusterOptions));
};

``

$3

#### outputDirectory: string

The directory where eleventy stores the built files to. This is required to resolve resources which start with a slash.
If eleventy is called with the --output option from the command line, this option can be omitted.

#### hashParameter: string (default: 'v')

The query parameter which is appended to the resource urls, i.e. _/foo/bar.css?v=[hash]_.

#### sourceAttributes: object (default: { link: 'href', script: 'src' })

An object which maps the relevant html tags to the attributes, in which the url can be found in. By default it is looking
for script tags and link tags.

Since the options get merged, the default attributes don't have to be included when you want to add additional ones.

#### createResourceHash: function(outputDirectory, url, target) (default: createResourceHash)

The function which creates the hash for the found urls. You can use that if you want to add a custom value.

By default an MD5 hash is created out of the file content. Therefore the assets have to be built before running eleventy (see notes).
If you want to build everything in parallel you can for instance add a timestamp. Notice that then the
cache busting parameter changes on every build which leads to resources being cache busted with every release.

`
const cacheBuster = require('@mightyplow/eleventy-plugin-cache-buster');

module.exports = function(eleventyConfig) {
const cacheBusterOptions = {
createResourceHash(outputDirectoy, url, target) {
return Date.now();
}
};
eleventyConfig.addPlugin(cacheBuster(cacheBusterOptions));
};
`

Notes

$3

By now this plugin only works with path-relative URLs.
- what will get processed:
- /assets/css/foo.css
- ../assets/css/foo.css

- what will not get processed:
- //foo.bar/assets/css/foo.css
- https://foo.bar/assets/css/foo.css`

$3

In order to create the resource hashes, the resource files have to be built
before the html. You have to ensure this in your build process.