[[PageOutline(2-5,Contents,pullout)]] = 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 [[BR]] [[BR]] [[Image(screen2.jpg)]] [[BR]] '''The ticket tree, completely expanded''' [[BR]] [[BR]] [[Image(screen1.jpg)]] [[BR]] '''The ticket tree, partially collapsed''' [[BR]] [[BR]] == 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. [[BR]] [[BR]] [[Image(screen3.jpg)]] [[BR]] '''Searching for the "process" string in ticket titles''' [[BR]] [[BR]] == 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 [http://trac.edgewall.org/wiki/TracQuery 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. [[BR]] [[BR]] [[Image(screen4.jpg)]] [[BR]] '''Opening a new ticket in a specific category using the "open ticket" link''' [[BR]] [[BR]] == 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 [http://trac-hacks.org/newticket?component=TicketTreePlugin&owner=seccanj new ticket]. Existing bugs and feature requests for TicketTreePlugin are [report:9?COMPONENT=TicketTreePlugin here]. [[TicketQuery(component=TicketTreePlugin,format=table,col=summary|status|severity|priority|milestone|type|owner|time|description)]] == 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 == [[ChangeLog(tickettreeplugin, 3)]] == Author/Contributors == '''Author:''' [wiki:seccanj] [[BR]] '''Maintainer:''' [wiki:seccanj] [[BR]] '''Contributors:'''