Version 11 (modified by Jeff Hammel, 9 years ago) (diff)


TracHours HOWTO

how to use the TracHoursPlugin to keep track of time


The TracHoursPlugin is designed to help tally time which is spent working on trac tickets.

After installing the TracHoursPlugin, you should be able to see its functionality by going to the Hours tab on the nav bar:

TracHours introduces two new screens, at /hours (the query view) and /hours/<ticket number> (the hours view for that ticket). TracHours also modifies the ticket screen to display estimated and total hours (see below) and the roadmap view to compute the hours:

Adding Hours to a Ticket

TracHours adds two custom fields to tickets: Estimated Hours and Total Hours. Estimated Hours can be updated as a typical custom field, though only numerical values are accepted. Total Hours is a computed field and cannot be updated from the ticket page. When you make a new ticket, Total Hours will be 0.

For an existing ticket, the Total Hours field will be a link to the TracHours screen for that ticket:

As an example for ticket 1, this will link to /hours/1. Going to this screen will allow you to verbosely see, add to, and edit the hours for a ticket:

If you have TRAC_ADMIN permission (as shown), you can add hours for any user. Otherwise you will only be able to add hours as yourself (contingent upon the TICKET_ADD_HOURS permission). If you are not logged in, you can view hours but not add them. You can also edit existing hours from this screen. If you add hours with a description, the addition will be logged to the ticket comments and appropriate notifications will be sent.

Viewing Hours for Several Tickets

Clicking on the Hours tab in the navigation bar or going to /hours gives a screen where the hours for all tickets can be queried and tallied. The '/hours' screen is designed to mimic the trac custom query screen in terms of look and feel, except that what is being queried over are tickets with hours. The hours (both estimated and tracked) are totaled above the ticket query results.

<- back to TracHoursPlugin wiki page

Attachments (6)

Download all attachments as: .zip