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 Issue | Explanation | Next 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 Issue | Explanation | Next 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: June 14, 2024