pixelopen/kirby-asset-version

A plugin for Kirby CMS to add modification timestamps to css and js files

1.0.2 2024-03-24 14:22 UTC

Requires

• php: >=8.0.0 <8.4.0
• getkirby/cms: ^3.9.0||^4.0.0
• getkirby/composer-installer: ^1.1

Requires (Dev)

• symplify/easy-coding-standard: ^12.0

MIT

• Pixel Open

• kirby-plugin
• kirby-cms

README

A plugin for Kirby CMS to add modification timestamps to your assets files (js and css), as long as they are embedded with the css() and js() helpers.

This plugin is a fork on cachebuster developped by Timo Schneider : https://github.com/schnti/kirby3-cachebuster

We have simplified it at the code level and above all, asset versioning does not require URL rewriting, it is Apache and nginx compatible

Commercial Usage

This plugin is free but if you use it in a commercial project please consider

• making a donation for Timo Schneider

Installation

Download

Download the files and place them inside site/plugins/asset-version.

Composer

composer require pixelopen/kirby-asset-version

Git Submodule

You can add the plugin as a Git submodule.

$ cd your/project/root
$ git submodule add https://github.com/Pixel-Open/kirby-asset-version.git site/plugins/asset-version
$ git submodule update --init --recursive
$ git commit -am "Add Kirby asset version plugin"

Run these commands to update the plugin:

$ cd your/project/root
$ git submodule foreach git checkout master
$ git submodule foreach git pull
$ git commit -am "Update submodules"
$ git submodule update --init --recursive

Options

You can disable the plugin with the following line in your /site/config/config.php:

return [
  'pixelopen.asset-version.active' => false,
];