Software development company founded by Kevin Papst
You can test this plugin in our dedicated plugin demo:
Find more testing accounts here.
A Kimai plugin, which allows using barcodes for punch-in
and punch-out
time tracking with Kimai.
You can use it with an attached barcode scanner, or you run Kimai on a device (eg. tablet) with a built-in camera.
It also supports a “freestyle” mode, which allows to enter any free configurable code (up to 120 characters), so you can also use other devices for starting/stopping:
If you want to use Kimai in a kiosk mode, where your users should only register their attendance time through
punch-in and punch-out mode when entering/leaving the building, then this bundle is the solution for you.
It could be as simple as:
You can test it in the “Plugins” demo.
Code 128
Code 39
UPC-A
(scanner needs to transmit check digit)Code 2 of 5
Code 2 of 5 interleaved
Codabar
(scanner needs to transmit start & stop digits)You need to configure a non-global activity for starting the record via this plugin. This will be used for every recorded timesheet that is created using the kiosk mode.
This is NOT a hardware recommendation, but more an idea for possible use-cases.
I tried the linked products and even though all scanner are rather cheap, they work without problems.
The above are affiliate links for Amazon (germany) where I bought them myself.
You have to configure the bundle before you can use it - you reach the configuration via
Plugin
screen (Preferences
in action dropdown behind the plugin)Kiosk & Barcode
section)The following configurations are available:
Configuration | Description |
---|---|
Login mode |
whether to use camera or usb mode |
Code format |
you have to decide which code format you want to use |
Barcode includes readable code |
whether the barcode in the user profile will include the human readable code |
Duration to display confirmation dialog (in seconds) |
how long the start/stop screens will be shown after a successful scan |
Activity |
the non-global activity that will be used to track the times |
This bundle introduces new permissions, which limit access to certain functions:
Permission Name | Description |
---|---|
barcode_own_profile |
allows to see and administrate barcode for the own user profile |
barcode_other_profile |
allows to see and administrate barcode for all user profiles |
kiosk_own_profile |
allows to configure user specific kiosk settings (eg. start and end time) for the own user profile |
kiosk_other_profile |
allows to configure user specific kiosk settings (eg. start and end time) for all user profiles |
By default, these are granted to each user with the role ROLE_SUPER_ADMIN
.
The plugin is compatible with the following Kimai releases:
Bundle version | Kimai version |
---|---|
1.5 | 1.11 |
1.4 | 1.10 |
1.0 - 1.3 | 1.8 |
Extract the ZIP file and upload the included directory and all files to your Kimai installation to the new directory:
var/plugins/KioskBundle/
The file structure needs to like like this afterwards:
var/plugins/
├── KioskBundle
│ ├── KioskBundle.php
| └ ... more files and directories follow here ...
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:
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:
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
.
Run the following command:
bin/console kimai:bundle:kiosk:install
This will create the required database tables and update them to the latest version.
The following command will install the required assets (images, javascripts, styles):
bin/console assets:install
Updating the plugin works exactly like the installation:
var/plugins/KioskBundle/
bin/console kimai:bundle:kiosk:install
bin/console assets:install
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 a customer, project and activity. These expenses can be categorized and included in your invoices.
|
plugin
|
49€ | |
Kiosk plugin
|
plugin
|
199€ | |
Task management plugin
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 adds two new dashboard widgets
|
plugin
|
49€ |
Console client (PHAR) |
client
|
free | |
Custom CSS plugin |
plugin
|
free | |
Custom plugin development |
development
support
|
||
Fail2Ban plugin |
plugin
|
free | |
Grandtotal plugin |
3rd party
|
free | |
Installation & Update support |
support
|
||
Recalculate rates plugin |
plugin
|
free |