Kimai
Kunden-E-Mail-Bericht
Sende deinen Kunden einen Bericht über deine Arbeitszeiten per E-Mail
Simon Schaufelberger
E-Mail-Bericht über Arbeitszeiten
Ein Kimai-Plugin zum Versenden eines E-Mail-Berichts an einen Kunden mit den Arbeitszeiten und Beschreibungen des Vortags.
Sind Sie ein Freiberufler? Verwenden Sie dieses Plugin, um Ihren Kunden einen täglichen Statusbericht über die geleisteten Arbeitsstunden zu senden.
Überraschen Sie Ihren Kunden mit Transparenz und Vertrauen statt mit einer unerwartet hohen Rechnung am Ende des Monats. So hat Ihr Kunde einen guten Überblick über alle geleisteten Arbeiten.
In der Kundenverwaltung können Sie einstellen, ob Sie jedem Kunden einzeln einen Statusbericht zusenden möchten.
Tagesbericht als responsive E-Mail
Die E-Mail passt sich nahtlos an jedes Endgerät an. Sie können die E-Mail auf jedem Gerät perfekt lesen. Je nach Geräteeinstellung kann Ihr Kunde die E-Mail auch im Dunkelmodus perfekt lesen.
Was ist enthalten?
- eine neue Berechtigung manage_customer_email_report
- ein neuer Befehl zum Versenden des E-Mail-Berichts
- ein Meta-Feld für Kunden, um den E-Mail-Bericht zu aktivieren
Systemvoraussetzungen
Sie benötigen die Möglichkeit, Cronjobs auf Ihrem Server auszuführen, entweder in Ihrer Hosting-Administrationsplattform oder manuell über crontab -e.
Dies ist erforderlich, um den Befehl bin/console customer-email-report:send auszuführen.
Einrichtungsschritte nach der Installation
Wenn Sie den E-Mail-Bericht täglich um 1:00 Uhr nachts in deutscher Sprache versenden möchten, können Sie den folgenden Cronjob verwenden:
0 1 * * * /usr/bin/php8.1 /var/www/html/kimai/bin/console customer-email-report:send --locale=de >/dev/null 2>&1
Kompatibilität
Die folgende Tabelle enthält einen Vergleich zwischen Plugin und benötigter Kimai-Version.
| Plugin-Version | Minimale Kimai-Version |
|---|---|
| 1.0.0 | 2.0.0 |
Installation
Dateien kopieren
Extract the ZIP file and upload the included directory and all files to your Kimai installation to the new directory:
var/plugins/CustomerEmailReportBundle/The file structure needs to look like this afterwards:
var/plugins/
├── CustomerEmailReportBundle
│ ├── CustomerEmailReportBundle.php
| └ ... more files and directories follow here ...Cache leeren
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.
Aktualisierung
Updating the plugin works exactly like the installation:
- Delete the directory
var/plugins/CustomerEmailReportBundle/ -
Execute all installation steps again:
- Dateien kopieren
- Cache leeren
Bilder
FAQ
Die FAQs werden vom Entwickler des Angebots bereitgestellt.
All paid plugins are annual subscriptions.
You can buy the plugin via the Marketplace LemonSqueezy and pay with Credit Card or PayPal for immediate access. You can also get in touch and pay with wire transfer or SEPA, but you will have to wait a few days before getting access to the plugin.
Support-questions, bug-reports and feature-requests can be made via the contact form at www.simonschaufelberger.de.
If you purchase a plugin subscription, you’ll receive all updates, bugfixes, and support for one year. After the subscription ends, your plugin will continue to work without any restrictions – you can keep using the last version you downloaded. This model is known as a perpetual fallback license. However, access to future updates, new features, and compatibility fixes require an active subscription.
No, refunds are not available. Kimai plugins are delivered as digital downloads and cannot be returned once the source code has been accessed. Additionally, payment providers charge non-refundable transaction fees, even if a refund were issued. For these reasons, all sales are final. The same applies for subscriptions that were not canceled in time. Please contact me before purchase if you’re unsure whether a plugin fits your needs.