[[PageOutline(2-5,Contents,pullout)]] = Ticket Tree for Trac == Description This is a Trac plugin to display tickets in a tree, organized based on structured ticket titles. Have you 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. With this categorization you can 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 parentheses. For example, the following query will display only tickets in the "new" status: {{{ [[TicketTree(status=new)]] }}} You can use the usual [t: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 an "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 performs the query again and updates the tree. == Bugs/Feature Requests If you have any issues, create a [/newticket?component=TicketTreePlugin new ticket]. Existing bugs and feature requests for TicketTreePlugin are [report:9?COMPONENT=TicketTreePlugin here]. [[TicketQuery(component=TicketTreePlugin&group=type,format=progress)]] == Download * Project web page on !SourceForge.net: http://sourceforge.net/projects/tickettree/ * Project web page on Pypi: [pypi:TicketTree] == Installation General instructions on installing Trac plugins can be found on the [TracPlugins#InstallingaTracplugin TracPlugins] page. == 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:''' [[Maintainer]] [[BR]] '''Contributors:'''