Difference between revisions of "Product Bundles"

From WHMCS Documentation

(Setting Up a New Bundle)
(Setting Up a New Bundle)
 
(15 intermediate revisions by 4 users not shown)
Line 1: Line 1:
Product Bundles are a very powerful tool in WHMCS, allowing you to not only setup order form links that will automatically take the user through the process of adding 2 or more products in a single ordering process, but also provide a way to link to the order form from the pages of your site with specific configurations pre-selected by default.
+
Product Bundles are a very powerful tool in WHMCS. They can allow you to set up order form links that will automatically take the user through the process of adding two or more products in a single ordering process. They will also provide a way to link to the order form from the pages of your site, with specific preselected configurations, by default.
 +
 
 +
You can access this feature at '''Configuration (<i class="fa fa-wrench" aria-hidden="true"></i>) > System Settings > Product Bundles'''.
  
 
==What a Product Bundle Can Do==
 
==What a Product Bundle Can Do==
Line 5: Line 7:
 
Product bundles allow you to:
 
Product bundles allow you to:
  
*Generate shortcut links to add a product to the cart with preconfigured selections & values
+
*Generate shortcut links to add a product to the cart with preconfigured selections and values.
*Generate order links that involve adding more than one product to the cart
+
*Generate order links that involve adding more than one product to the cart.
*Create incentives where if a user buys 2 or more items, and with specific configurations, they get a discount
+
*Create incentives in which, if they buy two or more items with specific configurations, the user receives a discount.
  
 
==Some Examples==
 
==Some Examples==
  
Here's just a few examples of the type of offers you can create using bundles:
+
For example, you could create some of these offers using bundles:
  
 
*Buy Hosting for a Year along with a Domain and Save $x
 
*Buy Hosting for a Year along with a Domain and Save $x
Line 19: Line 21:
 
*Buy Product X on Billing Cycle Y, and get 50% off Product Z
 
*Buy Product X on Billing Cycle Y, and get 50% off Product Z
 
*Buy Product X with 2 domains and get the second domain free
 
*Buy Product X with 2 domains and get the second domain free
 
(All numeric values are simply examples of what can be done)
 
  
 
==Bundle Requirements==
 
==Bundle Requirements==
  
With bundles, one of the key aims is to incentivise a user into buying more than 1 item, often by giving them a discount for ordering in a certain combination. And so with bundles in WHMCS, you can setup discounts to be applied based on any of a number of requirements. Those requirements can be restrictions on any of the following:
+
One of the key reasons for bundles is to incentivize a user into buying more than one item, often by giving them a discount for ordering in a certain combination. With bundles in WHMCS, you can set up discounts to apply based on any of a number of requirements. Those requirements can be restrictions on any of the following:
  
 
*Actual Products in the Cart
 
*Actual Products in the Cart
Line 36: Line 36:
 
==Setting Up a New Bundle==
 
==Setting Up a New Bundle==
  
[[File:BundlesConfig.PNG|thumb|Bundle Item Configuration]]
+
[[File:BundlesConfig1.png|thumb|Bundle Item Configuration]]
[[File:BundleOrder.PNG|thumb|Bundle Order Summary showing Discounts]]
+
[[File:BundleOrderReqs1.png|thumb|Bundle Order Summary Requirements Not Met]]
[[File:BundleOrderReqs.PNG|thumb|Bundle Order Summary Requirements Not Met]]
+
 
 +
To set up a new bundle:
  
