HostModules Docs

Installation

Follow these steps carefully to install HmSingleOrderAddon into your WHMCS installation.

Back up first

Always take a full backup of your WHMCS files and database before installing any addon or template.

What You’ll Receive

After purchasing, your download package contains two folders:

File Structure 
hmso-v1.1.0/
├── modules/
│   └── addons/
│       └── HmSingleOrderAddon/          ← Addon files
│           ├── HmSingleOrderAddon.php
│           ├── app/
│           └── ...
└── templates/
  └── orderforms/
      └── HmSingleOrderForm/           ← Order form template
          ├── checkout.tpl
          ├── css/
          └── ...

Installation Steps

  1. Download the package

    Log in to the HostModules client area and navigate to My Products. Download the latest HmSingleOrderAddon zip file.

  2. Upload the addon module

    Extract the zip file on your computer. Upload the modules/addons/HmSingleOrderAddon/ folder to your WHMCS installation at the same path:

    /path/to/whmcs/modules/addons/HmSingleOrderAddon/

    You can use FTP, SFTP, or your hosting control panel’s file manager.

  3. Upload the order form template

    Upload the templates/orderforms/HmSingleOrderForm/ folder to your WHMCS installation:

    /path/to/whmcs/templates/orderforms/HmSingleOrderForm/

  4. Set file permissions

    Ensure the web server can read all uploaded files. Typical permissions:

    • Directories: 755
    • Files: 644

    On cPanel, you can set permissions via the File Manager. On SSH, run:

    find modules/addons/HmSingleOrderAddon -type d -exec chmod 755 {} \;
find modules/addons/HmSingleOrderAddon -type f -exec chmod 644 {} \;
find templates/orderforms/HmSingleOrderForm -type d -exec chmod 755 {} \;
find templates/orderforms/HmSingleOrderForm -type f -exec chmod 644 {} \;

  5. Activate the addon in WHMCS

    Log in to your WHMCS admin area and go to:

    Setup → Addon Modules (WHMCS 8.x: System Settings → Addon Modules)

    Find HmSingleOrderAddon in the list and click Activate.

    See the Activation page for what happens during activation.

Verify the Upload

After uploading, you should see the following structure on your server:

File Structure 
whmcs/
├── modules/addons/HmSingleOrderAddon/
│   ├── HmSingleOrderAddon.php    ← Main module file
│   ├── app/
│   │   ├── Controllers/
│   │   ├── Models/
│   │   ├── Services/
│   │   └── ...
│   ├── config/
│   └── vendor/
└── templates/orderforms/HmSingleOrderForm/
  ├── checkout.tpl
  ├── products.tpl
  ├── viewcart.tpl
  ├── configureproduct.tpl
  ├── configuredomains.tpl
  ├── complete.tpl
  ├── error.tpl
  ├── css/
  │   └── hm-main.css
  └── js/

Tip

If you see an “Access Denied” error when viewing the WHMCS Addon Modules page after uploading, make sure the directory permissions are set to 755 and file permissions to 644.

Next Step

Proceed to Activation to activate the addon and configure your license key.

Navigation