[[PageOutline(2-5,Contents,pullout)]] = Track time spent on tickets = == Description == This is a plugin that adds a Work Log capability to Trac. Basically, it allows you to register the fact you have ''started work'' on a ticket, which effectively allows you to ''clock on'' and ''clock off''. It uses javascript to add a button to the ticket page to allow you to start/stop working on a given ticket. Work can only be started by the user to which the ticket is assigned, which means there is also a limitation that only one user can work on a particular ticket (see #1943). [[Image(TicketPage-WorkStopped.png)]] [[Image(TicketPage-WorkStarted.png)]] [[Image(TicketPage-StopWork.png)]] If the TimingAndEstimationPlugin is installed then when you clock off, the time spent on the ticket will be recorded. If you visit the ''Work Log'' page (a new mainnav entry), you will see a list of people (developers) and which tickets they are currently working on. Work log events are also logged to the Timeline for a historical view. [[Image(WorkLogPage.png)]] [[Image(WorkLogUserPage.png)]] Several options can be configured from the Admin page. [[Image(WorkLogAdminPage.png)]] == TODO == * XMLRPC Extension point * Ajax based popup reminders when viewing Trac (this is perhaps not needed as there is a view at the top of all ticket pages.) * Develop Companion Desktop Application as per #1667 * Add a Developer Work Profile to graphically show how "utilized" a developer is! Root out the lazy! (Perhaps integrate graphs etc. from PSP and TSP development models) == Bugs/Feature Requests == Existing bugs and feature requests for WorkLogPlugin are [report:9?COMPONENT=WorkLogPlugin here]. If you have any issues, create a [http://trac-hacks.org/newticket?component=WorkLogPlugin&owner=coling&cc=rjollos new ticket]. == Source == You can [download:worklogplugin download zipped source], check out WorkLogPlugin from [http://trac-hacks.org/svn/worklogplugin here] using Subversion, or [source:worklogplugin browse the source] with Trac. == Installation == 1. Install the plugin, see [trac:TracPlugins details here]. 1. Be sure that the plugin is enabled. Add "worklog.* = enabled" to trac.ini (in the [components] subheading). * Alternatively, this can be enabled in the Web Admin section of the website as well 1. Run `$ trac-admin /path/to/projenv upgrade` * You should get a message like this: {{{ Work Log needs an upgrade Upgrading Database Creating work_log table Upgrading usermanual Done upgrading Work Log Upgrade done. }}} * If your database was not upgraded, make sure that you have the correct genshi version: {{{easy_install http://svn.edgewall.org/repos/genshi/trunk}}} 1. Reload/restart your HTTPD / other webserver / Tracd. That's it. == Configuration == In order to enable the automatic updating of your '''Total Hours''' field when using the TimingAndEstimationPlugin you will need this configuration value: {{{ #!ini [worklog] timingandestimation = true }}} In order to enable the automatic updating of your '''Total Hours''' field when using the TracHoursPlugin you will need this configuration value: {{{ #!ini [worklog] trachoursplugin = true }}} Other configuration values (found in source:worklogplugin/trunk/worklog/manager.py) include: * autostopstart - bool * autoreassignaccept - bool * comment - bool * timingandestimation - bool * roundup - int == Recent Changes == [[ChangeLog(worklogplugin, 3)]] == Author/Contributors == '''Author:''' [wiki:coling] [[BR]] '''Maintainer:''' [wiki:coling] [[BR]] '''Contributors:''' [wiki:rjollos] [[BR]] '''License:''' MIT