[[PageOutline(2-5,Contents,pullout)]]

= Display complete ticket hierarchy for ChildTicketsPlugin tickets

== Description

The macro is specifically for use with the ChildTicketsPlugin. In tickets with children, only immediate children of that parent are displayed. This macro addresses that issue by printing a whole tree (the complete hierarchy) of child tickets.

== Bugs/Feature Requests

Existing bugs and feature requests for ChildTicketTreeMacro are 
[report:9?COMPONENT=ChildTicketTreeMacro here].

If you have any issues, create a 
[/newticket?component=ChildTicketTreeMacro new ticket].

[[TicketQuery(component=ChildTicketTreeMacro&group=type,format=progress)]]

== Download

Download the zipped source from [download:childtickettreemacro here].

== Source

You can check out ChildTicketTreeMacro from [http://trac-hacks.org/svn/childtickettreemacro here] using Subversion, or [source:childtickettreemacro browse the source] with Trac.

== Examples

Used alone in a ticket field, will take the current ticket as the top level and print the tree:
{{{
[[ChildTicketTree]]
}}}

Can be used in any wiki page anywhere and provides a tree for ticket with id '#1' ('1' ie. without '#' also accepted):
{{{
[[ChildTicketTree(#1)]]
}}}

The ticket number can also be explicitly given as an argument:
{{{
[[ChildTicketTree(ticket=1)]]
}}}

Include the parent ticket in the output (default:false):
{{{
[[ChildTicketTree(root=true)]]
}}}

Print the child ticket tree list within a border (actually a fieldset, the 'legend' is not modifiable):
{{{
[[ChildTicketTree(border=true)]]
}}}

== Recent Changes

[[ChangeLog(childtickettreemacro, 3)]]

== Author/Contributors

'''Author:''' [wiki:walnut] [[BR]]
'''Maintainer:''' [[Maintainer]] [[BR]]
'''Contributors:'''