Project

General

Profile

PluginCharts » History » Version 2

Chris McKee, 2010-02-22 10:57
Added Windows version of script/plugin method as its different from linux/unix

1 1 Mischa The Evil
h1. Charts plugin
2
3
{{>toc}}
4
5
A Redmine plugin which integrates some project-based, time-tracking charts.
6
7
h2. Author
8
9
* Maciej Szczytowski
10
11
h2. Changelog
12
13
h3. 0.0.12
14
15
* many bug fixes ("!#6":http://github.com/mszczytowski/redmine_charts/issues/#issue/6, "!#7":http://github.com/mszczytowski/redmine_charts/issues/#issue/7, "!#8":http://github.com/mszczytowski/redmine_charts/issues/#issue/8, "!#9":http://github.com/mszczytowski/redmine_charts/issues/#issue/9, "!#10":http://github.com/mszczytowski/redmine_charts/issues/#issue/10)
16
* new conditions (trackers, priorities, versions)
17
* pages on deviations chart ("!#5":http://github.com/mszczytowski/redmine_charts/issues/#issue/5)
18
* hours logged for project and not estimated issues on deviations chart
19
20
h2. Latest release
21
22
The currently available, latest release of the plugin is version *0.0.12*.
23
24
h2. Description
25
26
The Charts plugin integrates some project-based, time-tracking charts. Most of the charts provided by this plugin depend on issues which have a certain amount of estimated time set and logged spent-time (on plugins as well as on the project itself).
27
28
h3. Chart types
29
30
In total four kinds of charts are provided by the plugin:
31
# @Burndown@
32
** Timeline with estimated, logged and remaining hours.
33
# @Logged hours ratio@
34
** Number of hours which were logged, proportional to total total, grouped and filtered by users, issues, activities, categories, version, priorities or trackers.
35
# @Logged hours timeline@
36
** Timeline with logged hours, grouped and filtered by users, issues, activities, categories, version, priorities and trackers.
37
# @Logged hours deviations@
38
** Ratio of logged and remaining hours to estimated hours for each estimated issue.
39
40
h2. Screenshots
41
42
h3. Burndown chart
43
44
!http://farm4.static.flickr.com/3487/3219872709_03a137e740_o.jpg!
45
46
h3. Logged hours ratio chart
47
48
!http://farm4.static.flickr.com/3313/3220723922_64540005a0_o.jpg!
49
50
h3. Logged hours timeline
51
52
!http://farm4.static.flickr.com/3112/3220723804_2b274e7e2f_o.jpg!
53
54
h3. Logged hours deviations
55
56
!http://farm4.static.flickr.com/3441/3219872389_4f1d105c1d_o.jpg!
57
58
h2. Compatibility
59
60
This plugin is compatible with Redmine 0.8.x as well as with the current Redmine trunk.
61
62
h2. Dependencies
63
64
This plugin relies on the "OpenFlashChart":http://pullmonkey.com/projects/open_flash_chart Rails plugin to render the charts. It can be installed into your Redmine instance using the following commands:
65
<pre>
66
$ cd {REDMINE_ROOT}
67
$ ./script/plugin install git://github.com/pullmonkey/open_flash_chart.git
68
</pre>
69 2 Chris McKee
In Windows
70
<pre>
71
cd {REDMINE_ROOT}
72
ruby script\plugin install http://github.com/pullmonkey/open_flash_chart.git
73
</pre>
74 1 Mischa The Evil
75
h2. Obtaining 
76
77
bq. URL of the GitHub repository: http://github.com/mszczytowski/redmine_charts/tree/
78
79
The source of this plugin can be "cloned" from the GitHub-repo using:
80
<pre>
81
$ cd {RAILS_ROOT}
82
$ git clone git://github.com/mszczytowski/redmine_charts.git vendor/plugins/redmine_charts
83
</pre>
84
85
h2. Installation
86
87
# Download the plugin from the available source (see "[[PluginCharts#Obtaining|obtaining]]")
88
# Install the plugin as described at: http://www.redmine.org/wiki/redmine/Plugins (this plugin does not require a plugin database migration)
89
# Restart Redmine
90
91
h2. Setup
92
93
After you have completed the installation of the plugin you can select which projects will actually be able to use the feature brought by the plugin by activating the plugin's module in the "project settings":
94
95
In the preferred Redmine project, go to the "Project settings":
96
97
* On the "Modules" tab: enable the plugin-module by checking "Charts".
98
99
After that, a new item named "Charts" will show up in the project menu. Click on this item to see the project's charts.
100
101
h2. Upgrading
102
103
# Backup the currently deployed Charts plugin (@cp -r /vendor/plugins/redmine_charts /vendor/plugins/redmine_charts-backup@)
104
# Reinstall the updated plugin:
105
** using the command: @git pull@
106
# Restart your Redmine
107
108
h2. Uninstalling
109
110
# Remove the directory _"redmine_charts"_ from the plugin-directory _"../vendor/plugins"_
111
# Restart Redmine
112
113
h2. Licensing
114
115
This plugin is open-source and licensed under the "GNU General Public License v2":http://www.gnu.org/licenses/old-licenses/gpl-2.0.html (GPL).
116
117
* ©2009, Maciej Szczytowski (http://github.com/mszczytowski/)
118
119
h2. Support
120
121
If you would like to report a bug or request a new feature you can open a new issue at the issue-tracking section of the plugins' GitHub site: http://github.com/mszczytowski/redmine_charts/issues.
122
You can also post about the plugin in the dedicated plugin-section of the "Redmine forums":http://www.redmine.org/projects/redmine/boards/3.
123
124
As an alternative you can also join the @#redmine@ channel on the "freenode":http://freenode.net/irc_servers.shtml IRC network to see if there is anyone who can provide some support.