Changes between Version 55 and Version 56 of TagsPlugin


Ignore:
Timestamp:
Dec 4, 2011 1:36:25 AM (3 years ago)
Author:
AdrianFritz
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 ===