|
|
| (10 intermediate revisions by 4 users not shown) |
| Line 1: |
Line 1: |
| − | Configurable Options on products allow you to give your clients variables that alter the price of that product. [[Product Addons]] let you offer additional items that the client selects. The system bills them seperately from the product. | + | WHMCS has two distinct methods for configuring additional items for purchase with a main product: product addons and configurable options. The method you choose will depend on the specifics of your offerings. Configurable options on products allow you to give your clients ways to alter the price of that product while product addons do not. |
| | | | |
| − | *Configurable options are defined in groups.
| + | == Configurable Options == |
| − | *You can apply groups of options to one or more products.
| |
| | | | |
| − | ===When should I use configurable options instead of addons?===
| + | Use [[Configurable Options]] when: |
| | | | |
| − | *If you want to offer a choice of options for a single item (for example, Disk Space, Operating Systems, or Locations). | + | *You want to offer a choice of options for a single item. |
| − | *If you want to bill the total amount as a single item and not seperately. | + | *You want the total amount to be billed as a single item and not separately. |
| − | *If you want the billing cycle of the addon to match the billing cycle of the product. | + | *The billing cycle of the addon must match the billing cycle of the product. |
| | | | |
| − | ===When should I use addons instead of configurable options?===
| + | Configurable options are the best method for, for example, selling options like disk space or the choice of an operating system. |
| | | | |
| − | *If the item is a one-time service.
| + | You can work with configurable options at '''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'''. |
| − | *If clients can select the item independantly of other items.
| |
| − | *If you want to bill it on its own cycle (for example, you could bill a dedicated IP address annually regardless of the package cycle).
| |
| | | | |
| − | ==Configurable Options== | + | == Product Addons == |
| − | ===Setting up a New Group===
| |
| | | | |
| − | #Go to '''Setup > Products/Services > Configurable Options > Create a New Group'''.
| + | Use [[Product Addons]] when: |
| − | #Enter a name and description (for admin reference only) and choose the products it applies to (you can also do this later).
| |
| − | #Click '''Save Changes'''. The page will reload showing the group details and allowing you to move on to managing options.
| |
| | | | |
| − | ===Managing Options===
| + | * The item is a one-time service. |
| | + | * You want customers to select it independently of other items. |
| | + | * You want the option of billing on the item's own cycle. For example, an SSL certificate might be billed annually regardless of the package cycle. |
| | + | * In WHMCS 8.1 and earlier, the item is not subject to prorata at a product level or client-wide signup anniversary prorata. (In WHMCS 8.2 and later, you can choose to use prorata billing with addons.) |
| | | | |
| − | To manage options:
| + | Product addons are the best method for, for example, selling SSL certificates or dedicated IP addresses. |
| − | | + | |
| − | #Go to '''Setup > Products/Services > Configurable Options''' and click the edit icon next to the option group you want to modify. At the top of the page, you can edit the name, description, and assigned products.
| + | You can work with product addons at '''Configuration (<i class="fa fa-wrench" aria-hidden="true"></i>) > System Settings > [[Product Addons]]''', or, prior to WHMCS 8.0, '''Setup > Products/Services > Product Addons'''. |
| − | #To add a new configurable option, click '''Add New Configurable Option'''.
| |
| − | #A new window will allow you to enter an option name and choose a type. You can select from the following types:
| |
| − | #*'''Dropdown''' — Show a menu of options on the order form.
| |
| − | #*'''Radio''' — Show a selection of radio button options on the order form.
| |
| − | #*'''Yes/No''' — Show a checkbox on the order form that allows the client to turn the option on or off.
| |
| − | #*'''Quantity''' — Show an input field on the order form that allows the user to enter an item quantity.
| |
| − | #Enter the first sub-option value you want to offer for this option (you can set the price after saving).
| |
| − | #Click '''Save Changes'''. The page will refresh with the sub-option showing pricing fields.
| |
| − | #Enter pricing for all the cycles that the product has enabled.
| |
| − | #*If you selected '''Yes/No''' or '''Quantity''' for the type, then only one sub-option is necessary.
| |
| − | #*If you selected '''Dropdown''' or '''Radio''' for the type, use the '''Add Option''' field at the bottom of the page to add multiple sub-options.
| |
| − | #After every addition, click '''Save Changes''' to reload the page and set the new sub-options pricing.
| |
| − | #After you finish configuring your options, click '''Close Window'''. This will refresh the underlying page to show the new option.
| |
| − | #Repeat this process for each option you want to add.
| |
| − | #After you set up multiple options in the group, use the '''Sort Order''' column to define the display order for the options.
| |
| − | #Click '''Back to Groups List''' to complete the process.
| |
| − | | |
| − | ====Option Types==== | |
| − | WHMCS offers a variety of different configurable option types, allowing for choice of the most appropriate input format:
| |
| − | | |
| − | =====Dropdown=====
| |
| − | [[File:Co dropdown.png|right]]
| |
| − | The '''Dropdown''' option type displays a standard combo box. This is useful when there are a large number of items to choose from that should require minimal space on the order form.
| |
| − | | |
| − | =====Yes/No=====
| |
| − | [[File:Co yesno.png|right]]
| |
| − | The '''Yes/No''' option type displays a checkbox for the client to select or deselect. This is useful for simple opt-in-or-opt-out questions. Both yes or no are valid values, so the form validation will accept the unchecked state even if this is a required option.
| |
| − | | |
| − | =====Radio===== | |
| − | [[File:Co radio.png|right]] | |
| − | The '''Radio''' option type displays a list of the available options alongside a radio box for the client to choose from. If there are too many options, this can look messy. In that case, we recommend using '''Dropdown''' instead.
| |
| − | | |
| − | =====Quantity=====
| |
| − | [[File:Co quantity.png|right]]
| |
| − | The '''Quantity''' option type displays a field that allows the client to enter a number. Specify the unit price in the One Time/Monthly column. The system will multiply it by the quantity that the client selected.
| |
| − | | |
| − | When creating or editing a '''Quantity''' option, you can set maximum and minimum vales. You may also allow clients to enter any quantity by leaving '''both''' the 'Minimum' and 'Maximum' fields blank. However, you can't specify just a minimum or just a maximum value.
| |
| − | | |
| − | =====Slider=====
| |
| − | | |
| − | [[File:OrderFormConfigOptionsSliderNew1.png]]
| |
| − | | |
| − | The slider provides a graphical method for clients to specify a quantity. Like the '''Quantity''' option type, you must supply a minimum and maximum quantity and use it in conjunction with all order form templates (except Boxes).
| |
| − | | |
| − | ===Hiding Options===
| |
| − | | |
| − | Hiding is useful for when you want to remove an option that you no longer offer to new signups from the order forms, but don't want to lose the selections for existing customers.
| |
| − | | |
| − | You can hide entire configurable options or just individual sub-options. Do this in the managing options screen by checking the Hidden/Hide box for an option you want to disable.
| |
| − | | |
| − | '''Important Note:''' Once you hide an option or sub-option, admin users continue to see it for existing customers.
| |
| − | | |
| − | '''Note:''' As of version v5.3 and above, the "Starting From" price on cart.php in the Modern order form template doesn't include hidden configurable options. Prior to this, the price included hidden configurable options.
| |
| − | | |
| − | ===Friendly Display Names===
| |
| − | Sometimes, a module may require you to format a configurable option valu in a certain way, but this might be difficult for visitors to understand. WHMCS can display a friendly name to visitors on the order form, emails, and invoices, but still send the required machine code to the module.
| |
| − | [[File:Config option friendly.png|thumb|Config Option Friendly Names]]
| |
| − | To achieve this, use the format "required value|display value". For example:
| |
| − | | |
| − | *Disk Space|Your Web Quota
| |
| − | *10000MB|10 Gigabytes
| |
| − | *rbx01ssd|French Server - Solid State Drive
| |
| − | | |
| − | ===Product Addons===
| |
| − | For information about product addons, see [[Product Addons]].
| |
WHMCS has two distinct methods for configuring additional items for purchase with a main product: product addons and configurable options. The method you choose will depend on the specifics of your offerings. Configurable options on products allow you to give your clients ways to alter the price of that product while product addons do not.
Configurable options are the best method for, for example, selling options like disk space or the choice of an operating system.
Product addons are the best method for, for example, selling SSL certificates or dedicated IP addresses.