Configurable Package Addon

The configurable package addon module allows cPanel, WP Squared, and DirectAdmin hosts to offer customizable packages to your clients. After activating the addon module, you can create as many configurable packages as you want, offering just some or all of the configurable options.

Hosts often use this to offer common options like requesting a dedicated IP address or choosing the desired number of addon domains.

  • WHMCS does not include this addon module by default.
  • cPanel & WHM version 78 and earlier require root-level access in order to use this addon module. For cPanel & WHM version 80 and later, resellers can use the addon module if they have the necessary WHM API token permissions.
  • For more information and current release data, see Configurable Package Addon on the WHMCS Marketplace.

Activation

To activate this addon module:

  1. Purchase and download the latest version of the addon module.
  2. Go to Help () > License Information.
  3. Click Force License Update to force a local license key update. This will allow your installation to use the addon module. There are no additional files to download.
  4. Go to Configuration () > System Settings > Products/Services.
  5. Set up a shared hosting package. When you do this:
    1. In the Pricing tab, disable any payment terms that you don’t want to accept by entering -1.
    2. Configure the desired module:
      • For the cPanel module:
        • In the Module Settings tab:
        • Set the module type to cPanel.
        • Set WHM Package Name to Custom.
        • Create a package on your cPanel & WHM server with the name Custom.
        • Set the package resources to the minimum resources to offer.
        • WHMCS will override any specified package resources and their defaults when creating a service.
      • For the WP Squared module:
        • In the Module Settings tab:
        • Set the module type to WP Squared.
        • Set WHM Package Name to Custom.
        • Create a package in WHM with the name Custom.
        • Set the package resources to the minimum resources to offer.
        • WHMCS will override any specified package resources and their defaults when creating a service.
      • For the DirectAdmin module, in the Module Settings tab:
        • Set the module type to DirectAdmin.
        • Set Package Name to Custom.
    3. Configure any limits that you don’t want to offer as options on the order form.
  6. Go to Configuration () > System Settings > Configurable Options.
  7. Create a configurable option group.
  8. Set up the desired options and their pricing using the option names below.
  9. Assign the group of options to the product you set up.
  10. Save the group.

Configurable Option Names

Configuring configurable options in the Admin Area

You can show clients a display name for options by using the required value|display value format for the option name.

For example:

Disk Space|Your Web Quota

For some systems (for example, DirectAdmin), you must use this format when setting up configurable options (see below). For others, this format is optional.

For more information, see Configurable Options.

cPanel

For cPanel, use the following option names, or create custom names to handle manually:

Option NameOption TypeOption Examples
Disk SpaceQuantity or Dropdown100|100 MB, 200|200 MB, 300|300 MB
BandwidthQuantity or Dropdown1000|1000 MB, 2000|2000 MB, 3000|3000 MB
Email AccountsQuantity or Dropdown1, 5, 10
MySQL DatabasesQuantity or Dropdown1, 5, 10
SubdomainsQuantity or Dropdown1, 5, 10
FTP AccountsQuantity or Dropdown1, 5, 10
Parked DomainsQuantity or Dropdown1, 5, 10
Addon DomainsQuantity or Dropdown1, 5, 10
Dedicated IPYes/NoYes or No
CGI AccessYes/NoYes or No
Shell AccessYes/NoYes or No

DirectAdmin

For DirectAdmin Quantity or Dropdown options, you must use the required value|display value format for option names.

For DirectAdmin, use the following option names, or create custom names to handle manually:

Option NameOption TypeOption ExamplesDefault
Disk Space
This option is required.
Quantity or Dropdown100|100 MB, 200|200 MB, 300|300 MBN/A (Required)
Bandwidth
This option is required.
Quantity or Dropdown1000|1000 MB, 2000|2000 MB, 3000|3000 MBN/A (Required)
FTP AccountsQuantity or Dropdown1, 5, 10Unlimited
Email AccountsQuantity or Dropdown1, 5, 10Unlimited
MySQL DatabasesQuantity or Dropdown1, 5, 10Unlimited
SubdomainsQuantity or Dropdown1, 5, 10Unlimited
Parked DomainsQuantity or Dropdown1, 5, 10Unlimited
Addon DomainsQuantity or Dropdown1, 5, 10Unlimited
CGI AccessYes/NoYes or NoNo
Shell AccessYes/NoYes or NoNo
Mailing ListsQuantity or Dropdown1, 5, 10N/A
PHPYes/NoYes or NoNo
SSLYes/NoYes or NoNo
System InfoYes/NoYes or NoNo
DNS ControlYes/NoYes or NoNo
Cron JobsYes/NoYes or NoNo
Catch AllYes/NoYes or NoNo
Spam AssassinYes/NoYes or NoNo
Anon FTPYes/NoYes or NoNo
Email ForwardsSee below.1, 5, 10, Yes, NoNo
Mailing ListsSee below.1, 5, 10, Yes, NoNo
Auto RespondersSee below.1, 5, 10, Yes, NoNo

WP Squared

For WP Squared, use the following option names, or create custom names to handle manually:

Option NameOption TypeOption Examples
Disk SpaceQuantity or Dropdown100|100 MB, 200|200 MB, 300|300 MB
BandwidthQuantity or Dropdown1000|1000 MB, 2000|2000 MB, 3000|3000 MB
Parked DomainsQuantity or Dropdown1, 5, 10
WordPress InstancesQuantity or Dropdown1, 5, 10
Addon DomainsQuantity or Dropdown1, 5, 10
Dedicated IPYes/NoYes or No
Shell AccessYes/NoYes or No
Email Forwards, Mailing Lists, and Auto Responders

When you create configurable options for Email Forwards, Mailing Lists, or Auto Reponders, you can choose the Quantity, Dropdown, or Yes/No option types.

  • If you select Quantity or Dropdown, create options for specific numbers and a Yes option (unlimited).
  • If you select Yes/No, create options for Yes (unlimited) and No (disabled).

Using this Addon Module

WHM Feature Lists

You cannot control or assign feature lists through this addon module. In WHMCS, you can only do this through predefined WHM packages.

Because of this, you can only use the default feature list for accounts that have configurable packages.

IP Addresses

You can use this addon module to assign unique IP addresses to accounts. However, you cannot use it to revert an account to the server’s shared IP address.

Last modified: December 23, 2024