Rules - Triggers Overview
Main Trigger Types
The Mimeeq 3D configurator uses a versatile triggering system to control when actions are executed. There are six primary trigger types available:
Make sure you have read Understanding Triggers and Actions Rules in Mimeeq to understand the principles of the triggers and actions.
Trigger Type | Description | Use Case |
|---|---|---|
Always Active | Action is always active regardless of user interaction | Apply zoom all on every change |
Event (See Sub Event Options below) | Action is triggered by specific events in the configurator | See Event Table below |
Filter | Action is triggered based on filter conditions | Example if the material filter attribute is X or Y for example trigger when the fabric type is wool |
Option sets | Action is triggered when specific option sets change | When Option Set "Leather" is selected you cannot have Extra thick foam |
Options | Action is triggered when individual options change | When Size is selected hide non-compatible options, example when size is 1800mm select metal thickness Heavy duty |
Whole block | Action is triggered when changes occur to an entire block | Works much like the above options sets but based on all the sets/options in that block |
Event-Based Trigger Subtypes
When using the Event trigger type, you can select from the following specific events:
Event Type | Description | Use Case |
|---|---|---|
Click Hotspot | Triggered when user clicks on 3D hotspots | Click the hotspot and move to customer camera position or play an animation |
Click Mesh Group | Triggered when user clicks on a mesh group | Click a specific mesh like a leg and open the options panel group that contains the leg options, you could also click a drawer front to play an animation to open it |
Close Hotspot | Triggered when 3D information panel is closed | Move the camera back to the default position |
Configurator loaded | Triggered when the configurator finishes loading | This is required as a trigger for event based on load actions for example when the configurator is loaded open a specific group on the side panel |
Group open | Triggered when an option group is opened | Most commonly used to set a specific camera angle to zoom in on that element you will then customise |
Group close | Triggered when an option group is closed | Most commonly used to reset specific camera angle to zoom in on that element you will then customise |
Quantity Change | Triggered when any quantity value changes |
|
Quantity Decreased | Triggered specifically when a quantity is decreased |
|
Quantity Increased | Triggered specifically when a quantity is increased |
|
Widget open | Triggered when a widget is opened | Works on the following Widgets: Collapsed Filter Widget, Print on Demand Widget, Color picker Widget, Image Widget Colour Picker, Works in a similar way to the groups as these widgets take over the option panel, commonly used for custom camera positions |
Widget Closed | Triggered when a widget is closed | As Above |
Trigger Inclusion Types
For non-event based triggers (Option sets, Options, Filter, Whole block), you can specify an inclusion logic that determines exactly when the trigger activates:
Inclusion Type | Description |
|---|---|
Is one of | Action triggers only when the selected value matches one from your specified list |
Is not one of | Action triggers when the selected value is anything except those in your specified list |
Example: If you select "Leg finishes" as your trigger option set and choose "Black" with the "Is not one of" inclusion type, the action will trigger whenever the user selects any leg finish except Black.
This powerful logic allows for:
- Creating exceptions to rules
- Setting up default behaviors with specific overrides
- Creating complex conditional logic without needing to list every possible option
OR and AND Conditions
The Mimeeq configurator allows you to create complex trigger conditions using OR and AND logic:
OR Conditions
You can select multiple option blocks to create OR conditions. For example:
- Trigger when "Leg Finish is Metal" OR "Leg Finish is Wood"
- This activates the action if either condition is true
AND Conditions
You can combine different option blocks to create AND conditions. For example:
- Trigger when "Leg Finish is Metal" AND "Seat Shape is Round"
- The action only triggers when both conditions are true simultaneously
Limitations and Usage
- You can only have one level of OR and AND conditions (no nested conditions)
- You can combine multiple OR and AND conditions together to precisely control when triggers activate
- This allows for creating sophisticated rules like "trigger only when the furniture has metal legs AND a round seat, OR when it has wooden legs AND a square seat"
Using these conditional operators strategically helps limit the scope of triggers and create more specific, targeted interactions based on combinations of user selections.
Combining Triggers with Actions
The power of the Mimeeq configurator comes from combining these triggers with specific actions. Different actions are compatible with different trigger types, as indicated in the Actions Overview.
By carefully designing your trigger and action combinations, you can create sophisticated interactive experiences that respond intelligently to user interactions and configuration changes.
Updated on: 13/04/2025
Thank you!