Recommended Setup: watch the youtube video at the bottom!
Create two custom fields for users using the custom-fields plugin:
If you’re logged in as super-admin you will see an item in the menu called “Vacation view”. In it there is a settings-tab. Here you can select the state for public holidays, the activities that will be used as public holidays and vacations.
The last two inputs are dropdowns with all meta-fields. Select the ones you created earlier.
The install-command will create two permissions:
Users with none of the permissions won’t see the vacation tab in the menu.
If you assign the
vacation permission to a user they will see the leave-application tab in the menu.
Super-admins and users with the
vacation_admin permission have full control over this plugin.
Extract the ZIP file and upload the included directory and all files to your Kimai installation to the new directory:
The file structure needs to like like this afterwards:
After uploading the files, Kimai needs to know about the new plugin. It will be found once the cache was re-built. Call these commands from the Kimai directory:
It is not advised, but in case the above command fails you could try:
You might have to set file permissions afterwards:
You have to allow PHP (your webserver process) to write to
var/ and it subdirectories.
Here is an example for Debian/Ubuntu (to be executed inside the Kimai directory):
Test Kimai before executing these commands (they are likely not required in a shared-hosting environment).
You probably need to prefix them with
the group might be called different than
Run the following command:
This will create the required database tables and update them to the latest version.
Updating the plugin works exactly like the installation:
bin/console bin/console kimai:bundle:vacation:install
|Android app for offline tracking||
|Controlling plugin (German law, break time check, overtime)||
|Empty description checker plugin||
|HasWorked plugin (notify users if they haven't entered times)||
|Period insert plugin||
|RecordBook plugin (Berichtsheft für Azubis)||
|Sick-Day plugin (days of illness)||
|Vacation plugin (vacation + official & local holidays)||
|iOS app for offline tracking with Kimai||