Easy Time Manager - Administrator Guide

This guide covers all admin panel views accessible at Components > Easy Time Manager in the Joomla administrator. Each section describes the list view, edit form, and any special behaviors.


Table of Contents


Clients

Clients represent companies or organizations your team works for. Projects are organized under clients.

List View

Columns:

Column Description
Company Client name (click to edit)
Preview Colored badge showing the short name
Enabled Published status — toggle on/off
Contact Person Primary contact name and phone number
Number of Projects Count of projects linked to this client
Number of People Count of employees assigned to this client's projects
Total Hours Reported Sum of all hours logged against this client's projects
Latest Activity Date of the most recent work entry

All columns are sortable by clicking the column header.

Toolbar:

  • New — create a new client
  • Edit — edit the selected client
  • Delete — permanently remove selected clients
  • Publish / Unpublish — enable or disable clients

Filters:

  • Free text search by company name
  • Pagination limit selector
Warning: Unpublishing a client that has active projects will display a confirmation warning. The associated projects will also become inaccessible to employees.

Edit Form

Field Type Required Description
Company Text Yes Full company/client name
Company short name Text No Abbreviation shown on the colored badge in reports
Enabled Yes/No Whether the client is active (default: Yes)
Contact person Text No Primary contact name
Email Email No Contact email address
Skype Text No Skype handle
Phone no Text No Phone number
Address Textarea No Physical address
Notes Textarea No Internal notes about the client
Set background color Yes/No Enable custom color for the badge (default: Yes)
Color Color picker No Badge background color (default: white)
Issue tracker URL URL No URL pattern for linking ticket numbers to your issue tracker. Overrides the global bugtracker URL for this client.

Toolbar (edit view): Apply, Save, Save & New, Save as Copy, Cancel


Projects

Projects belong to a client and are the primary grouping for work entries. Employees are assigned to projects.

List View

Columns:

Column Description
Project Name Project name (click to edit)
Preview Colored badge with short name
Enabled Published status toggle
Description Project description text
Number of People Employees assigned to this project
Total Hours Reported Sum of all hours logged to this project
Latest Activity Most recent work entry date
Client Parent client name (click to navigate to client)

Toolbar: New, Edit, Delete, Publish, Unpublish, Preferences

Filters:

  • Free text search
  • Client dropdown filter
  • Pagination limit selector

Edit Form

Project Details tab:

Field Type Required Description
Client Dropdown Yes Select the parent client
Name Text Yes Project name (max 45 characters)
Project short name Text No Abbreviation for the badge
Enabled Yes/No Active status (default: Yes)
Description Textarea No Project description
Set background color Yes/No Enable custom badge color (default: Yes)
Color Color picker No Badge background color
Issue tracker URL URL No Project-specific issue tracker URL. Overrides client and global URLs.

Employees tab (available after first save):

Field Description
Add employee User selector — pick a Joomla user to assign to this project
List of employees Checkboxes for all currently assigned employees — uncheck to remove
Note: You must save the project at least once before the Employees tab becomes functional. A notice reads: "Please save the project to be able to assign employees."

Tasks

Tasks are optional predefined work categories that can be linked to projects. This feature is only visible when Use list of tasks is enabled in the component configuration.

List View

Columns:

Column Description
Task Name Task label (click to edit)
Enabled Published status toggle

Toolbar: New, Edit, Delete, Publish, Unpublish, Preferences

Filters: Free text search, pagination

Edit Form

Task Details tab:

Field Type Required Description
Name Text Yes Task name (max 45 characters)
Enabled Yes/No Active status (default: Yes)

Projects tab (available after first save):

Field Description
Add Project Dropdown to select and assign a project to this task
Project list Checkboxes for currently assigned projects — uncheck to remove
Note: Save the task first before assigning projects. When a task is linked to a project, employees working on that project will see this task in their task dropdown.

Users (Employees)

The Users view manages which Joomla users participate in Easy Time Manager and which projects they are assigned to. Users are not created here — they must already exist as Joomla users.

List View

Columns:

Column Description
Username Joomla username (click to edit assignment)
Email User's email address
User Groups Joomla user groups the user belongs to
Number of Projects Count of assigned projects
Total Hours Reported Sum of all hours logged by this user
Latest Activity Date of most recent work entry

