Changes between Version 55 and Version 56 of TagsPlugin


Ignore:
Timestamp:
Dec 4, 2011, 12:36:25 AM (12 years ago)
Author:
Adrian Fritz
Comment:

Returning to "<realm>" as discused @ #9064. Detail cols option. Other minor cosmetic enhancements

Legend:

Unmodified
Added
Removed
Modified
  • TagsPlugin

    v55 v56  
    8080Going to /tags under your project will show a list of all tags in the wiki.  /tags/?q=<query> will show all the objects matching ''<query>''.  e.g. [http://trac-hacks.org/tags/?q=plugin]. This accepts all the parameters that the !ListTagged macro does.  e.g. [http://trac-hacks.org/tags?q=plugin%20or%20macro].
    8181
    82 ==== `tag:<tag>` or `tagged:<query>` Usage ====
     82==== `tag:<tag>` or `tagged:<query>` ====
    8383
    8484Both forms are identical and link to the tag search results for the query.
     
    9090
    9191This will display a list of resources whose tags match `<query>`.
    92  * Version 0.6 -> `[[ListTagged([realm:<resource> ]<query>)]]`
    93  * Version dev -> `[[ListTagged([realm:<resource> ]<query>[,format=...][,cols=...])]]`
     92 * Version 0.6 -> `[[ListTagged([realm:<realm> ]<query>)]]`
     93 * Version 0.7dev -> `[[ListTagged([realm:<realm> ]<query>[,format=...][,cols=...])]]`
    9494
    9595||'''Argument''' || '''Version''' || '''Description & Details''' || '''Default''' ||
    96 || `realm:<resource>` || 0.6 ||''Optional.'' Restrict tags search to a specific `<resource>` where `<resource>` is `wiki` or `ticket` (accepts only one resource). ||`realm:ticket` ||
     96|| `realm:<realm>` || 0.6 ||''Optional.'' Restrict tags search to a specific `<realm>` where `<realm>` is `wiki` or `ticket` (accepts only one realm). ||`realm:ticket` ||
    9797|| `<query>`         || 0.6 ||Displays a list of resources whose tags match `<query>`|| `None` ||
    9898|| `format`        || 0.7dev ||''Rendering Option.'' `oldlist` or `short` list in known !ListTagged style; `compact` - list with results shortend to just the description; `table` - table view similar to !TicketQuery with 'table' option || `short` ||
    99 || `cols`          || 0.7dev ||''Rendering Option.'' Use together with `format=table` to select which columns to show . || `cols=id|description|tags` ||
     99|| `cols`          || 0.7dev ||''Rendering Option.'' A pipe (`|`) separated list of columns to show when used `format=table` option. Available options are:[[BR]] * `realm` - identifies to which realm the resource is (wiki or ticket);[[BR]] * `id` - shows the name of the wiki page (if resource is a wiki) or ticket number (if resource is a ticket); [[BR]] * `description` - first title (if resource is a wiki) or ticket summary (if resource is a ticket);[[BR]] * `tags` - all applied tags for such resource || `cols=id|description|tags` ||
    100100
    101101 Examples::
     
    137137          * Whether to gather tags from closed tickets.
    138138      1. `ticket_fields = <field>[, <field> ...]`
    139           * eg. `ticket_fields = component, keywords`.
    140139          * Ticket fields from which to gather tags. Defaults to `keywords`. Custom fields are currently not supported.
     140    * Example:
     141{{{
     142[tags]
     143ignore_closed_tickets = true
     144ticket_fields = component, keywords, milestone
     145}}}
    141146 1. '''Enable'''
    142147    * Update your TracIni file (`..../trac.ini`) with:
     
    156161    }}}
    157162 1. '''Grant''' `TAGS_VIEW` and `TAGS_MODIFY` permissions to your users according to the policies that you'd like to implement.
    158  
    159 
    160 At this stage the plugin should be working and you should see a text control for
    161 tags in your Wiki edit page. You should also see an entry in the main navigation
    162 bar labeled ''Tags''.
     163 1. '''Test'''   At this stage the plugin should be working and you should see a text control for tags in your Wiki edit page. You should also see an entry in the main navigation bar labeled ''Tags''.
    163164
    164165=== About i18n/l10n support ===