Time Ticket


Time Ticket Documentation

Time Ticket is a very straightforward time tracking component. We initially developed Time Ticket internally as a quick and easy way to track hours spent by each of our team members on a daily basis.

Like many firms we are working on multiple projects daily and accurate time tracking becomes a bit of a challenge if we aren't documenting it frequently. However as a necessary evil we didn't want time accounting to become a burden so we created this tool to help our team members keep track. Time Ticket has given us the additional benefit of being able to easily review if we are pricing work properly so that we are attaining business and profit goals.

Our clients asked what we were using to track time and when we told them they decided they wanted it - so here you have it Time Ticket.

Getting Started

Download com_timeticket from EO MediaLabs Download(external link) and install using the Joomla! 1.5 Extension installer. If you need more detailed instruction for installing components see the page below or visit Joomla Documentation(external link) or Joomla Community Forums(external link).


Install Component

Setup Time Ticket

The main interface for the Time Ticket component is the Time Ticket Frontpage Layout which is the interface for users to input their times for Open jobs.

To create this interface open the Joomla! administrator and add a new menu, from the internal links selection choose the Time Ticket entry, and then select Time Ticket Frontpage Layout.
Setting the Parameters
Time offset in hours: This is an hour offset to adjust the date picker so that it changes day when it would be expected to. This generally accounts for the difference between server's timezone and your actual timezone.
Managing Jobs
To manage jobs open the Joomla! administrator and select Components -> Time Ticket -> Jobs.

From this interface you can add new jobs, edit jobs, and publish/unpublish jobs. Jobs are the main element for tracking time, jobs typically represent projects but can be used to reflect your organizations project and time tracking structures.

Image
Job Name: Simple text name that denotes the job.

Job Number: Internal tracking number that denotes the job.

Hours: Hours budgeted for this job.

Amount: Quoted overall price for the job, don't worry about currency type we will deal with that a bit later.

Published: If a job is NOT published it will NOT appear anywhere within any Time Ticket interfaces.

Status: Open jobs will appear in the time input interface as well as summary and detail views, Closed jobs will only appear in the summary and detail views.

Description Text: Text summary of the job.

Setup Summary

The summary interface provides a comprised view for all published jobs, sorted by Open and Closed status.

To create this interface open the Joomla! administrator and add a new menu, from the internal links selection choose the Time Ticket entry, and then select Time Ticket Summary.

NOTE: There is a Time Ticket Detail menu item also but this does not need to be created as detail views are generated as links from the Summary view.
Setting the Parameters
The summary parameters aren't related to the Summary view itself as the are inherited by the Detail views that are linked.

ImageBackground color for active accordion: Hex color code for the header of the active accordion display of detail data.

Background color for inactive accordion: Hex color code for the header of the inactive accordion display of detail data.

Width of detail table: Width value for the detail table, default is 400px.

Format for money display: PHP supported international codes for localization, for example, en_US, en_GB, it_IT, etc...

International or national display: Given the money format do you want it displayed in national or international format, for example, en_US (international: USD | national: $)

Using Time Ticket

Once you have setup a menu for the main Time Ticket interface it's time to add some jobs, once you have added jobs Time Ticket is ready for action.

ImageWhen a user is logged into to Joomla! 1.5 and they access the Time Ticket main interface they will be presented with a date picker and a list of jobs. Upon entering, the date displayed will be the current date and the jobs are organized from newest to oldest based on their entry into the jobs database.

The user can simply enter the hours they worked, for the selected date, in each job that is appropriate for that day. Users can also add a brief note for each entry to denote what might have been done in general terms. Once the user has input their hours for the selected day they simply click the SAVE TICKET button and they're done.

Users can click on the date which will pop up a javascript (mootools) date picker and choose a day and click the CHANGE DATE button. This will bring up the newly selected days data, if they have already entered data they can change it or fill in hours for other jobs that required hours for that day.

That's it! Time Ticket will accumulate hours per job per user as long as a job is Open, once the job is Closed it will no longer appear in the Time Ticket input interface.

Summary Display


ImageGenerally the summary display is set for only Administrators (or Super Administrators) so that registered users can't get at the summary data, however, we keep ours open to all our team members, but that's philosophical decision that organizations have to make.

When viewing the summary display Open jobs will be presented at the top with the total hours accumulated for all users associated with that job. Closed jobs will be presented after all of the Open jobs.

If there are hours accumulated for a job the Job Name (Job Number) is a link to the detail display for that specific job.

Detail Display

The detail display presents the general job information including the budgeted hours and monetary amount for the project.

Image
Under the general information, which was input when the job was created, Time Ticket presents a budget tracking display comparing projected hours and projected budget monies per hour against actual current reported hours and the actual monies per hour. The latter will be presented with a Green background if the job is within budget projections and a Red background if outside of projections.

Under the budget tracking display is an accordion display (mootools) of each users reported hours. Click an users name to display their hours.