29€ (excl. VAT)

Pricing for this item
Logo - HMR-IT GmbH

HMR-IT GmbH

Software + App development company from Germany

A plugin for Kimai 2 which generates a RecordBook (German: Berichtsheft) for trainees.
Last update: 21 Sep 2020

Features

  • This plugin generates one PDF per week as a download with a single click
  • The PDF shows all descriptions of the timesheet entries of the selected week in a tabular form
  • The PDF has signature fields for: trainee, parent/legal guardian, school and trainee teacher

Demo

Click here for a demo view of the generated pdf.

Requires

Kimai 2, V1.10+

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/RecordBook/

The file structure needs to like like this afterwards:

var/plugins/
├── RecordBook
│   ├── RecordBook.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

FTP users: please have a look at this documentation.

If you are running an older version of Kimai (before 1.8) you have to use:

bin/console cache:clear --env=prod
bin/console cache:warmup --env=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.

Updates

Updating the plugin works exactly like the installation:

  • Delete the directory var/plugins/RecordBook/
  • Execute all installation steps again:
    • Copy files
    • Clear cache