Creating templates for the invoice extension is actually pretty easy.
Just create an odt (Open Office Text Document) file and write the variables in the form of [var.variablename] (the brackets are required).
Variables you can use:
| Variable | Description |
|---|---|
| [var.project] | Name of the project |
| [var.projectComment] | Comment of the project |
| [var.customerName] | Name of the customer |
| [var.companyName] | Company of the customer |
| [var.customerStreet] | Street of the customer |
| [var.customerCity] | City of the customer |
| [var.customerZip] | Zip code of the customers city |
| [var.customerComment] | Comment, which is set for the customer |
| [var.customerPhone] | Phone number of the customer |
| [var.customerFax] | Fax number of the customer |
| [var.customerMobile] | Mobile number of the customer |
| [var.customerEmail] | Email address of the customer |
| [var.customerContact] | Name of the customer's contact person |
| [var.customerVat] | VAT of the customer |
| [var.beginDate] | Selected starting date |
| [var.endDate] | Selected end date |
| [var.invoiceID] | Defined as "CUSTOMER-NAME - YEAR - MONTH". See /extensions/ki_invoice/print.php. |
| [var.today] | Current Date |
| [var.dueDate] | Defined as Current Date + 1 Month. See /extensions/ki_invoice/print.php. |
| [var.total] | Total without VAT |
| [var.gtotal] | Total including VAT |
| [var.ttltime] | Total amount of hours |
A row has these variables:
| Variable | Description |
|---|---|
| [row.desc] | Name of the task (event) |
| [row.hour] | Duration of the timesheet entry in hours |
| [row.amount] | Wage of the entry |
| [row.date] | Day of the entry |
| [row.description] | Description of the timesheet entry |
| [row.comment] | Comment of the timesheet entry |
If you get a blank page or an error similar to the follow
Fatal error: Uncaught exception 'tinyDocException' with message 'the PHP global variable named 'c<text:span' does not exist or is not set yet.' in /var/www/kimai/extensions/ki_invoice/TinyButStrong/tinyDoc.class.php:997 Stack trace:
#0 /var/www/kimai/extensions/ki_invoice/TinyButStrong/tinyButStrong.class.php(1870): tinyDoc->meth_Misc_Alert(Object(clsTbsLocator), 'the PHP global ...', true)
#1 /var/www/kimai/extensions/ki_invoice/TinyButStrong/tinyButStrong.class.php(669): clsTinyButStrong->meth_Merge_AutoVar('<?xml version="...', true)
#2 /var/www/kimai/extensions/ki_invoice/TinyButStrong/tinyDoc.class.php(269): clsTinyButStrong->Show(0)
#3 /var/www/kimai/extensions/ki_invoice/print.php(204): tinyDoc->saveXml()
#4 {main} thrown in /var/www/kimai/extensions/ki_invoice/TinyButStrong/tinyDoc.class.php on line 997
the variable name has different style applied. Select the (or all) variable name(s) and reset them to the default format. Then you can format the whole variable name as you want it.