Troubleshooting System Themes

If you experience problems with Client Area templates, you will need to investigate them to find the cause.

We recommend the following steps to troubleshoot template issues:

Check the Logs

Check the Activity Log at Configuration () > System Logs.

This logs all of the errors that the Smarty templating engine encounters. You can use this to find the exact system theme template and section of code that is causing the problem.

Try a Different System Theme Template

If you don’t find anything in the activity logs, switching to a different system theme template will help determine the cause of the issue.

  • If changing to a different system theme template allows the Client Area to load successfully, the issue is in your system theme template itself.
  • If you continue to experience problems loading the Client Area with other system theme templates, then your issue is more likely related to a module or hook and not a specific individual system theme template.
For steps to change the system theme, see Change the System Theme.

Check Your System Theme Templates for Legacy Smarty Functions

If your custom themes or templates use features that are not available in the most recent version of Smarty, you will need to update them for compatibility.

We plan to permanently remove support for legacy Smarty tags in WHMCS 9.0. You must disable and remove them.

To use the legacy {php} tag prior to WHMCS 8.7, enable Allow Smarty PHP Tags in the Security tab at Configuration () > System Settings > General Settings.

Last modified: October 30, 2024