[[PageOutline(2-5,Contents,pullout)]] = Plot Trac Ticket Statistics == Description This plugin visualizes Trac ticket statistics. It plots the number of open tickets, the number of new tickets and the number of tickets closed over a time period. It correctly accounts for tickets being reopened and closed during the reporting period, ie by not including them in the total. This plugin uses [https://plot.ly/javascript/ plotly.js], which itself is MIT-licensed. [[Image(screenshot01.png, 60%)]] The plugin includes a macro that allows a TracQuery to be used as an arguments. This plugin can be used to visualize the progress of a project by seeing the rate of tickets being created vs. tickets being closed. Graphs can be customized. The macro allows graphs to be inserted within wiki markup. {{{ [[TicketStats(title = Total tickets last 15 days, height=250, daterange=15d, res_days=1)]] }}} {{{ [[TicketStats(title = Error tickets by week last 3 months, daterange=3m, res_days=7, query=Type='error')]] }}} The macro's arguments are: * '''title''': caption to your graph * '''height''': graph height, default 500 px. * '''column_width''': default 40 px. * '''daterange''': date range specified as "from;to" or just "to". Using Trac's 0.12 date field query syntax (trac:wiki:TracQuery?version=20#QueryLanguage). * '''res_days''': resolution in days for each point in the graph. See also TracMetrixPlugin. == Bugs/Feature Requests Existing bugs and feature requests for TracTicketStatsPlugin are [report:9?COMPONENT=TracTicketStatsPlugin here]. If you have any issues, create a [/newticket?component=TracTicketStatsPlugin new ticket]. [[TicketQuery(component=TracTicketStatsPlugin&group=type,format=progress)]] == Download Download the zipped source from [export:tracticketstatsplugin here]. == Source You can check out TracTicketStatsPlugin from [/svn/tracticketstatsplugin here] using Subversion, or [source:tracticketstatsplugin browse the source] with Trac. == Installation General instructions on installing Trac plugins can be found on the [TracPlugins#InstallingaTracplugin TracPlugins] page. Add the following to your `trac.ini` file: {{{#!ini [components] ticketstats.* = enabled }}} == Configuration The following options can be specified in `trac.ini` (default values are shown): {{{#!ini [ticketstats] ; Location of plotly.js plotly_js_url = //cdn.plot.ly/plotly-latest.min.js }}} == Recent Changes [[ChangeLog(tracticketstatsplugin, 3)]] == Author/Contributors '''Author:''' [wiki:echo0101] [[BR]] '''Maintainer:''' [[Maintainer]] [[BR]] '''Contributors:''' mixedpuppy (#3900), simon (#3921)