Blank or Partially Rendered Pages - Revision history

SarahK: /* Admin Login Page Only */

2022-08-18T17:08:45Z

‎Admin Login Page Only

SarahK at 16:05, 19 April 2022

2022-04-19T16:05:14Z

SarahK at 18:18, 26 January 2022

2022-01-26T18:18:55Z

SarahK at 17:14, 5 August 2020

2020-08-05T17:14:01Z

David at 21:36, 12 May 2017

2017-05-12T21:36:10Z

David at 21:31, 12 May 2017

2017-05-12T21:31:50Z

David at 21:31, 12 May 2017

2017-05-12T21:31:34Z

David: /* Client Area Only */

2017-05-12T21:21:54Z

‎Client Area Only

Matt at 00:27, 30 May 2015

2015-05-30T00:27:18Z

Matt at 00:26, 30 May 2015

2015-05-30T00:26:02Z

@@ Line 22: / Line 22: @@
 ===Admin Login Page Only===
-The admin login page does not involve templates, so seeing a blank page here suggests a problem with the Ioncube configuration on your server. Download the [http://www.ioncube.com/loaders.php Ioncube Loader Wizard] and upload it to your <tt>whmcs</tt> directory, and visit it in your browser. For help resolving any errors, contact your hosting provider or system administrator.
+The admin login page does not use templates, so a blank page indicates a problem with the ionCube configuration on your server.
-If it reports Ioncube is installed correctly, ensure that <tt>display_errors</tt> is enabled in the server's PHP configuration. This can suppress error messages that WHMCS is trying to output with the <tt>display_errors</tt> line in the <tt>configuration.php</tt> file.
+To find more troubleshooting information:
 Problematic custom widgets may also cause a blank page. Try removing any non-standard files from the <tt>/modules/widgets</tt> directory.

@@ Line 4: / Line 4: @@
 <div class="docs-alert-warning">
-Enabling Display Errors while your installation is accessible to end users may lead to potential security risks due to the information within the error message details.  If you enable Display Errors for debugging purposes, don't forget to turn it off again!
+Enabling '''Display Errors''' while your installation is accessible to end users may lead to potential security risks due to the information within the error message details.  Make certain to disable '''Display Errors''' when you finish debugging.
 </div>
@@ Line 13: / Line 13: @@
 ===Client Area Only===
-If the admin area is loading correctly and only the client area is blank this suggests the template folder missing or the /templates_c folder invalid path/not writeable.
+If the admin area is loading correctly and only the client area is blank, the template folder may be missing or the <tt>/templates_c</tt> folder may have an invalid path or may not be writeable.
 To resolve this:
-*Re-select the template 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 Changes'''.
+# Re-select the template at '''Configuration (<i class="fa fa-wrench" aria-hidden="true"></i>) > System Settings > [[General Settings]]''' or, prior to WHMCS 8.0, '''Setup > General Settings''' and click '''Save Changes'''.
-* Ensure the templates_c has the appropriate permissions and ownership values so it's writeable by the script (usually CHMOD 755, but in some environments CHMOD 777 may be required).
+# Ensure that the <tt>templates_c</tt> folder has the appropriate permissions and is writeable by the script (usually <tt>CHMOD 755</tt>, but in some environments may require <tt>CHMOD 777</tt>).
-*If the /templates_c directory has been moved to a [[Further_Security_Steps#Move_the_attachments.2C_downloads_.26_templates_c_folders|custom location]] ensure the path is correct in the configuration.php file. Your server admin/hosting provider will be able to confirm this.
+# If the <tt>/templates_c</tt> directory has been moved to a [[Further_Security_Steps#Move_the_attachments.2C_downloads_.26_templates_c_folders|custom location]], ensure the path is correct in the <tt>configuration.php</tt> file. For help, contact your hosting provider or system administrator.
 ===Admin Login Page Only===
-The admin login page does not involve templates, so seeing a blank page here suggests a problem with the Ioncube configuration on your server. You can download the Ioncube Loader Wizard from http://www.ioncube.com/loaders.php and upload to your whmcs directory, then visit it in your browser. Your server admin/hosting provider will need to resolve any errors it identifies.
+The admin login page does not involve templates, so seeing a blank page here suggests a problem with the Ioncube configuration on your server. Download the [http://www.ioncube.com/loaders.php Ioncube Loader Wizard] and upload it to your <tt>whmcs</tt> directory, and visit it in your browser. For help resolving any errors, contact your hosting provider or system administrator.
-If it reports Ioncube is installed correctly please ensure display_errors is enabled in the server's PHP configuration as this may be suppressing out error messages WHMCS is trying to output with the display_errors line in the configuration.php file detailed above.
+If it reports Ioncube is installed correctly, ensure that <tt>display_errors</tt> is enabled in the server's PHP configuration. This can suppress error messages that WHMCS is trying to output with the <tt>display_errors</tt> line in the <tt>configuration.php</tt> file.
-Problematic custom widgets may also cause a blank page. Try removing any non-standard files from the '''/modules/widgets''' directory.
+Problematic custom widgets may also cause a blank page. Try removing any non-standard files from the <tt>/modules/widgets</tt> directory.
 ===Oops! or Blank Pages Elsewhere===
-*/configuration.php
+If blank pages are occurring on all pages, try all the above steps, particularly enabling <tt>display_errors</tt>. If the problem persists, review any custom files in the following locations and ensure there are no blank spaces or carriage returns outside the <tt><?php</tt> and <tt>?></tt> tags:
 */includes/hooks/
-*/modules/admin/
+*<tt>/configuration.php</tt>
-*/modules/addons/
+*<tt>/includes/hooks/</tt>
-*/modules/registrars/
+*<tt>/modules/admin/</tt>
-*/modules/servers/
+*<tt>/modules/addons/</tt>
-*/modules/widgets/
+*<tt>/modules/registrars/</tt>
-*/lang/
+*<tt>/modules/servers/</tt>
-*/lang/overrides/
+*<tt>/modules/widgets/</tt>
-*/admin/lang/
+*<tt>/lang/</tt>
-*/admin/lang/overrides/
+*<tt>/lang/overrides/</tt>
 It may be necessary to remove any custom files from these locations temporarily, if doing so resolves the issue then you can add them back one-by-one until the problem re-occurs, you can then contact the vendor of the offending file for a fix.
-If none of the steps on this page fix the problem then please contact [http://www.whmcs.com/get-support/ our support team] for assistance. In your support ticket please include the attempts you have made to resolve the issue, instructions to reproduce the blank page and FTP/SFTP access.
+If none of the steps on this page fix the problem, contact [http://www.whmcs.com/get-support/ our support team] with a description of the troubleshooting you have done, reproduction instructions, and FTP/SFTP access.
 {{troubleshooting}}

@@ Line 1: / Line 1: @@
 If at any time you encounter a blank or partially rendered page in your WHMCS installation, this indicates a fatal PHP error is occurring which stops the execution from being able to continue. This page covers the most common causes of these problems, how to identify them and methods for resolution.
-The display of error information is disabled by default.  The [[Error Management]] documentation provides in-depth information regarding the default error behaviors and optional settings of WHMCS.
+The display of error information is disabled by default. For more information, see [[Error Management]].
 <div class="docs-alert-warning">
@@ Line 12: / Line 12: @@
 ===Client Area Only===
 If the admin area is loading correctly and only the client area is blank this suggests the template folder missing or the /templates_c folder invalid path/not writeable.
@@ Line 20: / Line 21: @@
 ===Admin Login Page Only===
 The admin login page does not involve templates, so seeing a blank page here suggests a problem with the Ioncube configuration on your server. You can download the Ioncube Loader Wizard from http://www.ioncube.com/loaders.php and upload to your whmcs directory, then visit it in your browser. Your server admin/hosting provider will need to resolve any errors it identifies.

@@ Line 15: / Line 15: @@
 To resolve this:
-*Re-select template under ''Setup > General Settings'' and clicking Save Changes.
+*Re-select the template 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 Changes'''.
 * Ensure the templates_c has the appropriate permissions and ownership values so it's writeable by the script (usually CHMOD 755, but in some environments CHMOD 777 may be required).
 *If the /templates_c directory has been moved to a [[Further_Security_Steps#Move_the_attachments.2C_downloads_.26_templates_c_folders|custom location]] ensure the path is correct in the configuration.php file. Your server admin/hosting provider will be able to confirm this.

@@ Line 4: / Line 4: @@
 <div class="docs-alert-warning">
-Having Display Errors enabled while your installation is accessible to end users can lead to potential security risks due to the information error messages can contain.  If you enable Display Errors for debugging purposes, don't forget to turn it off again!
+Enabling Display Errors while your installation is accessible to end users may lead to potential security risks due to the information within the error message details.  If you enable Display Errors for debugging purposes, don't forget to turn it off again!
 </div>
@@ Line 26: / Line 26: @@
 Problematic custom widgets may also cause a blank page. Try removing any non-standard files from the '''/modules/widgets''' directory.
-===Blank Pages Elsewhere===
+===Oops! or Blank Pages Elsewhere===
 If blank pages are occurring on all pages, please try all the above steps, particularly enabling display_errors. If none of the above resolves the issue review any custom files in the following locations and ensure there are no blank spaces or carriage returns outside the <?php and ?> tags:

@@ Line 1: / Line 1: @@
-If at any time you encounter a blank page in the WHMCS system then this indicates a fatal PHP error is occurring. This page explains the common causes of such problems, how to identify and subsequently resolve them.
+If at any time you encounter a blank or partially rendered page in your WHMCS installation, this indicates a fatal PHP error is occurring which stops the execution from being able to continue. This page covers the most common causes of these problems, how to identify them and how to resolve them.
 Error reporting is disabled by default.
 <div class="docs-alert-warning">
-Having error display enabled while your installation is accessible to end users can lead to potential security risks due to the information error messages often contain.  If you enable error reporting for debugging purposes, don't forget to turn it off again!
+Having error reporting enabled while your installation is accessible to end users can lead to potential security risks due to the information error messages can contain.  If you enable error reporting for debugging purposes, don't forget to turn it off again!
 </div>
-{{Enabling_Error_Reporting}}
+{{:Enabling_Error_Reporting}}
 ==Common Causes==