Time Tracker for WHMCS Print

Time Tracker records work against WHMCS clients and creates invoices from selected entries. It supports manual time entries, a persistent timer, client-specific rates, and bulk invoicing.

Requirements and installation

• WHMCS 8.9 or newer.
• PHP 8.1 or newer, supported by your WHMCS release.
• A compatible ionCube Loader for the encoded package, a valid ArkHost license, and outbound HTTPS access to arkhost.com for validation.

1. Back up your WHMCS files and database.
2. Merge the package's complete modules/ tree into WHMCS. Include both modules/addons/timetracker/ and modules/widgets/timetracker.php.
3. Open System Settings > Addon Modules, activate Time Tracker, and select Configure.
4. Enter your license key and choose the administrator roles that may use the module.
5. Open Addons > Time Tracker > Settings to configure the display and navigation.
6. On the admin dashboard, use Show/Hide Widgets to enable Time Tracker if needed.

Settings

The WHMCS addon configuration contains the license key and administrator role access. The module has separate Settings and Client Rates tabs.

In Settings, choose a 12-hour or 24-hour display, the client entries per page (10, 25, 50, or 100), and whether to show client navigation and its sidebar icon. You can change the link label; a blank label uses Billable Hours.

In Client Rates, configure:

• The default hourly rate and invoice description, with optional client-specific overrides.
• The invoice payment method. Client Default Gateway uses the client's default gateway.
• Whether to send an invoice email when generating invoices. This is enabled by default.
• The billing increment and minimum billable time. The minimum applies to each billable entry before upward rounding to the selected increment. No rounding and a zero minimum leave recorded durations unchanged.

Record time

1. Open Addons > Time Tracker and select the client.
2. Enter the date, from/to times, description, and billable status.
3. Save the entry and check it in the list.

For live tracking, start the timer with the client and notes selected. It persists across page refreshes. Stopping it creates a billable entry; check that it saved successfully. Cancelling the timer discards the tracked time.

Quick presets add common blocks of 15 minutes, 30 minutes, 1 hour, 2 hours, 4 hours, or 8 hours. The duplicate action copies an entry to the next day.

Generate invoices

1. Filter and review the entries by client, date, billable or invoiced status, or staff member.
2. Check the rates, descriptions, rounding, payment method, and invoice-email setting.
3. Select the entries and click Generate Invoice.
4. Review the resulting WHMCS invoices and confirm the entries are marked as invoiced.

Bulk invoicing creates separate invoices for different clients. Invoice generation is a billing action and can notify customers, so review the selection before submitting it.

Client area and reporting

Clients with entries can view their history in the client area. Pagination limits the displayed rows without limiting the summary totals. Standard themes receive navigation links when enabled. For Lagom, add a menu item through its menu manager pointing to index.php?m=timetracker.

The calendar shows days with entries and follows the active client and staff filters. Click a day to filter by that date. Export filtered entries to CSV for reporting. Summary statistics convert amounts to the default currency for reporting; review the actual client invoice currency separately.

English, Dutch, and Russian translations are included.

Updates and data

Back up the database before upgrading, then copy the package's complete modules/ tree over the installed files. The module preserves its time entries, client rates, and settings tables on deactivation.

For support, include your WHMCS, PHP, module, and theme versions and the steps that produced the problem. Use the ArkHost support form.