| 1 | [[PageOutline(2-5,Contents,pullout)]] |
| 2 | |
| 3 | = Time estimation and tracking |
| 4 | |
| 5 | == Description |
| 6 | |
| 7 | This plugin supports time tracking by adding the following to Trac: |
| 8 | * A ''Tasks'' admin panel, where tasks can be created and assigned a time estimate. |
| 9 | * A ''Log'' admin panel, where users can log the time they spend on these tasks. |
| 10 | * A new permission `TIME_TRACKING` that is required to use these panels. |
| 11 | * Two new database tables (to store these tasks and log entries). |
| 12 | |
| 13 | Trac's reporting module can be used to define various reports that summarize these tasks and log entries. For reporting purposes tasks can be grouped into ''projects'' and ''categories'', and log entries can record a ''location''. |
| 14 | |
| 15 | Tasks are created and estimated per ''year''. |
| 16 | |
| 17 | (There is ''no'' formal connection between tasks and tickets. Informally wiki-links to tickets can be entered in the task or log descriptions.) |
| 18 | |
| 19 | == !Bugs/Feature Requests |
| 20 | |
| 21 | Existing bugs and feature requests for TimeTrackingPlugin are |
| 22 | [report:9?COMPONENT=TimeTrackingPlugin here]. |
| 23 | |
| 24 | If you have any issues, create a |
| 25 | [http://trac-hacks.org/newticket?component=TimeTrackingPlugin&owner=lucid new ticket]. |
| 26 | |
| 27 | == Download |
| 28 | |
| 29 | Download the zipped source from [export:timetrackingplugin here]. |
| 30 | |
| 31 | == Source |
| 32 | |
| 33 | You can check out TimeTrackingPlugin from [http://trac-hacks.org/svn/timetrackingplugin here] using Subversion, or [source:timetrackingplugin browse the source] with Trac. |
| 34 | |
| 35 | == Installation |
| 36 | |
| 37 | Installation of the plugin requires the usual step, e.g. easy_install `http://trac-hacks.org/svn/timetrackingplugin/trunk` and enable it in Trac's plugin admin page or by adding `timetracking.* = enabled` to the `[components]` section in trac.ini. |
| 38 | |
| 39 | A database upgrade will be required as usual (`trac-admin path-to-your-trac-environment upgrade`). |
| 40 | |
| 41 | Assign the new `TIME_TRACKING` permission to the appropriate Trac groups / users (e.g. in Trac's permission admin page). |
| 42 | |
| 43 | == Recent Changes |
| 44 | |
| 45 | [[ChangeLog(timetrackingplugin, 3)]] |
| 46 | |
| 47 | == !Author/Contributors |
| 48 | |
| 49 | **Author:** [wiki:lucid] [[BR]] |
| 50 | **Maintainer:** [[Maintainer]] [[BR]] |
| 51 | **Contributors:** |