#Begin by going to '''Setup > Product Bundles'''
+
#Under the '''Options''' heading, choose '''Create New Bundle'''.
#Under the Options heading, choose '''Create New Bundle'''
+
#Enter a name for the bundle, a description (optional), and the valid from and to date (by default, one month from the current date).
#Here you must enter a name for the bundle, a description (optional), the valid from and to date (defaults to 1 month from the current date) or check the No Expiry option for unlimited, and the maximum number of uses (if a limit is desired - 0 for unlimited)
+
#Check the '''No Expiry''' option for unlimited uses, or enter the maximum number of uses (select 0 for unlimited).
#You must then save to create the bundle before you can start actually adding items to it
+
#Save to create the bundle. A new option, '''Add Another''', will appear in the bundle items section.
#Following saving you will then see a new option called '''Add Another''' in the bundle items section
+
#Click the link to open the item configuration screen.
#Click that link to open the item configuration screen (screenshot right)
+
#Choose the type of item you're adding (product or domain).
#In this window you first have to choose the type of item you're adding - product or domain - and then configure the options for that item
+
#Configure the options for that item. Any options you select here from the billing cycle, addons, configurable option values, qualfiying TLDs, registration period, and domain addons become requirements for that bundle. The user must select them to be able to proceed with the bundle order process. The system will also preselect any cycle, addon, and option requirements for the user during the order process.
#Any options you select here from the billing cycle, addons, configurable option values, qualfiying TLDs, registration period & domain addons then become requirements for that bundle, and the user will be forced to select them to be able to proceed with the bundle order process. Any cycle, addon and option requirements will also be preselected for the user during the order process.
+
#Use the '''Price Override''' field to grant a discount for an item when the order has met all of the requirements for the bundle. This requires that all items in the bundle are in the cart and that all the requirements above match this. The price override replaces the price of the product or domain (with separate price override fields for each). This price must include both the main product and any configurable options you have selected (excluding addons).
#The Price Override field can be used to grant a discount for an item when all the requirements for the bundle are met - that means all items in the bundle added to the cart, and all requirements specified above matching (see screenshots right). The price override replaces the price of the product and/or domain (separate price override fields for each) and so this price must include both the main product and any configurable options you have selected (excludes addons)
+
#When adding a product that contains configurable options to a bundle, select the '''Restrict''' checkbox to preselect the selected option during ordering and require it for the bundle.
#For a hosting based product or any that should include a domain, you can require a domain by enabling any of the domain related requirements for the bundle item, so for example selecting all the Qualifying TLDs, or selecting a registration period the domain must be ordered for
+
#For a hosting-based product or any that should include a domain, enable any of the domain-related requirements for the bundle item in order to require a domain. For example, select all the Qualifying TLDs, or select a registration period for which the client must order the domain.
  
'''NOTE:''' The Price Override field overrides the base product price. Any addons or configurable options the client chooses will be
+
'''NOTE:''' The Price Override field overrides the base product price. Any addons or configurable options the client chooses will be '''additional''' to the normal price. If you need to discount addons and configurable options as well, a [[Promotions|promotion code]] may be more appropriate.
'''added on top''' at the normal price. If you need to discount addons and configurable options as well, a
 
[[Promotions|promotion code]] may be more appropriate.
 
  
 
==Using Bundles==
 
==Using Bundles==
  
Bundles are most commonly linked to direct from the product information pages of your site. So as with the direct order links used for individual products (cart.php?a=add&pid=X) you link to bundles in a similar way but instead specifying a bundle ID rather than a product ID. WHMCS provides the link for you to use on the bundle edit screen within the admin area, and it will look something like this:
+
Usually, you will link to bundles directly from the product information pages of your site. This is similar to direct order links for individual products (cart.php?a=add&pid=X), but bundles require a bundle ID instead of a product ID. WHMCS provides the link for you to use on the bundle edit screen within the admin area. For example:
 +
 
 +
http://www.example.com/whmcs/cart.php?a=add&bid=X
  
http://www.yourdomain.com/whmcs/cart.php?a=add&bid=X
+
You may also choose to offer some bundles on your order form itself. To do this, check the "Show on Order Form" checkbox in the bundle configuration options. Doing this for one or more bundles adds a new order form category,  "Product Bundles", within the cart. This category lists your bundle offerings and with the description you set.
  
 +
==Notes==
  
You may also choose to offer some bundles on your order form itself, which you can do by ticking the "Show on Order Form" checkbox in the bundle configuration options.  Doing this for 1 or more bundles enables a new order form category named "Product Bundles" to be displayed within the cart, listing any bundle offerings you have setup along with the description you set.
+
For bundles where there are multiple instances of the same product in the bundle, "[[Products_and_Services|Allow Multiple Quantities]]" on the product should be disabled otherwise the bundle will not work as expected.

