wiki:TicketBoxMacro

Version 10 (modified by Shun-ichi Goto, 16 years ago) (diff)

Describe support of trac 0.11.

Ticket list in a box on the wiki page

Description

Display list of ticket numbers in a box on the right side of the page. The purpose of this macro is show related tickets compactly. You can specify ticket number or report number which would be expanded as ticket numbers. Tickets will be displayed as sorted and uniq'ed. An example image is shown op the right of this page.

Bugs/Feature Requests

Existing bugs and feature requests for TicketBoxMacro are here.

If you have any issues, create a new ticket.

Download

TicketBoxMacro for 0.8.
TicketBoxMacro for 0.9.
TicketBoxMacro for 0.10.
TicketBoxMacro for 0.11.

Source

You can check out the source for TicketBoxMacro from Subversion at http://trac-hacks.org/svn/ticketboxmacro.

Install

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

For trac 0.11, copy TicketBox.py to plugins directory of your trac environment (no need enable this plugin explicitly). Or copy it to system wide plugins directory then enable the TicketBox plugin via admin page.

Example

Simple list of tickets by specifiying ticket numbers. '#' character can be omitted:

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

List tickets expanded from the report result. Third example uses dynamic variable. The special variable 'USER' can be specified. If not specified, login name (or anonymous) is used:

[[TicketBox({1})]]
[[TicketBox([report:1])]]
[[TicketBox([report:9?COMPONENT=TicketBox])]]
[[TicketBox([report:9?USER=foo])]]

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

[[TicketBox({1),#50,{2},100)]]

Specifying a size of the box:

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

Specifying a title of the box. single and double quoted string are allowed. If '%d' in title string will be replaced with count of tickets:

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

Author/Contributors

Author: gotoh
Contributors:

TagIt(macro,gotoh,example,0.8,0.9,0.10,0.11)?