[[PageOutline(2-5,Contents,pullout)]]

{{{#!NewsFlash
'''Known (Confirmed) Issues'''
 * May not work with MySQL (#3088) and PostgreSQL (#3207) databases.

'''Priority Enhancements'''
 * Merge functionality into the TracMetrixPlugin.
}}}

= Repository, ticket and wiki statistics

== Description

Stractistics is a plugin designed to estimate recent project activity by providing repository, ticket and wiki statistics.

== Bugs/Feature Requests

Existing bugs and feature requests for StractisticsPlugin are [query:status!=closed&component=StractisticsPlugin&order=priority here].

If you have any issues, create a 
[/newticket?component=StractisticsPlugin new ticket].

[[TicketQuery(component=StractisticsPlugin&group=type,format=progress)]]

== Download

Download the zipped [download:stractisticsplugin source].

== 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.

== Configuration

First, enable the plugin by adding the following to your `trac.ini` file:
{{{#!ini
[components]
stractistics.* = enabled 
}}}

Then 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 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.

Right now, I'd advise against 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
}}}

== Screenshots

Project reports:

[[Image(STractistics_1209572504031.png, nolink)]]

User reports:

[[Image(STractistics_1209572554609.png, nolink)]]

== Recent Changes

[[ChangeLog(stractisticsplugin, 3)]]

== Author/Contributors

'''Author:''' Daniel Gómez Brito (dagomez) [[BR]]
'''Maintainer:''' [[Maintainer]] [[BR]]
'''Contributors:''' mixedpuppy, Manuel Jesús Recena Soto