Customer Portal

Share client and project statistics and timesheets with anyone using a secret URL, optionally password protected.

Kevin Papst
提供者
Kevin Papst

A Kimai plugin that allows you to share your timesheets details and statistics for customer and projects via a URL.

Features

  • Shared details with your customers via URL
  • Create publicly accessible URLs for customer details (stats and timesheets)
  • Create publicly accessible URLs for the project details (stats and timesheets)
  • Access control: protect the shared details with a password (optional)
  • View control feature
    • Show or hide user of records (name of user)
    • Show or hide rates of records (hour rate, total rate)
    • Show or hide chart with day comparison by selected month
    • Show or hide chart with month comparison by selected year
  • View customizations
    • Define whether and how to merge records of a day (e.g. merge records of one day, use description of last record)

After installation: open Kimai in your browser and navigate to “Applications > Customer Portal”.

Credits

This plugin was originally created by Fabian Vetter in 2020.

As it was abandoned by the original author, it has been forked and further extended by Kevin Papst since then.

安装

复制文件

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

var/plugins/CustomerPortalBundle/

The file structure needs to look like this afterwards:

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

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:

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

You might not need these commands in a shared-hosting environment. And you probably need to prefix them with sudo and/or the group might be called different from www-data.

创建数据库

Run the following command:

bin/console kimai:bundle:customer-portal:install

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

更新

Updating the plugin works exactly like the installation:

  • Delete the directory var/plugins/CustomerPortalBundle/
  • Execute all installation steps again:
    • 复制文件
    • 清除缓存
    • Update database with bin/console kimai:bundle:customer-portal:install

Changelog

Version 4.1.1

Compatibility: requires minimum Kimai 2.21.0

  • Added missing “Documentation” link
  • Create with invalid type caused 500: redirect to manage view instead

Version 4.1.0

Compatibility: requires minimum Kimai 2.21.0

  • Move “Customer Portal” to “Administration” menu
  • Use new database table kimai2_customer_portals
  • Automatic migration of existing URL shares and database cleanup
  • Move statistics card above timesheets
  • Fix: broken customer statistics (customer portals with budget display for customer without budget)

Version 4.0.0

Compatibility: requires minimum Kimai 2.21.0

  • Rename to “Customer portal”
  • Allow to switch month and year via dropdowns
  • Simplify URLs by using 20-char share-key only (old URLS still working)
  • Toggle financial- and time budget statistics for shared URLs
  • Allow to share an entire customer
  • Add details button and stats in project listing on shared customer page
  • Use translations from core, use latest repository features
  • Use password field for login
  • Fixes missing timesheet if user and start time is the same

演示

你可以在以下网站测试这个插件 demo.kimai.org:

用户名: susan_super
密码: kitten

在此处查找更多测试帐户.

提供者

Kevin Papst

Building Kimai since 2009

如果你有任何问题,请使用以下联系信息与开发商直接联系。
Top