[[PageOutline(2-5,Contents,pullout)]] = Repository, ticket and wiki statistics {{{#!box warn **Notice:** Flash is being deprecated in all major browsers. Please use TracMetrixPlugin as alternative plugin. }}} == Description This is a plugin that measures and graphically displays recent project activity by providing repository, ticket and wiki statistics. See below for screenshots and examples. '''Project reports''': [[Image(STractistics_1209572504031.png, border=2)]] '''User reports''': [[Image(STractistics_1209572554609.png, border=2)]] == Bugs/Feature Requests Existing bugs and feature requests for StractisticsPlugin are [report:9?COMPONENT=StractisticsPlugin here]. If you have any issues, create a [/newticket?component=StractisticsPlugin new ticket]. [[TicketQuery(component=StractisticsPlugin&group=type,format=progress)]] '''Known (Confirmed) Issues''': May not work with MySQL (#3088) and PostgreSQL (#3207) databases. == Download Download the zipped source from [export:stractisticsplugin here]. == Source Check out from [/svn/stractisticsplugin here] using Subversion, or [source:stractisticsplugin browse the source] with Trac. == Installation If you are using Python < 2.6, this plugin requires pypi:simplejson. Your web browser must support: * Javascript * Macromedia Flash Player 9 plugin. !FireFox 2.0, Internet Explorer 7 and Opera 9.25 have been successfully tested. General instructions on installing Trac plugins can be found on the [TracPlugins#InstallingaTracplugin TracPlugins] page. Also enable the plugin by adding the following to your `trac.ini` file: {{{#!ini [components] stractistics.* = enabled }}} == Configuration If you have `STRACTISTICS_VIEW` permission, a Stractistics button will appear on the navigation bar. From v0.3.0 upwards you can customize the time gap thanks to the upper-left form. Please don't set the number of weeks higher than 25, because that clutters values on the x-axis, I'll try to fix that sometime. Note that the ticket activity chart ignores the number of weeks, it only considers 30 days prior to the chosen date. * A week is Monday through Sunday. * All results are real-time, Stractistics executes a series of queries against your Trac database when the page is loaded. === Options It is possible to customize these parameters: * repository_authors_limit: Number of users displayed on the repository activity chart. Its default value is 5. * wiki_authors_limit: Number of users displayed on the wiki activity chart. Its default value is 5. * ignored_repository_authors: List of users to be ignored in the repository activity chart. User names should be comma-separated. Its default value is empty. * ignored_wiki_authors: List of users to be ignored in the wiki activity chart. User names should be comma-separated. Its default value is empty. * max_author_characters: Maximum number of author characters to be displayed on the tables. This comes in handy when dealing with long author names. Its default value is None, therefore it doesn't mangle the names at all. It is not recommended setting any of those parameters to a value greater than 8, because that leads to cluttered charts. If you wish to modify the default settings, create a new section called 'stractistics' in `trac.ini` and then add any of the parameters and its new value: {{{#!ini [stractistics] repository_authors_limit = 5 wiki_authors_limit = 7 }}} == Recent Changes [[ChangeLog(stractisticsplugin, 3)]] == Author/Contributors '''Author:''' Daniel Gómez Brito (dagomez) [[BR]] '''Maintainer:''' [[Maintainer]] [[BR]] '''Contributors:''' mixedpuppy, Manuel Jesús Recena Soto