Skip to content

Commit

Permalink
more to read
Browse files Browse the repository at this point in the history
  • Loading branch information
kevinpapst committed Oct 28, 2022
1 parent 55c8159 commit fd921be
Show file tree
Hide file tree
Showing 2 changed files with 26 additions and 1 deletion.
2 changes: 1 addition & 1 deletion CHANGELOG.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,6 +2,6 @@

## 1.0

Compatible with Kimai 1.20
Compatible with Kimai 1.20.0

Initial release.
25 changes: 25 additions & 0 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -7,8 +7,33 @@ Deduction times can be edited, but the negative duration is not used in the UI a

It is always the calculated duration of `end - start`, which is then converted to its negative value.

### Configure an activity

When editing any activity, you will see a new checkbox `Deduction time`.
If this is checked, every future timesheet using this activity, will have negative durations.

### When to use this plugin

If you are too lazy to create multiple records per day, but instead want to record entire days (attendance) and use those to create invoices/exports,
you find yourself with too many hours on the clock.

You could manually subtract breaks from every day OR you use this plugin.

1. Allow overlapping records in System > Configuration
2. Create a global activity "break time" and activate the `Deduction time` checkbox
3. Use that new activity to record your employees break times, e.g. via calendar
4. Safely export or invoice your times: due to the negative duration the break times will be subtracted from the attendance time

## Installation

This plugin is compatible with the following Kimai releases:

| Bundle version | Minimum Kimai version |
|----------------|-----------------------|
| 1.0 | 1.27.0 |

You find the most notable changes between the versions in the file [CHANGELOG.md](CHANGELOG.md).

First clone it to your Kimai installation `plugins` directory:
```bash
cd var/plugins/
Expand Down

0 comments on commit fd921be

Please sign in to comment.