= [wiki:TracHoursPlugin TracHours] HOWTO = 

''how to use the TracHoursPlugin to keep track of time''

== Introduction ==

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


== Adding Hours to a Ticket ==

When you make a new ticket, `Total Hours` will be `0` and not a link.

For an existing ticket, the `Total Hours` field will be a link to the [wiki:TracHoursPlugin TracHours] screen for that ticket:

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

If you have TRAC_ADMIN permission (''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.


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

'''<- back to TracHoursPlugin'''