= Ticket list in a box on the wiki page = == Description == {{{ #!html }}} 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 [report:9?COMPONENT=TicketBoxMacro here]. If you have any issues, create a [http://trac-hacks.org/newticket?component=TicketBoxMacro&owner=gotoh new ticket]. == Download == [source:ticketboxmacro/0.8/ TicketBoxMacro for 0.8].[[BR]] [source:ticketboxmacro/0.9 TicketBoxMacro for 0.9].[[BR]] [source:ticketboxmacro/0.10 TicketBoxMacro for 0.10].[[BR]] [source:ticketboxmacro/0.11 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:''' [wiki:gotoh gotoh] [[BR]] '''Contributors:''' [[TagIt(macro,gotoh,example,0.8,0.9,0.10,0.11)]]