Changes between Version 7 and Version 8 of TracTicketsCustomFields


Ignore:
Timestamp:
10/05/2023 07:15:48 AM (14 months ago)
Author:
trac
Comment:

--

Legend:

Unmodified
Added
Removed
Modified

  • TracTicketsCustomFields

    v7 v8  
    44== Configuration
    55
    6 Configuring custom ticket fields in the [TracIni#ticket-custom-section "[ticket-custom]"] section of trac.ini.
     6Configure custom ticket fields in the [TracIni#ticket-custom-section "[ticket-custom]"] section of trac.ini.
    77
    88The syntax of each field definition is:
    … …  
    1515The example below should help to explain the syntax.
    1616
     17=== Field Names
     18A field name can only contain lowercase letters a-z, uppercase letters A-Z or digits 0-9, and must not start with a leading digit.
     19
     20The following field names are reserved and can not be used for custom fields:
     21* cc
     22* changetime
     23* col
     24* comment
     25* component
     26* desc
     27* description
     28* format
     29* group
     30* groupdesc
     31* id
     32* keywords
     33* max
     34* milestone
     35* or
     36* order
     37* owner
     38* page
     39* priority
     40* report
     41* reporter
     42* resolution
     43* row
     44* severity
     45* status
     46* summary
     47* time
     48* type
     49* verbose
     50* version
     51
    1752=== Available Field Types and Options
    1853
    … …  
    2257   * order: Sort order placement relative to other custom fields.
    2358   * max_size: Maximum allowed size in characters (//Since 1.3.2//).
    24    * format: One of: 
    25      * `plain` for plain text 
     59   * format: One of:
     60     * `plain` for plain text
    2661     * `wiki` for [WikiFormatting wiki formatted] content
    2762     * `reference` to treat the content as a queryable value
    2863     * `list` to interpret the content as a list of queryable values, separated by whitespace
     64   * ticketlink_query: Query for linkifying ticket values.
     65     Not applicable for format `plain` and `wiki`.
    2966 * '''checkbox''': A boolean value check box.
    3067   * label: Descriptive label.
    3168   * value: Default value, 0 or 1.
    3269   * order: Sort order placement.
     70   * ticketlink_query: Query for linkifying ticket values.
    3371 * '''select''': Drop-down select box. Uses a list of values.
    3472   * label: Descriptive label.
    … …  
    3674   * value: Default value (one of the values from options).
    3775   * order: Sort order placement.
     76   * ticketlink_query: Query for linkifying ticket values.
    3877 * '''radio''': Radio buttons. Essentially the same as '''select'''.
    3978   * label: Descriptive label.
    … …  
    4180   * value: Default value, one of the values from options.
    4281   * order: Sort order placement.
     82   * ticketlink_query: Query for linkifying ticket values.
    4383 * '''textarea''': Multi-line text area.
    4484   * label: Descriptive label.
    … …  
    60100
    61101Macros will be expanded when rendering `textarea` fields with format `wiki`, but not when rendering `text` fields with format `wiki`.
     102
     103For applicable fields, the `ticketlink_query` option
     104overrides [[TracIni#query-ticketlink_query-option|"[query] ticketlink_query"]], and the format is the same as
     105that option. When the `ticketlink_query` option
     106is not specified, `[query]` `ticketlink_query` is used to
     107linkify the field.
    62108
    63109=== Sample Configuration