Difference between revisions of "Standard Order Form Templates"

From WHMCS Documentation

(Using Feature Highlights)
(Using Feature Highlights)
Line 167: Line 167:
 
==Using Feature Highlights==
 
==Using Feature Highlights==
  
Feature Highlights are supported by the '''Slider''', '''Modern''', '''Comparison''', '''Premium Comparison''', '''Pure Comparison''', '''Cloud Slider''' and '''Standard Cart''' cart templates. The idea behind these is to allow you to highlight or bring attention to certain key features of each product/service.
+
Feature Highlights allow you to define features and their values for products in a way that WHMCS can interpret for comparison based display.
  
They are used by entering features in the format "'''Attribute: Value'''" within the product description field, one per line, starting on the first line of the descriptionAnd in the case of the Slider & Modern templates, you can also include a text description to be displayed below them.
+
Feature Highlights are supported by most order form templatesSee the above descriptions for exact details.
  
For best results it is recommended that you make it so that all products in the same group, have the exact same attributes specified.
+
[[File:PremiumComparisonFeatureHighlights.png|right]]
 +
===Usage===
  
For example, on shared hosting products you might create a description like this:
+
Feature Highlights are specified as part of the product description.  They must be entered in the following format, with one feature per line.
 +
 
 +
'''Feature: Value'''
 +
 
 +
For example, the description for a shared hosting product using Feature Highlights might look like this:
  
 
  Disk Space: 1000MB
 
  Disk Space: 1000MB
Line 180: Line 185:
 
  Subdomains: 3
 
  Subdomains: 3
 
  Addon Domains: 1
 
  Addon Domains: 1
 
And a further text description can go here to be displayed below the highlights...
 
  
 +
The preview on the right shows how the above would be rendered in the Premium Comparison order form.
 +
 +
<div class="docs-alert-info">For best results we recommend that you use the same features and in the same order for all products within the same product group.</div>
  
 
===Disabling Feature Highlights===
 
===Disabling Feature Highlights===
There may be occasions when it's desirable to disable feature highlights, such as when wishing to use colons in the product description (as these would normally be converted to a feature highlight). Edit the /templates/orderforms/*your active template*/products.tpl template file and perform these two edits:
+
 
 +
There may be occasions when it's required to disable feature highlights, such as when wishing to use other markup in the product description. To do this, simply edit the /templates/orderforms/*your active template*/products.tpl template file and perform these two edits:
  
 
# Replace '''{$product.featuresdesc}''' with '''{$product.description}'''
 
# Replace '''{$product.featuresdesc}''' with '''{$product.description}'''
#Remove/comment out:
+
# Remove/comment out:
 
<source lang="php">
 
<source lang="php">
 
{foreach from=$product.features key=feature item=value}
 
{foreach from=$product.features key=feature item=value}
Line 196: Line 203:
 
</source>
 
</source>
  
Save changes and upload the files modified files. Now on the cart.php file, your products descriptions will be displayed without feature highlights.
+
Save changes and upload the modified template file. Now product descriptions will be displayed as entered.
  
 
==Using Different Templates for Different Products==
 
==Using Different Templates for Different Products==

Revision as of 10:45, 25 November 2015

WHMCS includes a number of standard order form templates to choose from to provide the best ordering experience for your visitors. To select a template navigate to Setup > General Settings > Ordering tab. This page describes the various templates, for instructions customising them refer to Order Form Templates.

Templates

Standard Cart

Supported Features

Headline: Yes
Tagline: Yes
Feature Highlights: Yes
Featured Products: Yes
Product Group Features: Yes
Number of Products: For best results 3, supports unlimited.
Compatible With: Six template/Bootstrap 3

The default shopping cart experience in Version 6.1 and later. Compatible with all types of products.

Premium Comparison

Premium Comparison

Supported Features

Headline: Yes
Tagline: Yes
Feature Highlights: Yes
Featured Products: Yes
Product Group Features: Yes
Number of Products: For best results 3, supports unlimited.
Compatible With: Six template/Bootstrap 3

Perfect for comparing a number of products/services. You should utilise the product features functionality to define comparable features/values, and ensure you have the same format/order for all descriptions of products within the group for best results.

Pure Comparison

Pure Comparison

Supported Features

Headline: Yes
Tagline: Yes
Feature Highlights: Yes
Featured Products: Yes
Product Group Features: Yes
Number of Products: For best results 4, supports unlimited.
Compatible With: Six template/Bootstrap 3

