89€ (excl. VAT)

Pricing for this item

Offered by

Logo - HMR-IT GmbH

HMR-IT GmbH

Software + App development company from Germany

If you have any question, visit the developers homepage or use the email for direct contact .
A plugin for Kimai to track the sick-days of users.
Last update: 14 Mar 2021

Features

  • Track the days of illness of your users
  • Upload sick certificate / incapacity certificate as PDF and archive it in Kimai
  • Automatically adds the times absent to the user’s timesheet based on their daily working time

Requirements

Setup

Create a customer, project and activity for sick days if you haven’t already.

Click on Sick Days in the menu and select the Settings tab.

Here you can select if PDFs are required for creating applications, and the activity for sick days (timesheet entries will be created using this).

If you have the Custom-fields plugin installed create a new field for users with duration as input field. The time you enter will be inserted into the users timesheet when creating applications.

Using the last input you can limit until when applications can be created. 1 for example, will only let users create applications until today minus 1 week.

Help

The badge in the menu at the entry “Sick Days” will display the amount of sick days with the “notified” status.

Permissions

The install-command will create the following permission:

  • sickday_admin

Users with that permission can create sick days for other users, view the summary screen and change the settings.

Screenshots

Installation

Copy files

Extract the ZIP file and upload the included directory and all files to your Kimai installation to the new directory:

var/plugins/SickDayBundle/

The file structure needs to like like this afterwards:

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

Clear cache

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:

How to reload Kimai cache

bin/console kimai:reload --env=prod

It is not advised, but in case the above command fails you could try:

rm -r var/cache/prod/*

You might have to set file permissions afterwards:

Fix Kimai file permission

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

chown -R :www-data .
chmod -R g+r .
chmod -R g+rw var/
chmod -R g+rw public/avatars/

Test Kimai before executing these commands (they are likely not required in a shared-hosting environment). You probably need to prefix them with sudo and the group might be called different than www-data.

Create database

Run the following command:

bin/console kimai:bundle:sickday:install

This will create the required database tables and update them to the latest version.

Updates

Updating the plugin works exactly like the installation:

  • Delete the directory var/plugins/SickDayBundle/
  • Execute all installation steps again:
    • Copy files
    • Clear cache
    • Update database with bin/console kimai:bundle:sickday:install