= 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 list tickets explicitly or specify a report that generates them (to do the same with [TracQuery queries] instead of [TracReports reports], use the [trac:TicketQuery TicketQuery macro]). 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.9 TicketBoxMacro for 0.9].[[BR]] [source:ticketboxmacro/0.10 TicketBoxMacro for 0.10].[[BR]] [source:ticketboxmacro/0.11 TicketBoxMacro for 0.11]. (2008/03/28 : [source:ticketboxmacro/0.8/#2848 TicketBoxMacro for 0.8] is obsoleted.) == 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.9,0.10,0.11)]] [[ChangeLog(ticketboxmacro)]]