Getting Started with UDSSL Time Tracker

Install WordPress

You should have a WordPress installation to install UDSSL Time Tracker Plugin. If you don’ have WordPress yet, you can get the latest WordPress installation source from WordPress.org website. Follow the famous five minute installation instructions to install WordPress in your server.

Install UDSSL Time Tracker

You have a WordPress installation ready to install the Time Tracker Plugin. Download the latest version of UDSSL Time Tracker plugin.

Extract the plugin source archive. Copy files over to ‘wp-content/plugins/” folder. Next visit ‘Plugins’ page of WordPress admin and activate the plugin.

On activation, new tables required for Time Tracker will automatically be created. Sample data will also be installed just after the table creation. Visit the time tracker from the plugin action link (shown as ‘Tracker’ above) to start tracking your time.

Track Your Time

Below screenshot shows the interface used to track the time. ‘Start Time’ is automatically taken from ‘End Time’ of the previous time record. ‘End Time’ for the current record can directly be entered by typing into the text box.

Tip: Rightmost set of buttons in ‘Start Time’ row can be used to automatically enter the ‘End Time’ based on the ‘Start Time’. E.g. ’10′ button will add 10 minutes to the ‘Start Time’ and put it in ‘End Time’ text box.

Tip: Rightmost set of buttons in ‘End Time’ row can be used to adjust the ‘End Time’. E.g. ‘Add’ button will add 1 minute ‘End Time’ text box and ‘Now’ button will put current time in the ‘End Time’ text box.

Duration will automatically be recalculated each time ‘End Time’ is changed. ‘Category’, ‘Project’ and ‘Task’ select boxes should be used to further specify the time period being recorded. Enter a description of the task performed during the time period in the ‘Description’ text box.

Tip: The set of buttons below ‘Add Time Slot’ button can be used to automatically select the relevant options in the select boxes for a frequently performing task. This prevents you from changing select boxes for each and every task. You can preset these from the admin panel for regular or frequent tasks.

Visualize Time Data

No chart is being shown by default. The below is what you see when you visit UDSSL Time Tracker. You have to click ‘Generate Charts’ button to generate and render charts. The plugin will use ‘Highcharts JS’ charting library to chart your time data.

After charts are generated, three kinds of visualizations will be shown. ‘Category Summary’ will show you how you’ve spent time against various project categories. ‘Project Summary’ will show you how much time has been spent on each of your projects. ‘Task Summary’ will visualize the lower lever time tracking information. This view lets you to identify which task took the most of your time and which task took the least of your time.

Add New Categories, Projects and Tasks

At the bottom of UDSSL Time Tracker interface, you can find the interfaces to add new categories, projects and tasks from left to right. Each task belongs to a project and each project belongs to a category.

This interface is used to add a new task. When you add new categories and projects the topmost select boxes for categories and projects will automatically be populated allowing you to relate them to new tasks.

Using Presets

‘Task Presets’ are the buttons you see below the ‘Add Time Slot’ button. These presets make it easy to record a frequent task without clicking select boxes. Below screenshot show the ‘Presets’ administration screen. You can add, edit or delete presets using the interface.

The table at the bottom of the page shows the state of current task presets.

JSON API Exposure

The JSON API which handles your time data is only available to logged-in users by default. Visit ‘Settings’ tab on UDSSL Time Tracker Administration to make the API open to the rest of the world.

Warning: If you expose your API to your friends, family or clients, please be noted that they will be able to add time data to your system via API calls, in addition to reading your data. Tip: Use ‘udssltt_api_request’ hook to handle JSON API access permissions.

Written by UDSSL