Sanitize Filenames for Kirby CMS โ This plugin automatically transforms and sanitizes filenames using file hooks. It can converts filenames to snake_case
or kebab-case
. It also sanitizes filenames by modifying special characters and allows adding a custom prefix for consistent file naming.
Download and copy this repository to /site/plugins/kirby-sanitize-filenames
.
composer require timnarr/kirby-sanitize-filenames
The plugin listens for these two Kirby hooks, and when these are triggered, the filename gets manipulated:
file.create:after
file.replace:after
This plugin does not support the changeName
hook because file renaming, which occurs after the create
and replace
hooks, will trigger the changeName
hook too. This could lead to some misbehaviors. However, it is beneficial to be able to change the filename after the initial upload and filename manipulation.
You can choose between snake
and kebab
style. The prefix will also be transformed to a safe-name and a delimiter gets appended: _
for snake and -
for kebab style.
'timnarr.sanitize-filenames' => [
'caseStyle' => 'snake',
'prefix' => 'timnarr'
]
MIT License Copyright ยฉ 2023 Tim Narr