Email Sending Issues - Revision history

SarahK at 20:08, 11 May 2022

2022-05-11T20:08:31Z

SarahK at 17:27, 22 April 2022

2022-04-22T17:27:25Z

Show changes

SarahK at 20:34, 21 April 2022

2022-04-21T20:34:48Z

SarahK at 19:36, 25 January 2022

2022-01-25T19:36:25Z

SarahK at 18:09, 17 December 2021

2021-12-17T18:09:00Z

DanR at 15:27, 18 May 2021

2021-05-18T15:27:54Z

John: /* Troubleshooting */

2021-02-17T17:16:40Z

‎Troubleshooting

SarahK: /* Email sending aborted by configuration */

2020-12-08T17:10:48Z

‎Email sending aborted by configuration

SarahK: /* Common Errors */

2020-11-20T21:20:53Z

‎Common Errors

SarahK: /* Message body empty */

2020-08-05T16:19:55Z

‎Message body empty

@@ Line 16: / Line 16: @@
 #Check whether any email appears in the '''Email Message Log''' at '''Configuration (<i class="fa fa-wrench" aria-hidden="true"></i>) > [[System Logs]]''' ('''Utilities > Logs''' in WHMCS 7.x and earlier).
-#Check whether an error occurs at the time of email sending in the '''[[Activity Logs|Activity Log]]''' at '''Configuration (<i class="fa fa-wrench" aria-hidden="true"></i>) > [[System Logs]]''' ('''Utilities > Logs''' in WHMCS 7.x and earlier).
+#Check whether an error occurs at the time of email sending in the '''Activity Log''' at '''Configuration (<i class="fa fa-wrench" aria-hidden="true"></i>) > [[System Logs]]''' ('''Utilities > Logs''' in WHMCS 7.x and earlier).
 '''No Error in Activity Log:'''<br/>
@@ Line 84: / Line 84: @@
 ==Troubleshooting==
-Sometimes, the error output in the '''[[Activity Log]]''' at '''Configuration (<i class="fa fa-wrench" aria-hidden="true"></i>) > [[System Logs]]''' ('''Utilities > Logs''' in WHMCS 7.x and earlier) when sending of emails via SMTP fails can lack verbosity. Alternatively, the underlying cause may be different from the message that the system ultimately displays. Adding the following line to the <tt>configuration.php</tt> file will output a lot of debugging information when you send mail manually. This requires that the '''Mail Type''' setting in the '''[[Mail Tab|Mail]]''' tab at '''Configuration (<i class="fa fa-wrench" aria-hidden="true"></i>) > System Settings > General Settings''' is '''SMTP''':
+Sometimes, the error output in the '''Activity Log''' at '''Configuration (<i class="fa fa-wrench" aria-hidden="true"></i>) > [[System Logs]]''' ('''Utilities > Logs''' in WHMCS 7.x and earlier) when sending of emails via SMTP fails can lack verbosity. Alternatively, the underlying cause may be different from the message that the system ultimately displays. Adding the following line to the <tt>configuration.php</tt> file will output a lot of debugging information when you send mail manually. This requires that the '''Mail Type''' setting in the '''[[Mail Tab|Mail]]''' tab at '''Configuration (<i class="fa fa-wrench" aria-hidden="true"></i>) > System Settings > General Settings''' is '''SMTP''':
 <source lang="php">$smtp_debug = true;</source>
@@ Line 129: / Line 129: @@
 * Replicate the error again.
 * Disable the Hooks Debug Mode option.
-* Review the [[Activity_Logs|Activity Log]].
+* Review the [[System Logs|Activity Log]].
 * Locate the "Email Send Aborted By Hook" error in the log.
@@ Line 180: / Line 180: @@
 ==Troubleshooting==
-Sometimes, the '''[[Activity Log]]''' error output lacks verbosity when sending emails via SMTP fails. Alternatively, the underlying cause may be different from the message that the system ultimately displays.
+Sometimes, the '''Activity Log''' error output lacks verbosity when sending emails via SMTP fails. Alternatively, the underlying cause may be different from the message that the system ultimately displays.
 ===For version 8.0 and later===

@@ Line 9: / Line 9: @@
 First, check these points:
-#Check whether you have disabled the email template in '''Configuration (<i class="fa fa-wrench" aria-hidden="true"></i>) > System Settings > Email Templates'''.
+#Check whether you have disabled the email template in '''Configuration (<i class="fa fa-wrench" aria-hidden="true"></i>) > System Settings > [[Email Templates]]''' or, prior to WHMCS 8.0, '''Setup > Email Templates'''.
 #Check whether custom action hooks that could prevent email from sending exist in the <tt>/includes/hooks</tt> and <tt>/modules/addons</tt> directories.
 #Check whether you can send the emails manually.
@@ Line 15: / Line 15: @@
 If the above steps don't resolve the issue:
-#Check whether any email appears at '''Configuration (<i class="fa fa-wrench" aria-hidden="true"></i>) > System Logs > Email Message Log''' ('''Utilities > Logs > Email Message Log''' in WHMCS 7.x and earlier).
+#Check whether any email appears in the '''Email Message Log''' at '''Configuration (<i class="fa fa-wrench" aria-hidden="true"></i>) > [[System Logs]]''' ('''Utilities > Logs''' in WHMCS 7.x and earlier).
-#Check whether an error occurs at the time of email sending under '''Configuration (<i class="fa fa-wrench" aria-hidden="true"></i>) > System Logs > [[Activity_Logs|Activity Log]]''' ('''Utilities > Logs > Activity Log''' in WHMCS 7.x and earlier).
+#Check whether an error occurs at the time of email sending in the '''[[Activity Logs|Activity Log]]''' at '''Configuration (<i class="fa fa-wrench" aria-hidden="true"></i>) > [[System Logs]]''' ('''Utilities > Logs''' in WHMCS 7.x and earlier).
 '''No Error in Activity Log:'''<br/>
