Difference between revisions of "Configurable Package Addon"

From WHMCS Documentation

(→‎Setup)
(→‎Activating Configurable Package Addon)
 
(41 intermediate revisions by 8 users not shown)
Line 1: Line 1:
−
The configurable package addon is an addon module for cPanel (currently the only supported server type) web hosts to enable them to offer customisable packages to their clients.  This is done through combining the power of configurable options with an extended cpanel module for automated provisioning.
+
== About this Addon Module ==
  
−
After purchasing the addon from your client area account, you can create as many configurable packages as you want offering just some or all of the configurable options. Common offerings are options to request a dedicated IP, options to choose how many addon domains are wanted, how many email accounts, etc...
+
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 [https://marketplace.whmcs.com/product/30 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.
  
−
==Setup==
+
<table class="table" style="text-align:center;margin:1em 1em 1em 0;background:#F9F9F9;border:1px #AAA solid;border-collapse:collapse;width:100%;">
 +
<tr>
 +
<th style="border:1px #AAA solid;padding:0.2em;background:#F2F2F2;text-align:center;">Addon Name</th>
 +
<th style="border:1px #AAA solid;padding:0.2em;background:#F2F2F2;text-align:center;">Latest Release</th>
 +
<th style="border:1px #AAA solid;padding:0.2em;background:#F2F2F2;text-align:center;">Current Version</th>
 +
<th style="border:1px #AAA solid;padding:0.2em;background:#F2F2F2;text-align:center;">Compatible With</th>
 +
<th style="border:1px #AAA solid;padding:0.2em;background:#F2F2F2;text-align:center;">Included in WHMCS</th>
 +
</tr>
 +
<tr>
 +
<td style="border:1px #AAA solid;padding:0.2em;">Configurable Package Addon</td>
 +
<td style="border:1px #AAA solid;padding:0.2em;">N/A</td>
 +
<td style="border:1px #AAA solid;padding:0.2em;">N/A</td>
 +
<td style="border:1px #AAA solid;padding:0.2em;">N/A</td>
 +
<td style="border:1px #AAA solid;padding:0.2em;color:darkred;">No</td>
 +
</tr>
 +
</table>
  
−
To use the addon, you just need to follow these steps to enable & setup a package:
+
== Activating Configurable Package Addon ==
 +
 +
To activate this addon:
 +
 +
# Purchase the addon in the [https://marketplace.whmcs.com/product/30 WHMCS Marketplace].
 +
# 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.
 +
# Go to '''Configuration (<i class="fa fa-wrench" aria-hidden="true"></i>) > System Settings > [[Products and Services|Products/Services]]''' or, prior to WHMCS 8.0, '''Setup > Products/Services > Products/Services'''.
 +
# Set up a shared hosting package. When you do this:
 +
## Disable any payment terms you don't want to accept on the '''Pricing''' tab by entering <tt>-1</tt>.
 +
## 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.
 +
## 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.
 +
## For the DirectAdmin module, in the '''Module Settings''' tab, set the module type to ''DirectAdmin'' and set '''Package Name''' to ''Custom''.
 +
## Configure any limits that you don't want to offer as options on the order form.
 +
# Go to '''Configuration (<i class="fa fa-wrench" aria-hidden="true"></i>) > System Settings > [[Configurable Options]]''' or, prior to WHMCS 8.0, '''Setup > Products/Services > Configurable Options'''.
 +
# Create a configurable option group.
 +
# Set up the options you want to offer and their pricing. Use the option names below.
 +
# Assign the group of options to the product you set up.
 +
# Save the group.
  
−
# After purchasing, begin by going to Help > Check for Updates to force a local license key update - this will let your install know that you are now elligible to use the addon
+
=== Configurable Option Names ===
−
# Next, you need to setup a new Shared Hosting Package in the Products & Services Configuration Area
 
−
# Disable any payment terms you don't want to accept on the Pricing tab by entering -1 and leave the ones you do at zero
 
−
# On the Module Settings tab, set the module type to cPanel and set the WHM Package Name field to "Custom"
 
−
# Configure any of the limits on the Module Settings tab that you don't want to offer as options on the order form
 
−
# Now move to Setup > Configurable Options
 
−
# Here, click to create a new group and enter a name so you can identify it later
 
−
# Now it's time to setup the options you want to offer and their pricing.  The options can take the following names for WHMCS to recognise them and you can of course setup others aswell that you will manually handle.
 
  
−
Disk Space - 100MB, 200MB, 300MB, etc...
+
<div class="docs-alert-success">
−
Bandwidth - 1000MB, 2000MB, 3000MB, etc...
+
You can show a different display name to the required name here by using the format <tt>required value|display value</tt>. For example, <tt>Disk Space|Your Web Quota</tt>.
−
Email Accounts - 1,2,5,etc...
+
</div>
−
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...
 
−
Frontpage Extensions - Yes or No
 
−
Dedicated IP - Yes or No
 
−
CGI Access - Yes or No
 
−
Shell Access - Yes or No
 
  
−
More information on configurable options can be found in the  [[Addons_and_Configurable_Options|Configurable Options article]].<br />
+
==== cPanel ====
−
'''Note:''' 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"
 
  
−
# Now you just need to assign the group of options to the configurable package product you setup in step 1 and then save the group.
+
For cPanel, use the following option names or create custom names to handle manually:
  
−
That's it! Now visit your order form to try it out...
+
* 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)
 +
 
 +
<div class="docs-alert-success">
 +
You can show a different display name to the required name here by using the format <tt>required value|display value</tt>. For example, <tt>Disk Space|Your Web Quota</tt>.
 +
</div>
 +
 
 +
==== 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 [[CPanel/WHM#API_Token_Permissions|API Token Permissions]].
 +
 
 +
== Troubleshooting ==
 +
 +
''N/A''
 +
 +
== Change Log ==
 +
 
 +
''N/A''

Latest revision as of 19:52, 28 August 2023

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

Retrieved from "http://3.17.75.209/index.php?title=Configurable_Package_Addon&oldid=34227"