Logo - Keleo

Keleo

Software development company founded by Kevin Papst

Try it

You can test this plugin in our dedicated plugin demo:

  • Username: susan_super
  • Password: kitten

Find more testing accounts here.

Screenshots
Click to enlarge
Create tasks, start/stop/pause them, assign them to users and teams and record times - a todo-list management plugin for Kimai 2 that features two new dashboard widgets
Last update: 22 Jan 2020

A Kimai 2 plugin, which allows you to plan your work and distribute tasks among your users and teams. It features two new dashboard widgets and a new “Task management” view in the left navigation.

Features

  • Add “tasks” which are used to start and group timesheet records
  • Each task consists of a
    • Title
    • End date (optional)
    • User (optional: if left empty, the task can be self-assigned from the “pending tasks” widget)
    • Team (optional: if given, only users from this team see this task and can assign it)
    • Customer (will be copied to the started timesheets)
    • Project (will be copied to the started timesheets)
    • Activity (will be copied to the started timesheets)
    • Description (will be copied to the started timesheets)

With the help of the dashboard widgets every user can manage their work.

Or you configure the permissions in a way, that the user only see the “My times widget”. A teamlead can then prepare a list of tasks / work schedule for the users, who then utilize the widget to start/pause/stop the tasks. When the work on a task is finished, the user can either close the it (if allowed) or the teamlead does it after reviewing the results.

Purchase

New widgets

This bundle introduces two new dashboard widgets

My times widget

  • Displays all tasks that:
    • are not “closed”
    • that are assigned to you

This widget features the following UI elements (if permissions are set for the user):

  • a checkbox to close the task (moving to status done will stop all related timesheet entries)
  • a title (colored “green” if end date is set but not yet reached, colored “red” if end date is overdue)
  • a “Play” or “Pause” button (pause means that you already recorded times for the task)
  • an “Edit” button to change the task fields
  • an “Unassign” button (will stop all related timesheet entries and move the task to the “Pending tasks widget”)
  • a “Delete” button (will remove the task entirely, but keep the related timesheet entries)
  • a “Create” button (create a new task for the currently logged-in user)

Pending tasks widget

  • Displays all tasks that:
    • that are not assigned to a user
    • that are in “pending” status
    • that can be seen by the user (via team assignment or completely unassigned tasks)

This widget features the following UI elements (if permissions are set for the user):

  • a title (colored “green” if end date is set but not yet reached, colored “red” if end date is overdue)
  • an “Edit” button
  • an “Assign” button (move the task back to the “My times widget”)
  • a “Delete” button (will remove the task entirely, but keep the related timesheet entries)
  • a “Create” button (create a new pending task)

Compatibility

This plugin is compatible with the following Kimai releases:

Bundle version Kimai 2 version
1.0 1.7

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

The file structure needs to like like this afterwards:

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

FTP users: please have a look at this documentation.

Before Kimai 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.

Install the bundle database

Run the following command:

bin/console kimai:bundle:tasks:install

This will install all required databases.

Permissions

This bundle ships a couple of new permissions, which limits the access to certain functions:

Permission Name  Description
task_edit_own Create and edit tasks that are assigned to the currently logged-in user.
task_edit_other Allows to edit all tasks that are visible to the user. Create new unassigned tasks, assign team and user.
task_assign Self-assign a pending task by the currently logged-in user. Required to see the “Pending tasks” widget on the dashboard.
task_start Start a task. Only possible if task is assigned to the current user. Required to see the “My tasks” widget on the dashboard.
task_close Close a task. Only possible if task is assigned to the current user. The task will be removed from the “My tasks” widget after it is reloaded (until then it could be reopened).
task_delete Delete any existing task.
task_view Gives access to the task administration

This bundle ships a pre-configured permission set for all default user roles.

Access to tasks for other users is also limited by the permission view_other_timesheet. If a user has the task_view permission, but NOT view_other_timesheet, he will only see own tasks. Be aware, that the data for non-admin users is additionally limited by the team assignments.

Updating the plugin

Updating the bundle works the same way as the installation does.

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

Screenshots

The overview page of all tasks:

Screenshot

The task widget:

Screenshot

When creating a new task, you can record the following fields:

Screenshot

All items by Keleo

Audit-Trail plugin

Records detailed change/audit logs for timesheets, customers, projects and activities and displays them in a per-item timeline.
plugin
29€

Custom-fields plugin

Create free configurable additional (optional and mandatory) fields for timesheets, customers, projects and activities in various formats.
plugin
49€

Expenses plugin

Keep track of your expenses based on customer, project and activity. These spendings can be categorized and included in your invoices.
plugin
49€

Kiosk plugin
New

Attendance time-tracking in an environment, where the user has no access to Kimai (eg. in a warehouse) by using a barcode scanner to start and stop timesheets.
plugin
199€

Task management plugin
New

Create tasks, start/stop/pause them, assign them to users and teams - a todo-list management plugin that is connected to your time-tracker and features two new dashboard widgets
plugin
49€
Custom CSS plugin
plugin
free
Fail2Ban plugin
plugin
free
Installation & Update support
support
upon request
Recalculate rates plugin
plugin
free