Page History

Step-by-step guide 

1. Create a Checkout Message

1. In the CMS,

1. go to Settings → Checkout Messages. 
   
   
2. Click New.
   

1. In Message, enter the message to be displayed to the user. 
   
   
2. Use Sort Code/Mask

1.  to define a product category: 
   1. enter the sort code for one category of products, 
   2. enter '%' for ALL products in all categories,
   3. wildcards for multiple categories, i.e., 'SX123%', or 
   4. leave blank if using an 'Override Query'.
      

1. For Is Plain Text?

1. :

1. 1. Tick for the message to be displayed in plain text with no applied formatting.
      An example is the default message:
      Image Added
      
      

   2. Untick for the message formatting to be rendered by any HTML.  Some HTML element properties will be guided by your site style (accessible in the CMS: Style Guides → Static Content.) Formatting allows content to visually stand out more and be customised to suit purpose.   
      
      

      Info
      title Adding HTML formatting
      Imagine how you want the message to look. You may want some parts to stand out more than others. Or for a certain sentence to appear bigger than others. Or you want to add some white space between certain sections of the message.   Expand title Click here for a basic guide to formatting the message... Adding HTML tags An HTML tag is a special word or letters surrounded by angle brackets, < and >. To format a chunk of text, in most cases, you will be placing it between opening and closing tags. The tags with the included text is called an HTML element. For example, if we add a word 'IMPORTANT' to the default checkout message and want to bold it, we can make it a bold element by putting it in between the bold opening tag <b> and closing tag </b>. A closing tag has a forward slash '/' before the special word/letter and the closing angle bracket. The whole bold element will look like this: <b>IMPORTANT</b>.   Image Added              A few elements don't need opening and closing tags. The most useful is <br />, which puts a line break where it appears. Suppose we want to add a line break after 'Here's a sample message.' Image Added Nesting elements You can keep one HTML element inside another HTML element. Image Added List of useful HTML elements There are many more HTML elements you can use but here are some basic ones. Play around with formatting options to achieve the look you want.  Function HTML tag Example Headings <h1></h1> <h2></h2> <h3></h3> Note - The further down you go with the headings, the smaller they become. The lowest is <h6>. However, your site's style may not have all heading elements defined. Image Added Paragraph <p></p> Creates paragraph elements in your message. Provides white space between elements for easier reading. Image Added                 Line break <br /> Adds a line break to  Image Added Lists List type: <ul></ul> - Unordered list (no special order or sequence for items in list. Default:  listed items to start with a bullet point.  <ol></ol> - Ordered list. Default: listed items are numbered.  Note - Define the List type, then each list item is contained within <li></li> tags. Example: <ol> <li>List item 1</li> <li>List item 2</li> </ol> Image Added                Typeface for emphasis <b>bold</b> or <strong></strong> <i>italics</i> or <em></em> <u>underline</u> Image Added

      
      
      

      
      

      
      

2. For Requires User Confirmation:
   1. Tick to display a checkbox that the user must tick before being allowed to continue
      
   2. Untick for the message to display without confirmation from the user
      
      

3. Enter an 'Override Query' if required. NOTE - This field works together with Sort Code/Mask. See Defining the criteria for checkout messages below. 

   Info
   An override query is used to define alternative criteria to be met before the message is displayed to the user.

1. The following tables can be used: ProntoSalesOrder ProntoSalesOrderLine Customer Product An example would be: product.conditioncode = 'T' See more examples below.

   
   

2. For Applies

1. to Mode, set whether the message

1. applies to B2B

1. , B2C

1. or both user roles.
   

1. (For classic sites only. Leave blank for BPD sites.) For the Top Template (displayed below the message), select the required template, if applicable.
   
   
2. (For Pronto only.) For Field Group Name, select the fieldgroup that is defined on the prontosalesorder table to be displayed along with the message. 
   

1. (For classic sites only. Leave blank for BPD sites.) For the Bottom Template (displayed below the message), select the required template, if applicable.
   
   

2. To save these changes, click OK.

Defining the criteria for displaying checkout messages 

2. Enable Checkout Message

Displaying the Checkout Message is enabled by adding the Checkout Messages widget in the relevant template, e.g., Cart. Further display options are also available in the widget. See the help page for the Checkout Messages widget. 

Additional Information

Related help