keleo/custom-css-bundle

Edit custom CSS rules through an administration screen.

2.2.0 2024-05-27 12:12 UTC

Requires (Dev)

• friendsofphp/php-cs-fixer: ^3.0
• kimai/kimai: dev-main
• phpstan/phpstan: ^1.0
• phpstan/phpstan-symfony: ^1.0
• symfony/console: ^6.0
• symfony/event-dispatcher: ^6.0

MIT

• Kevin Papst

• Kimai
• kimai-plugin

README

A Kimai plugin, which allows editing custom CSS rules through an administration screen.

It ships with some pre-defined CSS rules, which can be added with a button click.

Installation

This plugin is compatible with the following Kimai releases:

Bundle version	Minimum Kimai version
2.1.0	2.1.0
2.0 - 2.0.1	2.0.0
1.5 - 1.7	1.9
1.0 - 1.4	1.4

You find the most notable changes between the versions in the file CHANGELOG.md.

Download and extract the compatible release in var/plugins/ (see plugin docs).

The file structure needs to look like this afterwards:

var/plugins/
├── CustomCSSBundle
│   ├── CustomCSSBundle.php
|   └ ... more files and directories follow here ... 

Then rebuild the cache:

bin/console kimai:reload --env=prod

Permissions

This bundle comes with the following permissions:

• edit_custom_css - show the administration screen to edit custom css rules
• select_custom_css - select from the pre-defined rules

By default, it is assigned to each user with the role ROLE_SUPER_ADMIN.

Read how to assign these permissions to your user roles in the permission documentation.

Storage

This bundle stores the custom CSS rules in the file var/data/custom-css-bundle.css. Make sure its writable by your webserver and included in your backups.

Screenshot

Screenshots are available in the store page.