Requirements
Before installing HmSingleOrderAddon, make sure your hosting environment meets the following requirements.
Server Requirements
| Component | Minimum | Recommended |
|---|---|---|
| PHP | 7.4 | 8.1 or 8.2 |
| MySQL / MariaDB | 5.7 / 10.3 | 8.0 / 10.6 |
| Disk space | ~5 MB | — |
| File permissions | Web server write access to modules/addons/ | — |
PHP Extensions
The following PHP extensions must be enabled:
pdo_mysql— database connectivitycurl— license validationjson— configuration handlingmbstring— multi-byte string supportopenssl— secure license communication
Most managed hosting providers enable these by default. You can verify them in WHMCS under Utilities → PHP Info.
WHMCS Requirements
| Requirement | Version |
|---|---|
| WHMCS | 8.0 or later |
| WHMCS license | Active and in good standing |
| Admin account | Full administrator access to activate the addon |
WHMCS 7.x not supported
HmSingleOrderAddon requires WHMCS 8.x. It will not activate on WHMCS 7.x or earlier due to changes in the module loading API.
License Requirement
You must purchase a valid HmSingleOrderAddon license from the HostModules website. Your license key is in the format:
HMSO-XXXX-XXXX-XXXX-XXXX
The license is validated against your WHMCS installation URL. One license covers one WHMCS installation. You can use the same key on a staging environment at no extra charge — contact support to whitelist your staging domain.
Required Configuration
Before installation works correctly, WHMCS should have:
- At least one active product in a product group
- At least one active payment gateway configured
- Email notifications configured (optional, but recommended)
Staging environment
We recommend testing the installation on a staging copy of your WHMCS first to verify everything works before deploying to production.