Changes between Version 8 and Version 9 of TracTicketsCustomFields


Ignore:
Timestamp:
Sep 10, 2020, 8:03:21 PM (4 years ago)
Author:
trac
Comment:

--

Legend:

Unmodified
Added
Removed
Modified
  • TracTicketsCustomFields

    v8 v9  
    44== Configuration
    55
    6 Configuring custom ticket fields is done in the [wiki:TracIni trac.ini] file. All field definitions should be under a section named `[ticket-custom]`.
     6Configure custom ticket fields in the [TracIni#ticket-custom-section "[ticket-custom]"] section of trac.ini.
    77
    88The syntax of each field definition is:
     
    5555   * label: Descriptive label.
    5656   * value: Default value.
    57    * order: Sort order placement; this determines relative placement in forms with respect to other custom fields.
    58    * format: One of:
    59      * `plain` for plain text
    60      * `wiki` to interpret the content as WikiFormatting
    61      * `reference` to treat the content as a queryable value (''since 1.0'')
    62      * `list` to interpret the content as a list of queryable values, separated by whitespace (''since 1.0'')
     57   * order: Sort order placement relative to other custom fields.
     58   * max_size: Maximum allowed size in characters (//Since 1.3.2//).
     59   * format: One of:
     60     * `plain` for plain text
     61     * `wiki` for [WikiFormatting wiki formatted] content
     62     * `reference` to treat the content as a queryable value
     63     * `list` to interpret the content as a list of queryable values, separated by whitespace
    6364 * '''checkbox''': A boolean value check box.
    6465   * label: Descriptive label.
     
    7879   * label: Descriptive label.
    7980   * value: Default text.
    80    * cols: Width in columns. //(Removed in 1.1.2)//
    8181   * rows: Height in lines.
    8282   * order: Sort order placement.
     83   * max_size: Maximum allowed size in characters (//Since 1.3.2//).
    8384   * format: Either `plain` for plain text or `wiki` to interpret the content as WikiFormatting.
    84  * '''time''': Date and time picker. (''Since 1.1.1.'')
     85 * '''time''': Date and time picker. (//Since 1.1.1//)
    8586   * label: Descriptive label.
    8687   * value: Default date.
     
    119120test_five = radio
    120121test_five.label = Radio buttons are fun
    121 test_five.options = uno|dos|tres|cuatro|cinco
     122test_five.options = |uno|dos|tres|cuatro|cinco
    122123test_five.value = dos
    123124
     
    144145}}}
    145146
    146 '''Note''': To make a `select` type field optional, specify a leading `|` in the `fieldname.options` option.
     147'''Note''': To make a `select` type field optional, specify a leading `|` in `fieldname.options` (e.g. `test_five`).
    147148
    148149=== Reports Involving Custom Fields
     
    178179Note in particular the `LEFT OUTER JOIN` statement here.
    179180
    180 Note that if your config file uses an '''uppercase''' name:
     181Note that option names in trac.ini are case-insensitive, so even if your option name includes uppercase characters:
    181182{{{#!ini
    182183[ticket-custom]
    183 
    184184Progress_Type = text
    185185}}}
    186 you would use '''lowercase''' in the SQL: `AND c.name = 'progress_type'`.
     186you must use '''lowercase''' in the SQL: `AND c.name = 'progress_type'`.
    187187
    188188----