MMv4 KB
 
Event Engine Editor
  Last Edited - 05/8/2014 1:09pm PDT
  Category Path - Shopping Cart Software Components > Administration Area > Modules > Event Engine
 
The Event Engine is the tool to create store discounts, promotions, sale prices, bonus products, product bundles, and much more.

The Event Engine Editor is used to create and edit events for the store.
 
To create a new Event:
  1. Go to [Admin > Event Engine Module > Search Events > + ].
  2. Populate the various sections of the event editor.  They are all explained in detail below.
  3. Click Save Changes to this Event when done.
 
To edit an existing Event:
  1. Go to [Admin > Event Engine Module > Search Events >].
  2. Click either the SID number or the icon associated with the event.
  3. Make the desired changes to the event.
  4. Click Save Changes to the event when finished.
 
Order of Operations

Processing Order
Events are processed by the shopping cart according to the processing order.  The lower the number, the higher the priority.

When this Event is triggered
Use this option to specify what the store will do in respect to other events, once this event is triggered.  The options are to Continue processing Events, Stop processing more Events, and Ignore the following Events.  This is a useful tool to prevent customers from taking advantage of multiple events simultaneously.

tip
Events are processed according to the assigned processing order. If multiple events have the same processing order, then they are processed according to SID number. Smaller numbers are processed first.

If Stop processing more Events is selected, then after that Event is processed, any events with a larger processing order number will not be processed. And any Events with the same processing order number but a larger Event SID number will also not be processed.

 
General Information

SID (System ID)
The SID (System ID) is a unique number that identifies the event to the system.  This number is set by the software and cannot be changed.

Event Type
Select whether the event is an Automated Event or a Coupon Code.  Coupon codes are inputted by customers during the checkout process.

Event Name
Input a name for the event.  The name can be displayed to customers in the storefront. 

Description
Optionally describe the event.  The description can be displayed to customers in the storefront.

Start Date
Select a date to start the event.  The dropdown menu will default at the current date automatically.  The event will be valid beginning at 12:00 am on the specified date.

End Date
Either select Never Expires, or select Expires On... and input the expiration date.  The event will be valid through 11:59 pm on the specified date.

Active
An active event will be live and processed in the store.  Inactive events will not be processed.

Public
If selected, customers may be able to view information about the event in the storefront.

Redeem Limit
The Redeem Limit specifies how many times, in total, the Event may be used.

example of redeem limit
For example, if an event has a Redeem Limit of 10, then just the first ten orders that meet the event's criteria will trigger the event. After the event has been applied to ten orders, no more customers will be able have it applied to their orders.

Reusable
The Reusable option specifies whether or not an event may be applied to more than one order placed by the same customer.

example of reusability
For example, if an event is set to be reusable, then the customer Dudley Heromin will be able to have the event applied to an order he places on Monday, and again to an order he places on Tuesday. If the event is not reusable, then it would be applied only to the order he places on Monday.

Retain Balance
If this event is a coupon code, this setting is used to allow customers to retain the balance of any leftover amount when the coupon code's value is more than the grand total of the basket.

How to apply the Triggers below
This option is used to select whether the event requires all triggers to be matched, any triggers to be matched, or none at all.  If none is selected, the event will be processed automatically unless it is a coupon code.  In that case, the customer must input it during checkout.

 
Add a Trigger to this Event

Trigger Type
There are several types of event triggers available:

affiliate
This option can be used to trigger specific behavior if a customer has a specific affiliate tracking ID present on their computer.  This is useful option if you'd like to create special pricing for specific affiliates.

basket
This is used to trigger specific behavior if the customer's basket's subtotal or grand total meets the specified criteria.

category
Used to trigger specific behavior if a customer's basket, subscription, or order history contains or does not contain products belonging to the specified category.

customer
Used to trigger behaviors if the customer belongs or does not belong to a specified customer group.

product
Used to trigger specific behavior if a customer's basket, subscription, or order history contains or does not contain specified products.

vendor
Used to trigger specific behavior if a customer's basket, subscription, or order history contains or does not contain products belonging to the specified vendor.

 
Add a result to this Event

Result Type
There are several types of event results available:

product added to basket
Use this result to automatically add a product to the customer's basket.  It can also be used to modify the price of that product.

product pricing
Used to increase or decrease the price of a specified product.

order pricing
Used to increase or decrease the price of an order.

shipping modification
Used to increase or decrease the price of shipping methods in the store. 

tax modification
Used to increase or decrease the price of tax methods in the store. 

coupon code
This feature will generate a coupon code for the value specified.

email series
This will automatically subscribe the customer to a Modular Mailer email series.

 
Event Notes

Notes
Notes are hidden and displayed to store administrators only.

Powered by ModularKB