Domain Synchronisation - Revision history

SarahK at 19:30, 21 April 2022

2022-04-21T19:30:17Z

SarahK: /* The Domain Sync Task */

2022-03-11T22:35:55Z

‎The Domain Sync Task

SarahK: /* Configuration */

2022-02-01T18:21:03Z

‎Configuration

SarahK: /* The Domain Sync Task */

2022-02-01T18:20:46Z

‎The Domain Sync Task

SarahK at 18:20, 1 February 2022

2022-02-01T18:20:17Z

SarahK at 18:30, 17 December 2021

2021-12-17T18:30:48Z

Lawrence: /* How it works */

2021-03-17T14:29:27Z

‎How it works

Lawrence: /* An introduction */

2021-03-17T14:27:29Z

‎An introduction

SarahK: /* Setting it up */

2020-08-05T13:02:24Z

‎Setting it up

SarahK at 13:02, 5 August 2020

2020-08-05T13:02:04Z

@@ Line 29: / Line 29: @@
 === Configuration in WHMCS 7.5 and Earlier ===
-In version 7.5 and earlier some of these settings are located in the '''Domains''' tab at '''Configuration (<i class="fa fa-wrench" aria-hidden="true"></i>) > System Settings > General Settings''' or, prior to WHMCS 8.0, '''Setup > General Settingss'''.
+In version 7.5 and earlier some of these settings are located in the '''[[Domains Tab|Domains]]''' 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'''.
 An additional set up step is required to create a cron job to trigger the /crons/domainsync.php file:
@@ Line 47: / Line 47: @@
 ===Curl error - could not connect to host===
-This is most commonly caused by not whitelisting the server's IP at your domain registrar (for example: eNom or ResellerClub) for API access. You will need to contact them and provide the IP from '''Help > License Information''' in your admin area for whitelisting to resolve this.
+This is most commonly caused by not whitelisting the server's IP at your domain registrar (for example: eNom or ResellerClub) for API access. You will need to contact them and provide the IP from '''Help > [[License Information]]''' in your admin area for whitelisting to resolve this.

@@ Line 7: / Line 7: @@
 * Active domains will have their Expiry Date corrected to match the registrar if different. If the dates already match it will report "In Sync".
 * Pending Registration domains will have their Expiry Date corrected to match the registrar if different, and Status set to Active once the registration is complete. If the dates already match it will report "In Sync".
-* Pending Transfer domains will usually report an error until the transfer process is complete at which point the status will automatically be changed to Active, the Domain Transfer Completed email template sent and the Expiry Date obtained from the registrar.
+* Pending Transfer domains will usually report an error until the [[Domain_Transfers|transfer process]] is complete at which point the status will automatically be changed to Active, the Domain Transfer Completed email template sent and the Expiry Date obtained from the registrar.
 When used with the eNom module, the script can also send the Domain Transfer Failed email template if the transfer process fails.

@@ Line 17: / Line 17: @@
 ==Configuration==
-Use the following settings to configure the domain sync task at '''Configuration (<i class="fa fa-wrench" aria-hidden="true"></i>) > System Settings > Automation Settings''' or, prior to WHMCS 8.0, '''Setup > Automation Settings''':
+Use the following settings to configure the domain sync task at '''Configuration (<i class="fa fa-wrench" aria-hidden="true"></i>) > System Settings > [[Automation Settings]]''' or, prior to WHMCS 8.0, '''Setup > Automation Settings''':
 * '''Domain Sync Enabled'''

@@ Line 5: / Line 5: @@
 The domain sync task works by using the domain synchronization functions built into each registrar module (if the module supports Domain Sync Script in the documentation for the module) to check 50 domains per run from the oldest to newest in your WHMCS installation. '''Pending Transfer''', '''Pending Registration''', and '''Active''' status domains are handled separately, so it can do 50 of each during each run.
-Active domains will have their Expiry Date corrected to match the registrar if different. If the dates already match it will report "In Sync".
+* Active domains will have their Expiry Date corrected to match the registrar if different. If the dates already match it will report "In Sync".
+* Pending Registration domains will have their Expiry Date corrected to match the registrar if different, and Status set to Active once the registration is complete. If the dates already match it will report "In Sync".
-Pending Registration domains will have their Expiry Date corrected to match the registrar if different, and Status set to Active once the registration is complete. If the dates already match it will report "In Sync".
+* Pending Transfer domains will usually report an error until the transfer process is complete at which point the status will automatically be changed to Active, the Domain Transfer Completed email template sent and the Expiry Date obtained from the registrar.
 When used with the eNom module, the script can also send the Domain Transfer Failed email template if the transfer process fails.

@@ Line 1: / Line 1: @@
-==An introduction==
+The domain sync task is responsible for ensuring the next due date, expiry date, and status are up-to-date on all '''Pending Transfer''', '''Pending Registration''', and '''Active''' status domains where a valid registrar module is set on the domain itself.
-The domain sync task is responsible for ensuring the Next Due Date, Expiry Date and Status are up to date on all Pending Transfer, Pending Registration and Active status domains where a valid registrar module is set on the domain itself.
+==The Domain Sync Task==
-==How it works==
+The domain sync task works by using the domain synchronization functions built into each registrar module (if the module supports Domain Sync Script in the documentation for the module) to check 50 domains per run from the oldest to newest in your WHMCS installation. '''Pending Transfer''', '''Pending Registration''', and '''Active''' status domains are handled separately, so it can do 50 of each during each run.
 Active domains will have their Expiry Date corrected to match the registrar if different. If the dates already match it will report "In Sync".
@@ Line 15: / Line 13: @@
 When used with the eNom module, the script can also send the Domain Transfer Failed email template if the transfer process fails.
-For example: if you are using eNom and have 150 Active and Pending Registration domains and 20 in Pending Transfer status, the script will check the 20 Pending Transfer status domains as needed during each run, along with 50 of the Active and Pending Registration status domains, starting over once it reaches the newest domain.
+For example, if you are using eNom and have 150 Active and Pending Registration domains and 20 in Pending Transfer status, the script will check the 20 Pending Transfer status domains as needed during each run, along with 50 of the Active and Pending Registration status domains, starting over once it reaches the newest domain.
-Depending on the configuration under '''Configuration (<i class="fa fa-wrench" aria-hidden="true"></i>) > System Settings > Automation Settings''' or, prior to WHMCS 8.0, '''Setup > Automation Settings''', the domain sync task will adjust at least the Expiry Date and Status, with the possibility of the Next Due Date if "Sync Next Due Date" is configured. Once the domain sync cron job has completed, an e-mail will be sent to any admins whose administrator role has "System Emails" enabled. If "Domain Sync Notify Only" is enabled, no changes will be made and the e-mail will simply list the changes that would have been made.
+Depending on the configuration under '''Configuration (<i class="fa fa-wrench" aria-hidden="true"></i>) > System Settings > [[Automation Settings]]''' or, prior to WHMCS 8.0, '''Setup > Automation Settings''', the domain sync task will adjust at least the Expiry Date and Status, with the possibility of the Next Due Date if "Sync Next Due Date" is configured. Once the domain sync cron job has completed, an e-mail will be sent to any admins whose administrator role has "System Emails" enabled. If "Domain Sync Notify Only" is enabled, no changes will be made and the e-mail will simply list the changes that would have been made.
-==Setting it up==
+==Configuration==
-To set up the domain sync task, please configure the following setting under '''Configuration (<i class="fa fa-wrench" aria-hidden="true"></i>) > System Settings > Automation Settings''' or, prior to WHMCS 8.0, '''Setup > Automation Settings''' first:
+Use the following settings to configure the domain sync task at '''Configuration (<i class="fa fa-wrench" aria-hidden="true"></i>) > System Settings > Automation Settings''' or, prior to WHMCS 8.0, '''Setup > Automation Settings''':
-* '''Domain Sync Enabled''' — Check to enable the domain date and status synchronisation function.
+* '''Domain Sync Enabled'''
-* '''Sync Next Due Date''' — Choose whether to sync the Next Due Date to the Expiry Date and how many days in advance of it (if desired).
+In version 7.6 and above, the Domain Synchronisation Task is handled by the main cron job. No further setup steps are required.
-* '''Domain Sync Notify Only''' — If enabled, the domain sync script won't make any changes. It will only notify admins of the changes it would have made. Useful for debugging.
+=== Configuration in WHMCS 7.5 and Earlier ===
-* '''Domain Expiry Sync Frequency''' — A value of <tt>0</tt> will check the domain expiration dates every four hours. Use this setting to specify a different frequency. The lowest frequency setting of <tt>1</tt> will check every hour.
+In version 7.5 and earlier some of these settings are located in the '''Domains''' tab at '''Configuration (<i class="fa fa-wrench" aria-hidden="true"></i>) > System Settings > General Settings''' or, prior to WHMCS 8.0, '''Setup > General Settingss'''.
-In version 7.5 and earlier some of these settings are located under '''Configuration (<i class="fa fa-wrench" aria-hidden="true"></i>) > System Settings > General Settings > Domains''' or, prior to WHMCS 8.0, '''Setup > General Settings > Domains'''. An additional set up step is required to create a cron job to trigger the /crons/domainsync.php file:
+An additional set up step is required to create a cron job to trigger the /crons/domainsync.php file:
 '''Sample Cron Command'''

@@ Line 23: / Line 23: @@
 To set up the domain sync task, please configure the following setting under '''Configuration (<i class="fa fa-wrench" aria-hidden="true"></i>) > System Settings > Automation Settings''' or, prior to WHMCS 8.0, '''Setup > Automation Settings''' first:
-* '''Domain Sync Enabled''' - Tick this checkbox to enable the domain date and status synchronisation function.
+* '''Domain Sync Enabled''' — Check to enable the domain date and status synchronisation function.
-* '''Sync Next Due Date''' - Choose whether to sync the Next Due Date to the Expiry Date, and how many days in advance of it (if desired).
+* '''Sync Next Due Date''' — Choose whether to sync the Next Due Date to the Expiry Date and how many days in advance of it (if desired).
-* '''Domain Sync Notify Only''' - If enabled, the domain sync script won't make any changes - it will only notify admins of the changes it would have made. Useful for debugging.
+* '''Domain Sync Notify Only''' — If enabled, the domain sync script won't make any changes. It will only notify admins of the changes it would have made. Useful for debugging.
-* '''Domain Expiry Sync Frequency''' - A value of 0 will check the domain expiration dates every ''4'' hours. Use this setting to specify a different frequency. The lowest frequency setting of ''1'' will check every hour.
+* '''Domain Expiry Sync Frequency''' — A value of <tt>0</tt> will check the domain expiration dates every four hours. Use this setting to specify a different frequency. The lowest frequency setting of <tt>1</tt> will check every hour.
-* '''Pending Transfer Sync Frequency''' - A value of 0 will check the domains in Pending Transfer status every ''4'' hours. Use this setting to specify a different frequency. The lowest frequency setting of ''1'' will check every hour.
+* '''Pending Transfer Sync Frequency''' — A value of <tt>0</tt> will check the domains in Pending Transfer status every four hours. Use this setting to specify a different frequency. The lowest frequency setting of one will check every hour.
 <div class="docs-alert-info">

@@ Line 15: / Line 15: @@
 For example: if you are using eNom and have 150 Active Domains and 20 in Pending Transfer status, the script will check the 20 Pending Transfer status domains as needed during each run, along with 50 of the Active status domains, starting over once it reaches the newest domain.
-Depending on the configuration under '''Setup > Automation Settings''', the domain sync task will adjust at least the Expiry Date and Status, with the possibility of the Next Due Date if "Sync Next Due Date" is configured. Once the domain sync cron job has completed, an e-mail will be sent to any admins whose administrator role has "System Emails" enabled. If "Domain Sync Notify Only" is enabled, no changes will be made and the e-mail will simply list the changes that would have been made.
+Depending on the configuration under '''Configuration (<i class="fa fa-wrench" aria-hidden="true"></i>) > System Settings > Automation Settings''' or, prior to WHMCS 8.0, '''Setup > Automation Settings''', the domain sync task will adjust at least the Expiry Date and Status, with the possibility of the Next Due Date if "Sync Next Due Date" is configured. Once the domain sync cron job has completed, an e-mail will be sent to any admins whose administrator role has "System Emails" enabled. If "Domain Sync Notify Only" is enabled, no changes will be made and the e-mail will simply list the changes that would have been made.
 ==Setting it up==
-To set up the domain sync task, please configure the following setting under '''Setup > Automation Settings''' first:
+To set up the domain sync task, please configure the following setting under '''Configuration (<i class="fa fa-wrench" aria-hidden="true"></i>) > System Settings > Automation Settings''' or, prior to WHMCS 8.0, '''Setup > Automation Settings''' first:
 * '''Domain Sync Enabled''' - Tick this checkbox to enable the domain date and status synchronisation function.
@@ Line 37: / Line 37: @@
 </div>
-In version 7.5 and earlier some of these settings are located under '''Setup > General Settings > Domains tab'''. An additional set up step is required to create a cron job to trigger the /crons/domainsync.php file:
+In version 7.5 and earlier some of these settings are located under ''''''Configuration (<i class="fa fa-wrench" aria-hidden="true"></i>) > System Settings > General Settings > Domains''' or, prior to WHMCS 8.0, '''Setup > General Settings > Domains'''. An additional set up step is required to create a cron job to trigger the /crons/domainsync.php file:
 '''Sample Cron Command'''
@@ Line 53: / Line 53: @@
 ===Curl error - could not connect to host===
-This is most commonly caused by not whitelisting the server's IP at your domain registrar (for example: eNom or ResellerClub) for API access. You will need to contact them and provide the IP from Help > License Information in your admin area for whitelisting to resolve this.
+This is most commonly caused by not whitelisting the server's IP at your domain registrar (for example: eNom or ResellerClub) for API access. You will need to contact them and provide the IP from '''Help > License Information''' in your admin area for whitelisting to resolve this.