WHMCS Settings
HmSingleOrderAddon integrates tightly with standard WHMCS configuration. The settings on this page are found in the WHMCS admin panel under System Settings → General Settings and related areas — they affect how your order form functions.
General Settings
Company Information
The company name, logo, and contact details you configure in General Settings → General are pulled into the checkout form header automatically.
| WHMCS Setting | Effect on Order Form |
|---|---|
| Company Name | Shown in page title and meta tags |
| Logo Image | Shown in checkout header (if template uses $companylogo) |
| Default Country | Pre-selects country in the billing address form |
Order Settings
Navigate to System Settings → General Settings → Orders to configure order-related behavior.
| Setting | Recommended Value | Notes |
|---|---|---|
| Automatically Accept Orders | Off (for manual review) or On | Orders placed through the addon are subject to this setting |
| Automatically Setup Hosting Products | On | Immediately provisions hosting when payment is received |
| Fraud Check Level | Per your needs | Fraud checks apply to orders placed through the addon |
Shopping Cart Settings
HmSingleOrderAddon uses WHMCS’s own cart engine under the hood, so these settings apply:
| Setting | Notes |
|---|---|
| Allow Multiple Quantities | If enabled, customers can order multiple units |
| Require Login to Order | If enabled, customers must log in or register before checkout |
| Disable Guest Checkout | Forces account creation |
Guest checkout
We recommend enabling guest checkout for the best conversion rates. You can still capture customer details during the order process without forcing them to create a password first.
Currency Settings
Go to Payments → Currencies to manage currencies. The order form displays prices in the customer’s detected currency (or the default if no match is found).
- Set a Default Currency that is accepted by all your configured payment gateways
- Ensure exchange rates are kept up to date if you offer multiple currencies
Info
If a customer’s currency doesn’t match a payment gateway’s supported currencies, the order form will display a warning or fall back to the default currency depending on your gateway configuration.
Tax Settings
Tax rules configured in Payments → Tax Rules apply to orders placed through the addon. The order form displays tax-inclusive or tax-exclusive pricing based on your WHMCS tax settings.
Domain Registrar Settings
For the domain registration step to work, you must have at least one active domain registrar configured in System Settings → Domain Registrars. The addon’s domain search queries the registrar’s availability API in real time.
Email Templates
Order confirmation and invoice emails are sent using the standard WHMCS email templates. Customize these under System Settings → Email Templates. Relevant templates include:
- Order Confirmation — sent when an order is placed
- Invoice Created — standard invoice email
- Order Accepted — sent when the order status changes to Active
Automation Settings
Ensure the WHMCS Cron Job is running. The addon relies on standard WHMCS automation for:
- Invoice generation
- Overdue reminders
- Domain expiry notifications
- Product provisioning retries
See WHMCS Cron Job documentation for setup instructions.