Version 75 (modified by Steffen Hoffmann, 6 years ago) (diff)

announce tractags-0.7 release, adding another major code contributor to out list as well


tractags-0.7 release
Version 0.6 is a complete rewrite for Trac 0.11. This page documents that version. Refer to TagsPlugin/0.5? for information on older versions of the plugin. Also works on Trac 0.12.


  • work towards release tractags-0.8

A Tagging System for Trac

The TagsPlugin implements both a generic tagging engine, and front ends for the Wiki and ticket systems. An extra text entry box is added to the Wiki edit page for tagging Wiki pages, and ticket fields (you can configure which ones) are treated as tags for the ticket system.

The TagsPlugin was originally created by Muness Alrubaie but has since been completely rewritten by Alec Thomas, and now maintained by hasienda.

Have a look at some other hacks, that may fit well and complement your TagsPlugin installation nicely.

What are tags?

Tags allow you to organize wiki entries under multiple categories, not just under one hierarchy. You can then search for wiki entries categorized under a tag or a collection of tags. In other words, tags provide a faceted classification system for the Trac wiki.

As an added bonus, tags are linked to the wiki entry of the same name, allowing you to describe them explicitly under the wiki entry of the same name. This allows for a flexible means for establishing the context of wiki entries. Besides this, tags also make it incredibly easy to create todo lists or indexes.

Tags don't have to be predefined. As long as there are wiki entries categorized under a tag, it'll be automatically created.

Tags are similar to labels in gmail, tags in the social bookmark manager and Flickr. They are substantially different from Wikipedia categories, because tags are associated with wiki entries of the same name, whereas WikiMedia Categories are just indexes.

This implementation of wiki tagging is specific to Trac. To stay consistent with the way Trac names wiki entries, tags are case sensitive. Trac Hacks itself makes extensive use of tagging and is a good example of their use.


Apply tags

To create a tag, follow these steps:

  1. Go to the wiki entry you want to tag.
  2. Click on Edit This Page
  3. Under Change information, Tag under:, enter the tags you want to categorize the entry under. Separate tags with spaces.
  4. Click Save changes.

The wiki entry you edit is now categorized under the tags you specified.

Almost equivalent steps for tag entry at tickets, usually under keywords field.

Remove tags

To remove a tag from a wiki entry, follow these steps:

  1. Go to the wiki entry you want to untag.
  2. Click on Edit This Page
  3. Under Change information, Tag under:, remove the tag from the list.
  4. Click Save changes.

Almost equivalent steps for tag removing at tickets, usually under keywords field.

Searching tags

Querying is implemented through the /tags uri handler, the tag:<tag> syntax or WikiMacros as follows.

Tags query

Both the ListTagged macro and the /tags handler use a basic query language for filtering tagged objects. Query contains the terms to filter, can have some logical operators and have restrictions for where to search:

  1. Space-separated terms logically ANDs them together.
  2. Operators supported by the query language are:
orLogical or
notLogical not
realm:<realm>Restrict to tags in <realm> where realm is wiki, ticket, etc.
  1. Sub-expressions can be grouped inside parentheses (, ).
  2. Expressions and individual tags can be quoted with single ' or double " quotes. (check #3624)
  1. Intersection of macro and plugin tags: tagged:"macro plugin"
  2. Union of macro and plugin tags: tagged:"macro or plugin"
  3. Objects tagged macro or plugin, and example tagged:"(macro or plugin) example"

/tags handler

Going 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. This accepts all the parameters that the ListTagged macro does. e.g.

tag:<tag> or tagged:<query>

Both forms are identical and link to the tag search results for the query.

  • tagged:todo or tagged:"plugin macro".

ListTagged macro

This will display a list of resources whose tags match <query>.

  • v0.6 -> [[ListTagged([realm:<realm> ]<query>)]]
  • v0.7 -> [[ListTagged([realm:<realm> ]<query>[,format=...][,cols=...])]]
Argument Version Description & Details Default
realm:<realm> 0.6 Optional. Restrict tags search to a specific <realm> where <realm> is wiki or ticket (accepts only one realm). realm:ticket
<query> 0.6 Displays a list of resources whose tags match <query> None
format 0.7 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
cols 0.7 Rendering Option. A pipe (|) separated list of columns to show when used format=table option. Available options are:
* realm - identifies to which realm the resource is (wiki or ticket);
* id - shows the name of the wiki page (if resource is a wiki) or ticket number (if resource is a ticket);
* description - first title (if resource is a wiki) or ticket summary (if resource is a ticket);
* tags - all applied tags for such resource
  • Intersection of macro and plugin tags: [[ListTagged(macro plugin)]]
  • All resources tagged macro but not plugin: [[ListTagged(macro -plugin)]]
  • Tickets tagged with macro: [[ListTagged(realm:ticket macro)]]
  • Pages tagged with macro: [[ListTagged(realm:wiki macro)]]

