Order Form Templates

What Is An Order Form Template?

Order Form Templates look closely into the way of products and the shopping cart appearance when customers make purchases.

  • You can check the link below for more information about Order Form Templates here.
  • You may want to refer to the list of WHASOLS-shipped Order Form Templates.

    To customise other aspects of the WHASOLS Client Area, we recommend creating a Child Theme.

The system default Order Form Template can be set at Configuration > General Settings in the Ordering tab. This is the place where errors will display if there’s any compatibility issue between the current System Theme and the default Order Form Template.

Order Form Template Dependencies

An inheritance system allows parent-child relationships, with parents providing assets to children. Many custom Order Form Templates will require only one or more assets in order to function. These areas are noted in the dependencies list in the child’s theme.php file, and then are fulfilled by the items in the provides list in the parent’s theme.php file.

For more about the theme.php file and how to use it to declare and fulfill dependencies, see The Theme Configuration File.

Creating An Order Form Template

A custom copy of all of the template files are not required only if using parent-child relationships. Only copy, create the files you want to customise, and the remaining Order Form Templates will load then from the parent when you define them. It will assure your customised Order Form Template easier to maintain. When a new version of WHMSols upgraded , the system updates any changes to Order Form Template files that aren’t customised.

To create an Order Form Template:

1. Create an Order Form Template Folder

First, create a new folder in the /templates/hostim/orderforms/ directory. The new directory needs a name. For example, mycart.

Names should only contain lowercase letters, numbers, hyphens, and underscores. They cannot include spaces.

2. Create a theme.php File

In the new folder, create a theme.php file and populate it with information, making sure to specify a parent. At minimum, your theme.php file must include these lines:

config:
  parent: standard_cart

For more about the theme.php file and its contents, see The Theme Configuration File.

3. Customize Files

Copy the files that you want to customise from the parent Order Form Template. For example, the Standard Cart Order Form Template is the parent for the Premium Comparison Order Form Template. Premium Comparison consists only of a products.tpl Order Form Template file. Standard Cart is used for all of the other steps of the order process.

For a current list of Order Form Template files, see Order Form Templates.

Testing Order Form Templates

WHMSols allows you for rechecking or to preview Order Form Templates before making them live. This is done using the Products/Services Groups Order Template Selection URL parameter.

Activating Order Form TemplatesActivating Order Form Templates

You can set the Order Form Template for specific product groups at Configuration > Products/Services.