Staff Chatfor WHMCS · Documentation
v2.0.0

Activity Log

Audit trail for module and chat administration.


Recorded events

  • Widget connects, once per admin session.
  • Room switches between Group Chat and private rooms.
  • Settings changes, with before and after values.
  • Chat history cleared.
  • Activity log cleared.
  • Message deletions and edits.
  • Denied access attempts and rejected actions.
No message content — the activity log stores who did what, when, from which IP and browser, but never the text of a chat message.

Viewing and filtering

  • DataTables with newest entries first, search and pagination.
  • Action and admin filters.
  • From and To date range.
  • IP address and browser user agent columns; IP logging can be disabled in Settings.
  • Related events can be grouped into sessions for readability.

Retention

The log always keeps the newest 1,000 rows. Entries older than Activity log retention are pruned when the log is written, when the page is opened and by the daily cron. Set retention to 0 to keep entries until the row cap is reached.

Export and clear

  • Export CSV respects the active filters.
  • Clear log is Full Administrator-only and CSRF-protected.
  • Clearing leaves a single “Log cleared” entry so the action itself remains auditable.

Storage

Activity metadata is stored in the hsc_staffchat_log database table. Chat messages and attachments are not stored there; they live in the encrypted data/ files described in How It Works.