TagCloud macro


Display a cloud of all tags. Optional keyword arguments:

Whether the tag cloud should be sorted case-sensitive.
Optional integer threshold to hide tags with smaller count.

Optional query expressions including realm selection are supported as shown for ListTagged. Between v0.6 and v0.7 something like [[TagCloud(-Dummy)]] was strictly required as work-around, assuming you did not use the Dummy tag.


Generic installation guidelines are troubleshooting can be found at TracPlugins.

Note before upgrading
older TagsPlugin configuration must be removed. In particular = disabled and default_handler = TagsWikiModule.

Steps to install and configure this plugin:

  1. Install
    • Dependencies: none
    • Plugin: tractags-0.7 is required for Trac >= 1.0 (see #9521)
      1. Manually:
        1. Download tags: [download:tagsplugin/tags/0.7] or grab the source from SVN.
        2. Build and install an egg from this source.
      2. with easy_install:
        $ sudo easy_install
  2. Configure
    • Tags v0.6 vastly simplified the configuration to the point where there are only two options under the [tags] section:
      1. ignore_closed_tickets = <bool>
        • Whether to gather tags from closed tickets.
      2. ticket_fields = <field>[, <field> ...]
        • Ticket fields from which to gather tags. Defaults to keywords. Custom fields are currently not supported.
    • Example:
      ignore_closed_tickets = true
      ticket_fields = component, keywords, milestone
    • For v0.7, after install see the TracIni page for the available configuration options.
      • Especially you may want to alter the following list of realms, you enable tag change records (default: wiki-only as shown here):
        revisable_realms = wiki
  3. Enable
    • Update your TracIni file (..../trac.ini) with:
      tractags.* = enabled
  4. Run on your Trac environment
    $ trac-admin <env> upgrade
  5. Restart web server:
    $ sudo /etc/init.d/apache2 restart
  6. Grant TAGS_VIEW and TAGS_MODIFY permissions to your users according to the policies that you'd like to implement. Permissions are assigned since v0.7 for a new install to anonymous and authenticated users respectively, and you'll only need to adjust that to your needs.
  7. 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.

About i18n/l10n support

Since 0.7 this plugin is prepared for localization.

But English message texts are still the (POSIX) default. If this isn't your preferred language, you can

  1. look, if it's already available from the Trac plugin l10n project at Transifex or
  2. do it yourself (see the l10n cookbook page for Trac plugins for more details).

You've done a new translation? Superb! Contributing your translation is highly appreciated.

You could send it to the plugin's maintainer or contribute to Trac plugin l10n project via Transifex:

Top translations: Trac_Plugin-L10N » tractags

Kindly provided by

Preparing the plugin from source requires no additional steps for compiling message catalog files. Only to include translations marked as # fuzzy by the translator, you'll want to do a manual message catalog compilation with the extra -f argument before packaging:

cd tagsplugin/
python ./ compile_catalog -f
python ./ bdist_egg

Due to a known Trac issue Babel has to be installed prior to Trac, to get it all working as expected.
Again, for more details see the l10n cookbook page for Trac plugins.

Bugs & Feature Requests

total issue record:

open issues by type:


0 / 15


0 / 1

Check existing bugs and feature requests first, please. If you have additional issues, you're welcome to ask at our mailing-list to confirm proper local install and configuration. Only create a new ticket, if you're reasonably sure, that it will be a valid defect report or a generally useful enhancement. Thanks for taking care.

Source & Download

You can check out TagsPlugin from here using Subversion, or browse the source with Trac.

You can also download the zipped source from [download:tagsplugin here].

Most Recent Changes

17659 by rjollos on 2020-01-22 21:55:05
TracTags 0.12dev: Use proper context manager

Patch by ealtmann.

Refs #12137, Fixes #13734.

17575 by rjollos on 2019-11-21 17:44:04
TracTags 0.12dev: Bump version after release

pypi:TracTags/0.11 has been published.

Fixes #13658.

17574 by rjollos on 2019-11-21 17:37:34
TracTags 0.11dev: Add classifiers metadata

Refs #13658.


See more


Author: athomas
Maintainer: hasienda
Contributors: hasienda, itamarost, jun66j5, osimons, rjollos

Attachments (1)

Download all attachments as: .zip