@@ Line 40: / Line 40: @@
 To troubleshoot this problem, perform these steps in the following order:
 # First, perform the troubleshooting steps in [[Auto Setup Issues]].
-# Check whether you selected a welcome email for the product at '''Configuration (<i class="fa fa-wrench" aria-hidden="true"></i>) > System Settings > Products/Services''' or, prior to WHMCS 8.0, '''Setup > Products/Services > Products/Services'''.
+# Check whether you selected a welcome email for the product at '''Configuration (<i class="fa fa-wrench" aria-hidden="true"></i>) > System Settings > [[Products and Services|Products/Services]]''' or, prior to WHMCS 8.0, '''Setup > Products/Services > Products/Services'''.
 # Check the activity log for any syntax errors in the email template.

@@ Line 36: / Line 36: @@
 ===Product Welcome Email===
-Problems with the sending of the welcome emails are typically due to an issue with account creation. For more information, see [[Auto Setup Issues]].
+Problems sending welcome emails typically relate to [[Auto Setup Issues|an account creation issue]]. The system sends the welcome email when the module's '''Create''' command completes successfully and automatically, creating the account on the server. Unsent welcome emails indicate a problem with the automated setup not occurring.
 ===Support Ticket Notifications===

@@ Line 176: / Line 176: @@
 ===For version 8.0 and later===
-In WHMCS v8.0+ follow these steps if your Mail Provider is SMTP:
-# Navigate to '''Configuration > System Settings > General Setting > Mail Tab''' and click the '''Configure Mail Provider''' button
+In WHMCS 8.0 and later, follow these steps if your Mail Provider is SMTP:
-# Tick the ''SMTP Debug'' checkbox
-# Click Test Configuration
+# Go to '''Configuration > System Settings > General Settings''' and select the '''Mail''' tab.
-# View the debugging output in the '''Configuration > System Logs'''.
+# Click '''Configure Mail Provider'''.
 ===For version 7.x and earlier===
 In WHMCS 7 and earlier, adding the following line to the <tt>configuration.php</tt> file will output a large amount of debugging information when you send mail manually. This requires that '''Configuration (<i class="fa fa-wrench" aria-hidden="true"></i>) > System Settings > General Settings > Mail > Mail Type''' is ''SMTP'':

← Older revision		Revision as of 15:27, 18 May 2021
Line 1:		Line 1:
−	~~Sometimes, the system may not send mail using the expected methods. The problem is usually a misconfiguration.~~
−
	Sometimes, the system may not send mail using the expected methods. The problem is usually a misconfiguration.		Sometimes, the system may not send mail using the expected methods. The problem is usually a misconfiguration.

@@ Line 149: / Line 149: @@
 ====Email sending aborted by configuration====
-In WHMCS 8.1, this error indicates that you have set '''Disable Email Sending''' to '''ON''' at '''Configuration (<i class="fa fa-wrench" aria-hidden="true"></i>) > System Settings > General Settings''' in the '''Mail''' tab. The system will log this error every time that the system attempts to send an email. For more information, see [[Disabling Outgoing Mail]].
+In WHMCS 8.1, this error indicates that you have set '''Disable Email Sending''' to '''ON''' at '''Configuration (<i class="fa fa-wrench" aria-hidden="true"></i>) > System Settings > General Settings''' in the '''Mail''' tab. The system creates a log entry each time that you enable or disable this setting. For more information, see [[Disabling Outgoing Mail]].
 We recommend that you only enable this setting when you are testing updates or customizations on a development installation or while troubleshooting.

← Older revision		Revision as of 21:20, 20 November 2020
Line 147:		Line 147:
	To remedy this, ensure that you have updated the storage locations. For more information, see the [[Moving_Storage_Locations\|Moving Storage Locations]] guide.		To remedy this, ensure that you have updated the storage locations. For more information, see the [[Moving_Storage_Locations\|Moving Storage Locations]] guide.

		+	====Email sending aborted by configuration====
		+
		+	In WHMCS 8.1, this error indicates that you have set '''Disable Email Sending''' to '''ON''' at '''Configuration (<i class="fa fa-wrench" aria-hidden="true"></i>) > System Settings > General Settings''' in the '''Mail''' tab. The system will log this error every time that the system attempts to send an email. For more information, see [[Disabling Outgoing Mail]].
		+
		+	We recommend that you only enable this setting when you are testing updates or customizations on a development installation or while troubleshooting.

	{{troubleshooting}}		{{troubleshooting}}

@@ Line 101: / Line 101: @@
 ====Message body empty====
-A "Message Body Empty" error indicates that a syntax error occurred, preventing the email from sending. Review '''System Settings (<i class="fa fa-wrench" aria-hidden="true"></i>) > System Logs''' ('''Utilities > Logs > Activity Log''' in WHMCS 7.x and earlier) at the time of sending for entries beginning "Smarty Error". This will provide more information on the invalid syntax, which you will need to correct before attempting to send the email again.
+A "Message Body Empty" error indicates that a syntax error occurred, preventing the email from sending. Review '''Configuration (<i class="fa fa-wrench" aria-hidden="true"></i>) > System Logs''' ('''Utilities > Logs > Activity Log''' in WHMCS 7.x and earlier) at the time of sending for entries beginning "Smarty Error". This will provide more information on the invalid syntax, which you will need to correct before attempting to send the email again.
 ====The following recipients failed====