QC: {IF-TRIGGERED-EVENTS-BEGIN}

QuickCode Tag Glossary Home

See also:

Knowledge Base

Articles in this category:
{EVENT-BLOCK-BEGIN}

{EVENT-BLOCK-END}

{IF-TRIGGERED-EVENTS-BEGIN}

{IF-TRIGGERED-EVENTS-END}

{NUMBER-OF-TRIGGERED-EVENTS}

{TRIGGERED-EVENT-BLOCK-BEGIN}

{TRIGGERED-EVENT-BLOCK-END}

Events > {IF-TRIGGERED-EVENTS-BEGIN}

<< {EVENT-BLOCK-END}

{IF-TRIGGERED-EVENTS-END} >>

{IF-TRIGGERED-EVENTS-BEGIN}

Updated: 07/8/2013

The {IF-TRIGGERED-EVENTS-BEGIN} QuickCode Tag may be used with the {IF-TRIGGERED-EVENTS-END} QuickCode Tag to create a block of content that will only be shown if at least one public event has been triggered by the current order.

Events are created using the Event Editor, and may be configured with a wide range of trigger types. In order for an event to be displayed in the storefront, its Public option must be set to YES. If the Public option is set to NO, the event may still be triggered and redeemed, but information about the event will not be displayed in the storefront.

For instance, it would be possible to create an event with a "product" trigger such as:

When 2 or more unit(s) of product SID 123 are in the customer's basket

If the current order includes three units of product SID 123, the event would be triggered. If the event's Public option is set to YES, then triggering the event would also cause any content between {IF-TRIGGERED-EVENTS-BEGIN} and {IF-TRIGGERED-EVENTS-END} to be shown.

If the customer removes two units of product SID 123 from the basket, leaving only one unit in the current order, the event would no longer be triggered, and any content between {IF-TRIGGERED-EVENTS-BEGIN} and {IF-TRIGGERED-EVENTS-END} would be hidden.

Requirements / Prerequisites

The {IF-TRIGGERED-EVENTS-BEGIN} QuickCode Tag must be used in combination with the {IF-TRIGGERED-EVENTS-END} QuickCode Tag. The {ELSE} QuickCode Tag may optionally be inserted between {IF-TRIGGERED-EVENTS-BEGIN} and {IF-TRIGGERED-EVENTS-END}.

{IF-TRIGGERED-EVENTS-BEGIN} and {IF-TRIGGERED-EVENTS-END} are compatible with any storefront template.

Content between {IF-TRIGGERED-EVENTS-BEGIN} and {IF-TRIGGERED-EVENTS-END} will be shown only if at least one public event is currently triggered.

If {ELSE} is inserted between {IF-TRIGGERED-EVENTS-BEGIN} and {IF-TRIGGERED-EVENTS-END}, then content between {IF-TRIGGERED-EVENTS-BEGIN} and {ELSE} will be shown if at least one public event is triggered. Any alternate content between {ELSE} and {IF-TRIGGERED-EVENTS-END} will be shown if no public events are triggered.

Example of Use

1. Create an event with the following settings:

Example
Event Type Coupon Code When the customer enters the coupon code 10PERCENT
Event Name Discount Code
Public YES
Active YES
How to apply the Triggers below This event doesn't use triggers. (It's either ALWAYS applied, or uses a coupon code with no additional requirements.)

2. Create a second event with the following settings:

Example
Event Type Automated Event
Event Name Summer Sale
Public YES
Active YES
How to apply the Triggers below This event doesn't use triggers. (It's either ALWAYS applied, or uses a coupon code with no additional requirements.)

3. Create a third event with the following settings:

Example
Event Type Automated Event
Event Name Free Shipping
Public YES
Active YES
How to apply the Triggers below Match ALL the triggers below.
Trigger Type basket
Trigger Details The basket subtotal is greater than $49.99

4. Add the following code to a storefront template:

Example
{IF-TRIGGERED-EVENTS-BEGIN}
Specials Applied To This Order: {NUMBER-OF-TRIGGERED-EVENTS}
{TRIGGERED-EVENT-BLOCK-BEGIN}
{EVENT-NAME}{IF-COUPON-BEGIN} (Coupon code: {COUPON-CODE}){IF-COUPON-END}
{TRIGGERED-EVENT-BLOCK-END}
{IF-TRIGGERED-EVENTS-END}

5. When the corresponding storefront page is viewed by a customer who has not yet added any products to the basket, and has not yet applied the coupon code, only the second event would be triggered, and so the following would display:

Example
Specials Applied To This Order: 1
Summer Sale

6. If the customer adds at least $50 worth of products to the basket, the third event would be triggered in addition to the second event, and so the following would display:

Example
Specials Applied To This Order: 2
Summer Sale
Free Shipping

7. If the customer applies the coupon code 10PERCENT to the order, the first event would be triggered in addition to the second and third events, and so the following would display:

Example
Specials Applied To This Order: 3
Discount Code 10PERCENT
Summer Sale
Free Shipping

Source Code

Source Code Updated:

When a web page using a template that contains this QuickCode Tag is viewed in the storefront, the {IF-TRIGGERED-EVENTS-BEGIN} QuickCode Tag is changed into the source code below prior to the web page being displayed.