Ticket list in a box on the wiki page


This macro displays the list of ticket numbers in a box on the right side of the page compactly. You can specify the tickets explicitly or use the result of reporting. The tickets will be displayed as sorted and uniq'ed. An example image is shown on the right of this page.

Note: The 'query' format is not yet supported, see TicketQuery.

This macro is unified for several Trac versions (0.9, 0.10, 0.11, 0.12dev) since 2008-07-31 (r4088).

See also: TicketBoxPlugin

Bugs/Feature Requests

Existing bugs and feature requests for TicketBoxMacro are here.

If you have any issues, create a new ticket.


13 / 19


7 / 11


0 / 1


Download the zipped source from here.


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


For Trac 0.10 or before, copy to wiki-macros directory of your Trac environment or system wide wiki-macros directory.

For Trac 0.11 or later, copy to plugins directory of your Trac environment and there is no need enable this plugin explicitly. Or copy it to system wide plugins directory, then enable the TicketBox plugin via the admin page.



This example shows the simple list of tickets by specifying ticket numbers. The '#' character can be omitted:

[[TicketBox(#1, #7, #31)]]
[[TicketBox(1, 7, 31)]]

These examples list the tickets from the report result. The third example uses the dynamic variable 'COMPONENT'. The special variable 'USER' is always available and it is your login name, or 'anonymous' if not logged in. You can override the variable 'USER' like in the fourth example.


If field name of ticket id is not 'ticket' in report report definition, you can specify it by ticket=xxx:

[[Ticketbox({20}, ticket=id)]]

TracQuery style of query string can be used. And it can also be used in report definition, starting with query::


The combination of the above is allowed. The tickets are listed as sorted and uniq'ed:

[[TicketBox({1}, #50, {2}, [query:keywords~=important], 100)]]

If nosort option is specified, then the tickets are listed without sorting:

[[TicketBox(3, 2, 1, {1}, nosort)]]

Display Options

You can specify the size of the box:

[[TicketBox(500pt, {1})]]
[[TicketBox(200px, {1})]]
[[TicketBox(25%, {1})]]

You can specify the title. The value should be surrounded by a single quote (') or a double quote ("). You can also embed the number of tickets by '%d' in title string like in the third example:

[[TicketBox('Related Tickets', #1, #2)]]
[[TicketBox("Related Tickets", #1, #2)]]
[[TicketBox("There are %d tickets", {1})]]

If you do not want the box to be floating, use the inline keyword. The box is placed inline with the wiki text. If you want the ticket's summary to be displayed, use the summary keyword:

[[TicketBox({1}, inline)]]
[[TicketBox({1}, summary, inline)]]

The option nowrap forces the line not to wrap around the screen. It is useful with the summary option. If this option is specified, line length may exceeds specified width:

[[TicketBox({1}, summary, nowrap)]]

Text color, background color, border line color and float position can be specified:

[[TicketBox({1}, float=left, color=green, background=transparent, border-color=red)]]

Recent Changes

7516 by gotoh on 2010-02-09 02:38:57
Set documentation string of macro.
Now you can see macro description in WikiMacros page.
close #6591.
7508 by gotoh on 2010-02-08 08:24:14
Fix to work with trac 0.12dev.
7507 by gotoh on 2010-02-08 07:42:07
Correct plugin info introduced in last commit r7506. (#6562)
Also use the page on TracHacks as home page URL.


Author: gotoh
Maintainer: Shun-ichi Goto

Last modified 2 days ago Last modified on Oct 26, 2016, 9:16:55 PM