Toolbar: New (add existing Joomla user), Edit, Preferences

Filters: Free text search, pagination

Edit View

The edit view shows:

  • User info — username and email (read-only; links to the Joomla Users component for full editing)
  • Project checkboxes — check/uncheck projects to assign or remove the user. A "Select All" button is available for bulk selection.

Time Worked Types

Time worked types categorize work entries (e.g., "Development", "QA", "Support", "Meeting"). Each type can have a color-coded badge that appears in reports. One type must always be the default.

List View

Columns:

Column Description
Name Type name (click to edit)
Default Toggle — click to set as the default type
Preview Colored badge (hidden for the default type)
ID Database ID

Toolbar: New, Edit, Delete, Preferences

Note: The default time worked type cannot be deleted. Its short name and color are not shown in reports — only non-default types display their badge.

Edit Form

Field Type Required Description
Name Text Yes Display name for the type
Short Name Text No Short abbreviation shown on the badge (max 3 characters recommended)
Colour Color picker No Badge background color (default: white)

Work Log (Reports)

The admin work log provides a list of all work entries across all users, with filtering and editing capabilities.

List View

Columns:

Column Description
Task Work entry task/title (click to edit)
Project Project name (click to edit)
User Employee who logged the entry (click to view Joomla user)
Date Date of work
Tickets Ticket/issue numbers (shown if ticket numbers are enabled in config)
Hours Time spent
ID Entry ID

Toolbar: New, Edit, Delete, Preferences

Filters:

  • Free text search
  • Staff dropdown (filter by employee)
  • Project dropdown
  • Pagination limit selector

Work Entry Edit Form

Field Type Required Description
Project Dropdown Yes Select the project
Employee User selector Yes The user this entry belongs to
Task Text or Dropdown Yes Free text task name, or select from predefined list if task lists are enabled
Done (Performed Work) Textarea Configurable Description of work performed
Tickets Text Configurable Ticket/issue numbers (comma-separated). Becomes clickable links if a bugtracker URL is set.
Time Text No Hours worked in HH:MM format (e.g., "2:30" for 2 hours 30 minutes)
Date Calendar Yes Date the work was performed
Time type Dropdown No Select the time worked type category
Note: Whether "Tickets" and "Done" are required depends on the component configuration settings "A ticket number is mandatory" and "Task description is mandatory".

Leave Types

Leave types define the categories of leave available to employees (e.g., "Annual Leave", "Sick Leave", "Personal Day").

List View

Columns:

Column Description
Name Leave type name (click to edit)

Toolbar: New, Edit, Delete (with confirmation dialog), Preferences

Edit Form

Field Type Required Description
Name Text Yes Leave type name

Leave Requests

The admin leave view allows managers to review, approve, and reject employee leave requests.

List View

Columns:

Column Description
Date Range Start and end dates of the leave (click to edit)
Work Days Number of working days requested
Leave Type Category of leave (click to navigate to leave type)
User Employee who submitted the request (click to view Joomla user)
User Commentary Comment from the employee explaining the leave
Admin Commentary Comment added by the admin when approving/rejecting
Status Badge showing Pending, Approved, or Rejected

Leave requests are grouped by year with visual separators.

Toolbar:

  • New — create a leave request on behalf of an employee
  • Edit — modify a selected leave request
  • Approve — opens a modal where you can add an admin comment, then approve
  • Reject — opens a modal where you can add an admin comment, then reject
  • Preferences — component options

Approve / Reject Workflow

  1. Select one or more leave requests from the list.
  2. Click Approve or Reject in the toolbar.
  3. A modal dialog appears with a text area for an admin comment (optional).
  4. Click Send to confirm. The employee receives an email notification with the decision and comment.

Edit Form

Field Type Required Description
User User selector No The employee requesting leave
Leave Dates Date range picker Yes Click to open the date picker and select start/end dates
Working Days Number Yes Count of working days within the date range
Leave Type Dropdown Yes Select from configured leave types
Comments Textarea No Employee's reason or notes (max 1000 characters)
Status Dropdown Yes Pending, Approved, or Rejected
Note: The date range picker uses a calendar popup. The start and end dates are stored automatically from the picker selection.

Related News

Cron Job Starts