Skip to content

Commit

Permalink
explain auto-tags
Browse files Browse the repository at this point in the history
  • Loading branch information
kevinpapst committed Mar 12, 2024
1 parent b17dfa1 commit ba03876
Showing 1 changed file with 9 additions and 1 deletion.
10 changes: 9 additions & 1 deletion _documentation/plugin-custom-fields.md
Original file line number Diff line number Diff line change
Expand Up @@ -6,7 +6,7 @@ description: Add free configurable custom fields to your Kimai installation
{% include plugins/custom-fields.md %}

Custom fields can be of the following type:
`string`, `integer`, `number`, `duration`, `money`, `language`, `currency`, `country`, `color`, `date`, `datetime`, `email`, `textarea`, `invoice template`, `checkbox`, `choice-list`
`string`, `integer`, `number`, `duration`, `money`, `language`, `currency`, `country`, `color`, `date`, `datetime`, `email`, `textarea`, `invoice template`, `checkbox`, `choice-list`, `auto-tags`

## Field types

Expand All @@ -31,6 +31,7 @@ The custom fields will be shown on the "create and edit entity" forms and can ha
| `invoice template` | dropdown |
| `checkbox` | on/off |
| `choice-list` | drop-down with custom entries |
| `auto-tags` | automatic timesheet tagging through assignment on activities/projects/custo mers |
{: .table }

### Checkbox
Expand Down Expand Up @@ -60,6 +61,13 @@ A select box that is useful if you want to generate automatic invoices via comma
The Kimai command `bin/console kimai:invoice:create` supports invoice templates via custom-field ([see docs](https://www.kimai.org/documentation/invoices.html#create-invoices-with-cronjobs)).
The option parameter `--template-meta` takes the internal name of the custom field that will identify the invoice template to be used.

### Auto-Tags

This advanced feature allows to assign certain tags to Activity, Project and Customer.

Once you assigned such an `auto-tag` e.g to a Project, each future timesheet that is linked to the selected `Project` will be assigned
the selected `auto-tags`. A user cannot remove these tags, they are automatically assigned after the form (to save the timesheet) was submitted.

## Permissions

| Permission Name | Description |
Expand Down

0 comments on commit ba03876

Please sign in to comment.