Configurable Package Addon

From WHMCS Documentation

About this Addon Module

The configurable package addon allows cPanel, WP Squared, and DirectAdmin hosts to offer customizable packages to your clients. You can order this addon for your license in the WHMCS Marketplace.

After purchasing the addon, 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.

Addon Name Latest Release Current Version Compatible With Included in WHMCS
Configurable Package Addon N/A N/A N/A No

Activating Configurable Package Addon

To activate this addon:

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

Configurable Option Names

You can show a different display name to the required name here by using the format required value|display value. For example, Disk Space|Your Web Quota.

cPanel

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

  • Disk Space - 100MB, 200MB, 300MB, etc...
  • Bandwidth - 1000MB, 2000MB, 3000MB, etc...
  • Email Accounts - 1,2,5,etc...
  • MySQL Databases - 1,2,5,etc...
  • Subdomains - 1,2,5,etc...
  • FTP Accounts - 1,2,5,etc...
  • Parked Domains - 1,2,5,etc...
  • Addon Domains - 1,2,5,etc...
  • Dedicated IP - Yes or No
  • CGI Access - Yes or No
  • Shell Access - Yes or No

DirectAdmin

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

  • Disk Space (*Required* No Default - Value in MB - Quantity or DropDown with System|Friendly values)
  • Bandwidth (*Required* No Default - Value in MB - Quantity or DropDown with System|Friendly values)
  • FTP Accounts (Unlimited - Quantity or Dropdown with System|Friendly values)
  • Email Accounts (Unlimited - Quantity or Dropdown with System|Friendly values)
  • MySQL Databases (Unlimited - Quantity or Dropdown with System|Friendly values)
  • Subdomains (Unlimited - Quantity or Dropdown with System|Friendly values)
  • Parked Domains (Unlimited - Quantity or Dropdown with System|Friendly values)
  • Addon Domains (Unlimited - Quantity or Dropdown with System|Friendly values)
  • CGI Access (OFF - Yes/No Field)
  • Shell Access (OFF - Yes/No Field)
  • Mailing Lists (No Default - Quantity or DropDown with System|Friendly values)
  • PHP (OFF - Yes/No Field)
  • SSL (OFF - Yes/No Field)
  • System Info (OFF - Yes/No Field)
  • DNS Control (OFF - Yes/No Field)
  • Cron Jobs (OFF - Yes/No Field)
  • Catch All (OFF - Yes/No Field)
  • Spam Assassin (OFF - Yes/No Field)
  • Anon FTP (OFF - Yes/No Field)
  • Email Forwards (OFF - Quantity or DropDown with System|Friendly values to provide number for specific number or YES for *Unlimited or Yes/No field to enable unlimited)
  • Mailing Lists (OFF - Quantity or DropDown with System|Friendly values to provide number for specific number or YES for *Unlimited or Yes/No field to enable unlimited)
  • Auto Responders (OFF - Quantity or DropDown with System|Friendly values to provide number for specific number or YES for *Unlimited or Yes/No field to enable unlimited)

You can show a different display name to the required name here by using the format required value|display value. For example, Disk Space|Your Web Quota.

WP Squared

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

  • Disk Space - 100MB, 200MB, 300MB
  • Bandwidth - 1000MB, 2000MB, 3000MB
  • Parked Domains - 1,2,5
  • WordPress Instances - 1,2,5
  • Dedicated IP - Yes or No
  • Shell Access - Yes or No

Using this Addon

WHM Feature Lists

Due to a limitation in WHM, feature lists can only be controlled or assigned through predefined packages in WHM and not via this addon. As a result, only the default Feature List can be used with accounts created with configurable packages.

IP Addresses

The addon can be used to assign unique IP addresses to accounts. However it cannot currently be used to revert an account back to the server's shared IP address.

Root Access Required

As of cPanel & WHM version 80, root access is no longer required. It is now possible to use this addon with a reseller account as long as the permissions configured on the WHM API token match the required API Token Permissions.

Troubleshooting

N/A

Change Log

N/A