Latest revision as of 19:41, 26 May 2022

Product Bundles are a very powerful tool in WHMCS. They can allow you to set up order form links that will automatically take the user through the process of adding two or more products in a single ordering process. They will also provide a way to link to the order form from the pages of your site, with specific preselected configurations, by default.

You can access this feature at Configuration () > System Settings > Product Bundles.

What a Product Bundle Can Do

Product bundles allow you to:

  • Generate shortcut links to add a product to the cart with preconfigured selections and values.
  • Generate order links that involve adding more than one product to the cart.
  • Create incentives in which, if they buy two or more items with specific configurations, the user receives a discount.

Some Examples

For example, you could create some of these offers using bundles:

  • Buy Hosting for a Year along with a Domain and Save $x
  • Buy Hosting and an SSL Certificate, and get a Domain Free
  • Buy Annual Hosting + Product X and Save $20
  • Buy Product X, Y & Z together and save 25%
  • Buy Product X on Billing Cycle Y, and get 50% off Product Z
  • Buy Product X with 2 domains and get the second domain free

Bundle Requirements

One of the key reasons for bundles is to incentivize a user into buying more than one item, often by giving them a discount for ordering in a certain combination. With bundles in WHMCS, you can set up discounts to apply based on any of a number of requirements. Those requirements can be restrictions on any of the following:

  • Actual Products in the Cart
  • Billing Cycle
  • Selected Configurable Options
  • Selected Product Addons
  • Domain TLD/Extension
  • Domain Registration Period
  • Domain Addons

Setting Up a New Bundle

Bundle Item Configuration
Bundle Order Summary Requirements Not Met

To set up a new bundle:

  1. Under the Options heading, choose Create New Bundle.
  2. Enter a name for the bundle, a description (optional), and the valid from and to date (by default, one month from the current date).
  3. Check the No Expiry option for unlimited uses, or enter the maximum number of uses (select 0 for unlimited).
  4. Save to create the bundle. A new option, Add Another, will appear in the bundle items section.
  5. Click the link to open the item configuration screen.
  6. Choose the type of item you're adding (product or domain).
  7. Configure the options for that item. Any options you select here from the billing cycle, addons, configurable option values, qualfiying TLDs, registration period, and domain addons become requirements for that bundle. The user must select them to be able to proceed with the bundle order process. The system will also preselect any cycle, addon, and option requirements for the user during the order process.
  8. Use the Price Override field to grant a discount for an item when the order has met all of the requirements for the bundle. This requires that all items in the bundle are in the cart and that all the requirements above match this. The price override replaces the price of the product or domain (with separate price override fields for each). This price must include both the main product and any configurable options you have selected (excluding addons).
  9. When adding a product that contains configurable options to a bundle, select the Restrict checkbox to preselect the selected option during ordering and require it for the bundle.
  10. For a hosting-based product or any that should include a domain, enable any of the domain-related requirements for the bundle item in order to require a domain. For example, select all the Qualifying TLDs, or select a registration period for which the client must order the domain.

NOTE: The Price Override field overrides the base product price. Any addons or configurable options the client chooses will be additional to the normal price. If you need to discount addons and configurable options as well, a promotion code may be more appropriate.

Using Bundles

Usually, you will link to bundles directly from the product information pages of your site. This is similar to direct order links for individual products (cart.php?a=add&pid=X), but bundles require a bundle ID instead of a product ID. WHMCS provides the link for you to use on the bundle edit screen within the admin area. For example:

http://www.example.com/whmcs/cart.php?a=add&bid=X

You may also choose to offer some bundles on your order form itself. To do this, check the "Show on Order Form" checkbox in the bundle configuration options. Doing this for one or more bundles adds a new order form category, "Product Bundles", within the cart. This category lists your bundle offerings and with the description you set.

Notes

For bundles where there are multiple instances of the same product in the bundle, "Allow Multiple Quantities" on the product should be disabled otherwise the bundle will not work as expected.