wiki:WorkLogPlugin

Track time spent on tickets

Description

This is a plugin that adds a Work Log capability to Trac.

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

Work stopped:

Work started:

Stop work:

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.

Work log page:

Work log user page:

Several options can be configured from the Admin page:

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. Perhaps integrate graphs etc. from PSP and TSP development models.

Bugs/Feature Requests

Existing bugs and feature requests for WorkLogPlugin are here.

If you have any issues, create a new ticket.

defect

49 / 66

enhancement

6 / 24

task

2 / 5

Download

You can download the zipped source.

Source

You can check out WorkLogPlugin from here using Subversion, or browse the source with Trac.

Installation

  1. Install the plugin, see details here.
  2. Enable the plugin: add the following to your trac.ini file:
    [components]
    worklog.* = enabled
    
    Alternatively, this can be enabled in the Web Admin section of your Trac website.
  3. Run $ trac-admin /path/to/projenv upgrade to upgrade the Trac environment. 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.
    
  4. Reload or restart your webserver, for example httpd or tracd.

Configuration

To enable the automatic updating of your Total Hours field when using the TimingAndEstimationPlugin, you will need this configuration value:

[worklog]
timingandestimation = true

To enable the automatic updating of your Total Hours field when using the TracHoursPlugin, you will need this configuration value:

[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

15699 by rjollos on 2016-08-15 08:28:14
1.0dev: Add license text

Refs #12845.

15698 by rjollos on 2016-08-15 08:27:33
1.0dev: Add file headers

Refs #12845.

15321 by rjollos on 2016-02-18 00:55:11
Remove tag_svn_revision

The attribute isn't supported in setuptools >= 10.

(more)

Author/Contributors

Author: coling
Maintainer: Colin Guthrie
Contributors: rjollos

Last modified 7 weeks ago Last modified on Aug 11, 2016, 9:47:16 PM

Attachments (6)

Download all attachments as: .zip