Perfect for comparing a number of products/services. You should utilise the product features functionality to define comparable features/values, and ensure you have the same format/order for all descriptions of products within the group for best results.

Cloud Slider

Cloud Slider

Supported Features

Headline: Yes
Tagline: Yes
Feature Highlights: Yes
Featured Products: Yes
Product Group Features: Yes
Number of Products: For best results between 2 and 12, supports unlimited space permitting.
Compatible With: Six template/Bootstrap 3

Perfect for comparing a number of products/services. You should utilise the product features functionality to define comparable features/values. For best results use 4 feature/value comparisons. and ensure you have the same format/order for all descriptions of products within the group for best results.

Boxes

Boxes

Supported Features

Headline: No
Tagline: No
Feature Highlights: No
Featured Products: No
Product Group Features: No
Number of Products: Unlimited
Compatible With: Six template/Bootstrap 3

A flexible cart that is designed to work for most types of products.

Cart

Cart

Supported Features

Headline: No
Tagline: No
Feature Highlights: No
Featured Products: No
Product Group Features: No
Number of Products: Unlimited
Compatible With: Five template/Bootstrap 2

Replaced by the Standard Cart in 6.1. This cart is now deprecated and will no longer receive updates.

Comparison

Comparison

Supported Features

Headline: No
Tagline: No
Feature Highlights: Yes
Featured Products: No
Product Group Features: No
Number of Products: For best results 4, supports unlimited.
Compatible With: Five template/Bootstrap 2

This visually appealing template allows you to display a comparison table of your products & services. This is done using the feature highlights method described below. Domain availability checking is handled with ajax, a live summary displays the total due for a product and recurring summary as options are selected, and the checkout page is laid out in 2 columns.

Modern

Modern

Supported Features

Headline: No
Tagline: No
Feature Highlights: Yes
Featured Products: No
Product Group Features: No
Number of Products: Unlimited
Compatible With: Six template/Bootstrap 3

A flexible cart that is designed to work for all types of products.

Slider

Slider

Supported Features

Headline: No
Tagline: No
Feature Highlights: Yes
Featured Products: No
Product Group Features: No
Number of Products: For best results between 2 and 12, supports unlimited space permitting.
Compatible With: Five template/Bootstrap 2

This template uses a slider bar for product selection. Country flags are displayed for currency selection, and feature highlight bubbles can be created to highlight the key differences between each package (see feature highlights described below). An ajax domain availability checker reduces page reloads, and an order summary is updated instantly as clients configure the products they order.

It is also possible to link to the slider and preselect a product on the slider bar using a link such as this: /cart.php?pid=xxx

Verticalsteps

Vertical Steps

Supported Features

Headline: No
Tagline: No
Feature Highlights: No
Featured Products: No
Product Group Features: No
Number of Products: Unlimited
Compatible With: Five template/Bootstrap 2

A flexible cart that is designed to work for all types of products. This cart is now deprecated and will no longer receive further updates.

Using Feature Highlights

Feature Highlights allow you to define features and their values for products in a way that WHMCS can interpret for comparison based display.

Feature Highlights are supported by most order form templates. See the above descriptions for exact details.

PremiumComparisonFeatureHighlights.png

Usage

Feature Highlights are specified as part of the product description. They must be entered in the following format, with one feature per line.

Feature: Value

For example, the description for a shared hosting product using Feature Highlights might look like this:

Disk Space: 1000MB
Bandwidth: 5GB
Email Accounts: 5
Subdomains: 3
Addon Domains: 1

The preview on the right shows how the above would be rendered in the Premium Comparison order form.

For best results we recommend that you use the same features and in the same order for all products within the same product group.

Disabling Feature Highlights

There may be occasions when it's required to disable feature highlights, such as when wishing to use other markup in the product description. To do this, simply edit the /templates/orderforms/*your active template*/products.tpl template file and perform these two edits:

  1. Replace {$product.featuresdesc} with {$product.description}
  2. Remove/comment out:
{foreach from=$product.features key=feature item=value}

<span class="prodfeature"><span class="feature">{$feature}</span><br />{$value}</span>
{/foreach}

Save changes and upload the modified template file. Now product descriptions will be displayed as entered.

Using Different Templates for Different Products

It is possible to specify the template you want to use for a product in the URL you use to link to the order form. And therefore by doing that you can use multiple different templates concurrently and thus use the one that best suits each product or type of product you offer.

Details on how to do this can be found in the article: Linking to WHMCS - Order Links