Addon Settings
After activating and licensing the module, configure it from the WHMCS admin: System Settings → Addon Modules → HmSingleOrderAddon → Configure.
Available Settings
License Key
| Field | Type | Required |
|---|---|---|
| License Key | Text | Yes |
Your HMSO-XXXX-XXXX-XXXX-XXXX license key. See License Setup for details.
Enable Redirects
| Field | Type | Default |
|---|---|---|
| Enable Redirects | Yes / No | Yes |
When enabled, the addon automatically redirects visitors who access the default WHMCS order URLs (e.g. /cart.php) to the new single-page order form at /checkout.php.
This is useful if:
- You have existing links pointing to the old cart URL
- Customers bookmark old product order URLs
- WHMCS auto-generates cart links in emails
Tip
Enable this setting after going live to catch any old links that still point to the default WHMCS cart.
If you prefer to control the checkout URL yourself (e.g. via product page custom links) and don’t want automatic redirects, set this to No.
Debug Mode
| Field | Type | Default |
|---|---|---|
| Debug Mode | Yes / No | No |
When enabled, the addon outputs detailed diagnostic information at the bottom of the checkout page. This includes:
- License validation status
- Configuration values loaded
- Database query logs
- Smarty template variable dumps
Never enable in production
Debug Mode exposes sensitive internal data. Only enable it in a staging or development environment, and disable it immediately after troubleshooting.
Saving Settings
Click Save Changes after updating any setting. Most settings take effect immediately on the next page load.
After Saving
After saving settings for the first time (or after updating the license key), the addon re-runs its license validation. If validation succeeds, the module status shows as Active.
Common reasons settings don’t save:
- Session timeout — your admin session expired while on the settings page; log in again
- Database write error — check WHMCS’s
storage/logs/for details - PHP errors — check your server error log for PHP fatal errors in the addon module files
Info
If you change the License Key, the cached license data is cleared automatically and a fresh validation is performed on the next checkout page load.