HostModules Docs

Activation

Once you have uploaded the addon files, activate the module in WHMCS and configure your license key.

Activating the Module

  1. Open Addon Modules

    In your WHMCS admin panel, go to:

    • WHMCS 8.x: System Settings → Addon Modules
    • WHMCS 7.x: Setup → Addon Modules

    (Note: WHMCS 7.x is not officially supported — see Requirements)

  2. Find HmSingleOrderAddon

    Scroll through the module list to find HmSingleOrderAddon. If you don’t see it, double-check that the module folder was uploaded to the correct location (modules/addons/HmSingleOrderAddon/).

  3. Click Activate

    Click the Activate button next to HmSingleOrderAddon. WHMCS will run the module’s activation routine.

  4. Enter your license key

    After activation, click Configure (or the module’s settings icon). Enter your license key in the License Key field:

    HMSO-XXXX-XXXX-XXXX-XXXX

    Click Save Changes.

  5. Verify activation

    Visit your checkout URL to confirm the new order form is active:

    https://yourdomain.com/whmcs/checkout.php?a=confproduct&i=0

    You should see the new single-page checkout design instead of the default WHMCS order form.

What Happens During Activation

When you activate HmSingleOrderAddon, the module automatically:

  1. Runs database migrations — creates the addon’s required tables (license cache, settings)
  2. Sets the order form template — updates OrderFormTemplate in the WHMCS tblconfiguration table to HmSingleOrderForm
  3. Seeds default settings — writes default addon configuration to the database

Template override

Activation sets OrderFormTemplate = HmSingleOrderForm automatically. This means all new orders will use the new template immediately after activation. If you want to test first without affecting live orders, install on a staging environment first.

Admin Access Permissions

By default, after activation, only WHMCS administrators with “Full Administrator” role can access the addon settings. You can grant access to specific admin roles under:

System Settings → Administrator Roles → Edit a role → Addon Modules → enable HmSingleOrderAddon

Deactivation

If you deactivate the addon:

  1. All addon database tables are dropped
  2. The OrderFormTemplate setting is rolled back to the WHMCS default (order)
  3. Your existing orders and clients are not affected — only the checkout template changes

Deactivation removes data

Deactivating the addon drops all addon-specific database tables, including cached license data and custom settings. Export your settings before deactivating if you plan to reinstall later.

Navigation