Revision as of 02:27, 19 May 2011

WHMCS comes with many built in templates as standard. More information on these can be found @ Standard Order Form Templates

However, you can also customise and create your own cart templates. Cart templates are stored in the directory /templates/orderforms/ and an explanation of the purpose of each template file is provided below:

• products.tpl - Lists product categories and products
• adddomain.tpl - First step for domain registration only orders
• addons.tpl - Lists the addons a user can order for their existing packages when logged in
• domainrenewals.tpl - Lists domains in the clients account and allows for renewals to be ordered in advance
• configureproductdomain.tpl - Domain selection for domains attached to a product
• domainoptions.tpl - Used by some templates to display domain availability check results
• configproduct.tpl - Configure the product before adding to the cart eg. billing cycle, configurable options, custom fields
• configuredomains.tpl - Choose domain addons, complete custom field requirements & custom nameservers
• ordersummary.tpl - Used to display cart contents and product total summaries during order process
• viewcart.tpl - Showing cart contents & checkout process
• login.tpl - Used for login for existing users
• complete.tpl - This page is showed at the end of the checkout process

Third Party Order Conversion/Affiliate Tracking

If you use a third party order conversion tracking system or affiliate system then you may need to insert a code snippet that gets run when a user completes an order. With WHMCS, you would add this to the complete.tpl template file between the ispaid section of code as shown below:

{if $ispaid}
Enter any HTML code which needs to be displayed once a user has
completed the checkout  of their order here - for example
conversion tracking and affiliate tracking scripts
{/if}

You can use variables including {$orderid} {$ordernumber} and {$amount} where necessary to fill in order details.

Remove Fields From Order Form

If you do not want to show one of the default fields on your order form, you can change the field type to hidden and supply a default value of NA. The following example shows to to hide the Address 2 field from the viewcart.tpl page:

Find:

<input type="text" name="address2" style="width:80%;" value="{$clientsdetails.address2}" />

Replace with:

<input type="hidden" name="address2" style="width:80%;" value="NA" />