= [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. After installing the TracHoursPlugin, you should be able to see its functionality by going to the '''Hours''' tab on the nav bar: [[Image(nav.png, border=1)]] == Adding Hours to a Ticket == [wiki:TracHoursPlugin 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`. [[Image(newticket.png, border=1)]] For an existing ticket, the `Total Hours` field will be a link to the [wiki:TracHoursPlugin TracHours] screen for that ticket: [[Image(ticket.png, border=1)]] 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'''