Changes between Version 48 and Version 49 of WikiTicketCalendarMacro

Jul 31, 2010 2:42:11 PM (4 years ago)

updated information according to latest feature releases


  • WikiTicketCalendarMacro

    v48 v49  
    88screenshot of WikiTicketCalendarMacro 1.2.0 for Trac 0.12 with different localizations (wikipage links and CSS style ticket tooltip) 
    10 Versions compatible with Trac 0.11, 0.12 and even for old 0.10 are available now, so test, enjoy and report back any issue, please. 
     10The ticket 'list_condense' feature looks something like [attachment:wikiticketcalendar_screenshot_1-2-1.png this]. Comments welcome. 
     12Available versions are compatible with Trac 0.11, 0.12 and even the old 0.10 (depreciated/unmaintained, security concerns - see #7239). 
     13Get it, enjoy and report back any issue, please. 
    1215== Bugs/Feature Requests == 
    1720If you have any issues that is not found [query:component=WikiTicketCalendarMacro&order=priority there], create a  
    1821[/newticket?component=WikiTicketCalendarMacro&owner=rjollos new ticket]. 
    20 Version 1.2.1dev includes a new feature proposed in Ticket #7410. This looks something like [attachment:wikiticketcalendar_screenshot_1-2-1.png this]. Comments welcome. 
    2223== Download == 
    5556Excerpt of the source documentation: 
    57     Usage 
    58     ----- 
     58    Simple Usage 
     59    ------------ 
    5960    [[WikiTicketCalendar([year,month,[showbuttons,[wiki_page_format, 
    60         [show_ticket_open_dates,[wiki_page_template]]]]])]] 
     61                          [show_ticket_open_dates,[wiki_page_template, 
     62                          [query_expression,[list_condense]]]]]]])]] 
    6264    Arguments 
    6365    --------- 
    64     year, month = display calendar for month in year ('*' for current year/month) 
     66    year, month = display calendar for month in year 
     67                  ('*' for current year/month) 
    6568    showbuttons = true/false, show prev/next buttons 
    6669    wiki_page_format = strftime format for wiki pages to display as link 
    67                        (if there is not a milestone placed on that day) 
    6870                       (if exist, otherwise link to create page) 
    6971                       default is "%Y-%m-%d", '*' for default 
    7072    show_ticket_open_dates = true/false, show also when a ticket was opened 
    7173    wiki_page_template = wiki template tried to create new page 
     74    list_condense = ticket count limit to switch off ticket summary display 
     76    Advanced Use 
     77    ------------ 
     78    [[WikiTicketCalendar([nav=(0|1)],[wiki=<strftime-expression>], 
     79        [cdate=(0|1)],[base=<wiki_page_template>],[query=<TracQuery-expr], 
     80        [short=<integer-value>])]] 
     82     - equivalent keyword-argument available for all but first two arguments 
     83     - mixed use of keyword-arguments with simple arguments permitted, 
     84       but strikt order of simple arguments (see above) still applies while 
     85       keyword-arguments in-between do not count for that positional mapping, 
     86     - query evaluates a valid TracQuery expression based on any ticket field 
     87       including multiple expressions grouped by 'and' and 'or'  
    7389    Examples 
    7995    [[WikiTicketCalendar(2006,07,true,*,true)]] 
    8096    [[WikiTicketCalendar(2006,07,true,Meeting-%Y-%m-%d,true,Meeting)]] 
     97    [[WikiTicketCalendar(wiki=Talk-%Y-%m-%d,base=Talk)]] 
     98     equivalent to [[WikiTicketCalendar(*,*,true,Talk-%Y-%m-%d,true,Talk)]] 
     99    [[WikiTicketCalendar(wiki=Meeting-%Y-%m-%d,query=type=task&owner=wg1)]] 
     100    [[WikiTicketCalendar(wiki=Meeting_%Y/%m/%d,short=6)]] 
    94114draft=""          same as 'wiki_page_template' 
    95115query="id!=0"     see below 
     116short=0           same as 'list_condense', total ticket count per day, that'll have 
     117                  ticket list display condensed to just ticket no., 0 = never condense list 
    97119The ''query'' keyword supports any expression supported by TracQuery. This is the single new ticket selection logic that can use custom field values as well as expressions chained by AND (OR since 0.12 only). An invalid expression was chosen on purpose to select and show all tickets by default. Use your own query expression to create per-developer or per-component ticket calendars, or you could choose to display tickets only with high/highest priority, tickets with some special content in a custom field, etc.