= Ticket list in a box on the wiki page = == Description == {{{ #!html }}} 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: 'query' format is not yet supported. == 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 == These example shows the simple list of tickets by specifiying ticket numbers. '#' character can be omitted: {{{ [[TicketBox(#1,#7,#31)]] [[TicketBox(1,7,31)]] }}} These examples lists the tickets from the report result. Second examplesh uses dynamic variable 'COMPONENT'. The special variable 'USER' is always avaiable and it is your login name (or 'anonymous' if not logged in). You can override the variable 'USER' like third example. {{{ [[TicketBox({1})]] [[TicketBox([report:1])]] [[TicketBox([report:9?COMPONENT=TicketBox])]] [[TicketBox([report:9?USER=foo])]] }}} The combination of above is allowed. The tickets are listed as sorted and uniq'ed: {{{ [[TicketBox({1},#50,{2},100)]] }}} 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 single or double quote. You can also embed the number of tickets by '%d' in title string like third example: {{{ [[TicketBox('Related Tickets',#1,#2)]] [[TicketBox("Related Tickets",#1,#2)]] [[TicketBox("There are %d tickets",{1})]] }}} If you do not make box floating, put the 'inline' argument. The box is placed in the text. If you want to show with summary string, put 'summary' argument: {{{ [[TicketBox({1},inline)]] [[TicketBox({1},summary,inline)]] }}} == Author/Contributors == '''Author:''' [wiki:gotoh gotoh] [[BR]] '''Contributors:''' [[TagIt(macro,gotoh,example,0.9,0.10,0.11)]] [[ChangeLog(ticketboxmacro)]]