kimai / DemoBundle

Kimai Demo bundle for developers, who want to create a plugin and extend the time-tracking experience
MIT License
17 stars 12 forks source link
kimai kimai-bundle kimai-plugin kimai-timetracking

Kimai - Developer Demo Bundle

CI Status

A plugin to showcase some developer options within Kimai.

What's included?

Demo configuration

You users could set a default value via local.yaml like this:

demo:
    some_setting: testing

But that should not be required, as they can change the configuration through the "System configuration" screen in Kimai.

Installation

This plugin is compatible with the following Kimai releases:

Bundle version Minimum Kimai version
2.1.0 - 2.2.0 2.1.0
2.0 2.0.0
0.9 - 0.10 1.11
0.9 1.11
0.8 1.10
0.5 - 0.7 1.7
0.1 - 0.4 1.6

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 afterward:

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

Then rebuild the cache:

bin/console kimai:reload -n

And install the database:

bin/console kimai:bundle:demo:install

Permissions

This bundle ships a new permission:

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

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