Troubleshooting Customizations

If you encounter errors or issues while working with themes, templates, or other customizations, see the sections below to start troubleshooting and resolve the issue.

You can troubleshoot some custom code using the steps in Troubleshooting WHMCS API Calls and Troubleshooting Hooks.

For more information, see Themes and Templates.

Templates

You may encounter the following common issues:

Error or IssueExplanationNext Steps
Blank or partially-rendered pages.This issue typically indicates that a PHP error occurred. This could be due to an incompatible module or hook, a syntax issue, Smarty tag use, or another problem.Blank or Partially-Rendered Pages
LogicException: The template "$filename" could not be found at "/path/to/whmcs/resources/views/$filename.php"The system could not find the template file. This could indicate that something deleted the file.LogicException Template Errors

Themes

For steps to troubleshoot system theme issues, see Troubleshooting System Themes.

You may encounter the following common issues:

Error or IssueExplanationNext Steps
The same theme name appears multiple times in the System Theme menu.Two templates specify the same theme name in the theme.yaml file. Often, this is due to copying an existing theme to create a customization.Duplicate System Theme Options

Last modified: May 29, 2024