Troubleshoot a Missing Support Portal or Agent Queue

This troubleshooting guide checks the Joomla menu-item type, publication and Access level, QCST permissions, sign-in state, active Frontend Agent record, and component routes when the Support Portal or Agent Queue is missing.

Where this fits in QC Support Ticket

A missing frontend surface can come from the Joomla menu route, menu Access level, QCST ACL, login state, an inactive/missing Frontend Agent record, Department scope, or incomplete component files. Test those layers separately.

Primary location: QC Support Ticket frontend and administrator interfaces, depending on the permission or failure being tested.

Before you begin

  • Use a normal Frontend Agent account for verification. Testing only as Joomla Super User can hide Department-scope or menu-access problems.

Troubleshooting procedure

  1. In Joomla Menus, confirm the missing route uses the correct QCST menu-item type: Support Portal for customers or Agent Queue for Agents.
  2. Confirm the menu item is Published and its Joomla Access level includes the test account.
  3. For Support Portal, verify the account has the required frontend QCST permissions and ownership context. For Agent Queue, verify an active QCST Frontend Agent record exists.
  4. For Agent Queue, verify the Agent has at least one current Department scope; then test with a ticket in that Department.
  5. If the route itself errors, verify the complete current component files/package and clear Joomla cache after repair/update.

Verify the result

  • The test Agent can open the Agent Queue and see allowed-Department tickets.
  • The same Agent is denied or does not receive tickets outside the configured Department scope.
  • Repeat the test with the least-privileged normal role affected by the feature; do not rely only on Super User behavior.

If it does not work as expected

  • If the queue is empty, verify Joomla menu Access, qcst.agent_access, the active Frontend Agent record, Department scope, and queue filters separately.

Community Discussion

For practical QC Support Ticket workflows and discussion with other Joomla site owners, visit the QC Support Ticket Community. For private support, bug reports, account-specific issues, or feature requests, use the QuantaCade support system.