Versions Compared

Old Version 16

changes.mady.by.user Documenter

Saved on

compared with

New Version 17

changes.mady.by.user Documenter

Saved on

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

  1. In the CMS, navigate to Settings → Checkout Messages. 

  2. Click New.

  3. In Message, enter the message to be displayed to the user. 
  4. Use Sort Code/Mask 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'.

  5. For Is Plain Text?:
    1. Tick for the message to be displayed in plain text with no applied formatting.
    2. Untick for the message to be displayed by HTML formatting and site styles, etc.  

  6. 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

  7. 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.

    The following tables can be used:
    ProntoSalesOrder
    ProntoSalesOrderLine
    Customer
    Product

    An example would be:

    product.conditioncode = 'T'


    See more examples below. 


  8. For Applies to Mode, set whether the message applies to B2B, B2C or both user roles.

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

  10. (For Pronto only.) For Field Group Name, select the fieldgroup that is defined on the prontosalesorder table to be displayed along with the message. 

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

  12. To save these changes, click OK.

Anchor
Criteria
Criteria

Defining the criteria for displaying checkout messages 

Info

When setting up a checkout message, the 'Sort Code/Mask' and 'Override Query' fields are used to define the criteria for whether or not a checkout message is displayed to the user. The following values will provide an example of how to display a checkout message for various scenarios.

...

Tip
titleCheckout Message Examples

You might find these scenarios helpful when creating your own Checkout Messages.

When a Product in a specific Category is in the Cart:
  • 'Sort Code/Mask': Enter the Category code. i.e. SX123456
  • 'Override Query': Leave blank.

When a Product under a higher level Category is in the Cart:
  • 'Sort Code/Mask': Enter the Parent Category code and add a percentage sign to indicate any categories under that tree. i.e. SX12%
  • 'Override Query': Leave blank.

For a specific Customer:
  • 'Sort Code/Mask': Leave blank.

  • 'Override Query': Enter the following query and substitute ABC123 for the customer code.

    Code Block
    sql
    sql
    Code = 'ABC123'


When a specific Product is in the Cart:
  • 'Sort Code/Mask': Leave blank.

  • 'Override Query': Enter the following query and substitute AB-12345 for the product code.

    Code Block
    sql
    sql
    productcode = 'AB-12345'


When one (or more) of several Product is in the Cart:

 

  • 'Sort Code/Mask': Leave blank.

  • 'Override Query': Enter the following query and substitute 'CV120','CV200','CV250' with your own product codes (comma-separated)

    Code Block
    productcode in ('CV120','CV200','CV250') 



When the Cart Amount is greater than $200.00 Ex Tax:
  • 'Sort Code/Mask': Leave blank.

  • 'Override Query': Enter the following query.

    Code Block
    sql
    sql
    (soOrderTotalAmount-SoOrderTotalTax) > 200

...



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. 

...