= Work Log Plugin for Trac =

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

If the TimingAndEstimationPlugin is installed then when you clock off, the time spent on the ticket will be recorded (NOT YET IMPLEMENTED)

If you visit the ''Work Log'' page (a new navigation 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.

This is very early days and there are no doubt bugs due to lack of error checking!

== TODO ==

 * Tidy up some of the code (move some SQL to utility functions)
 * XMLRPC Extension point
 * Automatic addition of hours to the ticket (integration with TimingAndEstimationPlugin)
 * Leave comments on tickets when starting/stopping work (optional + integrated with above for stopping)
 * Ajax based popup reminders when viewing Trac (keeps you informed)
 * Develop Companion Desktop Application as per #1667


== 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 new ticket].

== Download ==

Download the zipped source from [download:worklogplugin here].

== Source ==

You can check out WorkLogPlugin from [http://trac-hacks.org/svn/worklogplugin here] using Subversion, or [source:worklogplugin browse the source] with Trac.

== Example ==

To be completed.

== Recent Changes ==

[[ChangeLog(worklogplugin, 3)]]

== Author/Contributors ==

'''Author:''' [wiki:coling] [[BR]]
'''Contributors:'''