If you are running WHMCS 7.0 or higher and your auto-provisioning module supports it, you can provision new sites through the built-in WHMCS cron job process rather than processing the installation in real-time while the customer is waiting for their order to process. Allowing the provisioning process to run during a cron job in the background, dramatically improves your customer's user experience by speeding up the loading time of the front-end website when they are submitting their order. It also enables admins to initiate a site install or re-install, without needing to wait for the process to complete before moving on to other activities.
- When the "Create" module command is initiated, either through processing a new order or by pressing the Create module command from the admin interface, the user's new hosting account will be immediately created, but the new site (e.g. WordPress, WHMCS, etc.) will not be installed until the cron job runs.
- The frequency of the WHMCS cron job is dependent on how you have WHMCS configured, but the recommended frequency for this cron job is every 5 minutes.
- When the WHMCS cron job runs, the provisioning script will run and install the client's new site. Once the site has been installed, if the configuration option is enabled to send a welcome e-mail, the e-mail will be sent to let the client know that their site is ready to go.
How to enable/disable the provisioning cron job process (referred to as "staging" in the module):
1. Go to Setup -> Addon Modules in WHMCS and press the Configure button for the applicable auto-provision module.
2. Check or uncheck the Stage [Site Type] Sites option.
3. Press Save Changes.
When enabled, all site install/re-install requests will be processed by the cron job. This includes requests submitted from the admin interface. This means that when the Create or Re-Install module command buttons are pressed, you will need to wait for the cron job to run before the requested action will be completed.
You can view the status of any pending cron job installations by going to Addons -> [Provisioning Module Name] (e.g. Addons -> WordPress Auto-Provision) and then click on the View Pending Cron Job Installs link in the upper right-hand corner of the screen. From this screen, you can view cron job installs that are either pending or have failed as well as remove any pending jobs that you do not want to be run. To view the cause of a failed cron job, simply go to Utilities -> Logs -> Activity Log.