Difference between revisions of "Troubleshooting Client Area Template Issues"
From WHMCS Documentation
| Line 1: | Line 1: | ||
| − | + | A blank or partially-rendered page indicates a fatal PHP error that stops execution from being able to continue. There can be many causes for this issue. For example: | |
| − | + | * Using PHP code blocks in your system theme template without enabling the '''Allow Smarty PHP Tags''' setting in the '''[[Security Tab|Security]]''' tab at '''Configuration (<i class="fa fa-wrench" aria-hidden="true"></i>) > System Settings > General Settings''' or, prior to WHMCS 8.0, '''Setup > General Settings'''. | |
| − | |||
| − | |||
| − | |||
| − | * Using PHP code blocks in your system theme template without the '''Allow Smarty PHP Tags''' setting | ||
* A custom or third-party module or hook that is incompatible with the new version. | * A custom or third-party module or hook that is incompatible with the new version. | ||
* A syntax issue in your system theme template. | * A syntax issue in your system theme template. | ||
| − | * Using Smarty features that | + | * Using Smarty features that the upstream Smarty package has removed. |
| − | For more | + | For more information, see [[Blank or Partially Rendered Pages]]. |
| + | |||
| + | If you have upgraded your installation and your custom system theme template is no longer working, try the process below. | ||
==Check the Logs== | ==Check the Logs== | ||
| − | + | Check the '''[[Activity_Logs|Activity Log]]''' at '''Configuration (<i class="fa fa-wrench" aria-hidden="true"></i>) > [[System Logs]]''' or, prior to WHMCS 8.0, '''Utilities > Logs > Activity Log'''. 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== | ==Try a Different System Theme Template== | ||
| Line 20: | Line 18: | ||
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 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. | + | * 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. | ||
| − | To change the system theme template your WHMCS system uses, | + | To change the system theme template that your WHMCS system uses, use the '''System Theme''' setting in the '''[[General Tab|General]]''' tab at '''Configuration (<i class="fa fa-wrench" aria-hidden="true"></i>) > System Settings > General Settings''' or, prior to WHMCS 8.0, '''Setup > General Settings'''. Then, click '''Save''' and attempt to visit your Client Area. |
==Check Your System Theme Templates for Legacy Smarty Functions== | ==Check Your System Theme Templates for Legacy Smarty Functions== | ||
| − | Most custom system theme templates won't need any updates to be compatible with newer versions of Smarty. However, features that are only available in Smarty 2 | + | Most custom system theme templates won't need any updates to be compatible with newer versions of Smarty. However, you must migrate features that are only available in Smarty 2 to ensure a smooth transition to the latest version. |
For more information, see our [[Version 6 Template Migration Guide]]. | For more information, see our [[Version 6 Template Migration Guide]]. | ||
| Line 32: | Line 31: | ||
==Contact our Support Team== | ==Contact our Support Team== | ||
| − | + | For additional assistance, [http://www.whmcs.com/support/ contact our support team]. | |
Revision as of 19:57, 9 May 2022
A blank or partially-rendered page indicates a fatal PHP error that stops execution from being able to continue. There can be many causes for this issue. For example:
- Using PHP code blocks in your system theme template without enabling the Allow Smarty PHP Tags setting in the Security tab at Configuration () > System Settings > General Settings or, prior to WHMCS 8.0, Setup > General Settings.
- A custom or third-party module or hook that is incompatible with the new version.
- A syntax issue in your system theme template.
- Using Smarty features that the upstream Smarty package has removed.
For more information, see Blank or Partially Rendered Pages.
If you have upgraded your installation and your custom system theme template is no longer working, try the process below.
Contents
Check the Logs
Check the Activity Log at Configuration () > System Logs or, prior to WHMCS 8.0, Utilities > Logs > Activity Log. 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.
To change the system theme template that your WHMCS system uses, use the System Theme setting in the General tab at Configuration () > System Settings > General Settings or, prior to WHMCS 8.0, Setup > General Settings. Then, click Save and attempt to visit your Client Area.
Check Your System Theme Templates for Legacy Smarty Functions
Most custom system theme templates won't need any updates to be compatible with newer versions of Smarty. However, you must migrate features that are only available in Smarty 2 to ensure a smooth transition to the latest version.
For more information, see our Version 6 Template Migration Guide.
Contact our Support Team
For additional assistance, contact our support team.