wiki:TicketTreePlugin

Version 11 (modified by seccanj, 3 years ago) (diff)

--

Ticket Tree for Trac

A Trac plugin to display tickets in a tree, organized based on structured ticket titles.

Often struggled with thousands of Trac tickets and missing a clear picture of where the problems are?

Ticket Tree allows you to categorize your tickets based on the areas affected. Given this categorization, you can then display the tickets in a tree, getting a better picture of the areas and sub-areas with more problems. In addition to that, the tree view lets you navigate your tickets more easily.

The categorization mechanism is really simple, as it's based on the ticket title. You will use the dash '-' character to define the category and sub-categories in your tickets.

For example, giving the following title to a ticket:

User Interface - Main menu - File menu - Unable to click on the "Open File" item

will display your ticket in the tree as follows:

+ User Interface

+ Main menu

+ File menu

Unable to click on the "Open File" item



The expanded ticket tree
The ticket tree, completely expanded

The collapsed ticket tree
The ticket tree, partially collapsed

Statistics

Next to each category you will see the number of all tickets, and the detail of open and closed tickets, in that category.

Searching and Filtering

You can quickly search and filter tickets in the tree using the "Find" text box. Just start typing text in it to see your ticket tree reducing and highlighting only the tickets matching your text. You can type more than one word: only the tickets matching all of them will be displayed. Special words are "open" and "closed": they will limit the view to only open and closed tickets, respectively.



Searching and filtering
Searching for the "process" string in ticket titles

The Macro and how to use a Query

The plugin provides a macro, which lets you build custom ticket trees based on specific ticket queries. Used without any parameter, the macro will display a tree with all of the tickets.

Edit your preferred wiki page and add the following snippet to use the macro without any parameter. It will display all of your tickets.

[[TicketTree()]]

To use a query, add it in parenthesys. For example, the following query will display only tickets in the "new" status.

[[TicketTree(status=new)]]

You can use the usual Trac Query syntax for the query.

Simplified categorization

An interesting feature is the ability to open a ticket in a specific category directly from the tree. Next to each category you'll find a "open ticket" link, clicking which you will be opened the ticket creation page with the ticket's title already built with the corresponding category and sub-categories, and a place-holder for the ticket's short description to follow.



Opening a ticket on a particular category
Opening a new ticket in a specific category using the "open ticket" link

Refreshing

The "Refresh" button is useful to perform the query again and update the tree.

Change History

(Refer to the tickets on trac-hacks for complete descriptions.)

Release 0.9 (2011-06-01):

o First release publicly available.

Bugs/Feature Requests

If you have any issues, create a new ticket.

Existing bugs and feature requests for TicketTreePlugin are here.

Ticket Summary Status Severity Priority Type Owner Created Description
#9868 Error: Macro TicketTree() failed coercing to Unicode: need string or buffer, NoneType found new normal normal defect seccanj 2 years When I click on Ticket tree link or add `[[TicketTree()]]` somewhere I only see this error message: {{{ Error: Macro TicketTree() failed coercing to Unicode: need string or buffer, NoneType found }}}
#10146 Setting category via custom field, not title closed normal normal enhancement seccanj 22 months You should make it possible to specify categories by custom field. Using summary line is really inconvenient!
#10147 Setting category via custom field, not title new normal normal enhancement seccanj 22 months You should make it possible to specify categories by custom field. Using summary line is really inconvenient!

Download

Project web page on SourceForge.net: http://sourceforge.net/projects/tickettree/ Project web page on Pypi: http://pypi.python.org/pypi/TicketTree

Example

Use the provided TicketTree macro in any of your wiki pages, or navigate to the provided "Ticket Tree" tab to see the default page, and display all of your tickets (or a custom query) in a tree form.

Recent Changes

[10248] by seccanj on 2011-05-30 17:34:41
New hack TicketTreePlugin, created by seccanj

Author/Contributors

Author: seccanj
Maintainer: seccanj
Contributors:

Attachments (4)

Download all attachments as: .zip