Changes between Version 1 and Version 2 of TracTicketsCustomFields


Ignore:
Timestamp:
Jul 30, 2021, 7:48:41 AM (6 months ago)
Author:
trac
Comment:

--

Legend:

Unmodified
Added
Removed
Modified

  • TracTicketsCustomFields

    v1 v2  
    44== Configuration
    55
    6 Configure custom ticket fields in the [TracIni#ticket-custom-section "[ticket-custom]"] section of trac.ini.
     6Configuring 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
    18 A 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 
    20 The 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 
    5217=== Available Field Types and Options
    5318
    … …  
    5722   * order: Sort order placement relative to other custom fields.
    5823   * max_size: Maximum allowed size in characters (//Since 1.3.2//).
    59    * format: One of:
    60      * `plain` for plain text
     24   * format: One of: 
     25     * `plain` for plain text 
    6126     * `wiki` for [WikiFormatting wiki formatted] content
    6227     * `reference` to treat the content as a queryable value
    6328     * `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`.
    6629 * '''checkbox''': A boolean value check box.
    6730   * label: Descriptive label.
    6831   * value: Default value, 0 or 1.
    6932   * order: Sort order placement.
    70    * ticketlink_query: Query for linkifying ticket values.
    7133 * '''select''': Drop-down select box. Uses a list of values.
    7234   * label: Descriptive label.
    … …  
    7436   * value: Default value (one of the values from options).
    7537   * order: Sort order placement.
    76    * ticketlink_query: Query for linkifying ticket values.
    7738 * '''radio''': Radio buttons. Essentially the same as '''select'''.
    7839   * label: Descriptive label.
    … …  
    8041   * value: Default value, one of the values from options.
    8142   * order: Sort order placement.
    82    * ticketlink_query: Query for linkifying ticket values.
    8343 * '''textarea''': Multi-line text area.
    8444   * label: Descriptive label.
    … …  
    10060
    10161Macros will be expanded when rendering `textarea` fields with format `wiki`, but not when rendering `text` fields with format `wiki`.
    102 
    103 For applicable fields, the `ticketlink_query` option
    104 overrides [[TracIni#query-ticketlink_query-option|"[query] ticketlink_query"]], and the format is the same as
    105 that option. When the `ticketlink_query` option
    106 is not specified, `[query]` `ticketlink_query` is used to
    107 linkify the field.
    10862
    10963=== Sample Configuration