Product modifiers allow users to customize items during an order. Modifiers are defined through the Recipe Builder, and their behavior depends on the configuration of ingredient categories, individual ingredient properties, and recipe settings.
Understanding Modifiers
Recipe Sizes
The size options (e.g., Latte Small, Latte Medium, Latte Large) represent different recipes for the same product. Each size can have unique pricing and ingredient configurations.
Ingredient Categories
Modifiers are grouped into categories, such as Milks, Ingredients, and Syrup. The categories settings define how ingredients behave during the customization process:
- Milks: A mutually exclusive category. If one ingredient (e.g., Almond Milk) is selected, other ingredients in the same category (e.g., Semi-Skimmed Milk) are reset to 0.
- Syrup: Allows optional additions (e.g., Caramel Syrup or Hazelnut Syrup) up to their maximum quantity.
Ingredient Types
Ingredients within categories can be configured with specific rules that dictate their behavior:
- Fixed Ingredients: Cannot be modified. For example, Coffee Grounds always remains at a set quantity (1 in this case).
- Optional Ingredients: Can be set to 0 or adjusted up to a maximum quantity defined on the ingredient.
- Additional Ingredients: Cannot be reduced below the base quantity but can be increased up to the maximum. For example, if a base quantity is 1, it cannot be decreased, but additional quantities can be added.
Configuring Ingredient Categories
Ingredient categories are created and managed on the Recipe Builder page. The category configuration determines how ingredients behave during product customization:
- Create the ingredient categories on the Recipe Dashboard.
- Assign ingredients to their appropriate categories.
- Configure each ingredient on the Recipe:
- Type: Fixed, Optional, or Additional.
- Quantity: The quantity of ingredient used in the recipe, e.g. 50ml, 20mg 1 unit
- Maximum Quantity: The upper limit that can be selected.
- Mutual Exclusivity: Enable if only one ingredient can be selected per category.
Using Product Modifiers
How Modifiers Work
- Select a Recipe Size: Choose a recipe size (e.g., Latte Small, Latte Medium, Latte Large) to display the modifiers and ingredient options.
- Add/Remove Ingredients:
- Adjust the quantity of optional or additional ingredients by clicking the + or − buttons.
- Fixed ingredients cannot be modified.
- Mutual exclusivity ensures that selecting one ingredient will reset other ingredients in the same category.
Example Scenarios
- Alternative Milks:
- Selecting Almond Milk sets its quantity to 1 and resets Semi-Skimmed Milk to 0.
- Optional Syrups:
- Add Caramel Syrup and Hazelnut Syrup as desired, up to the maximum set quantity.
- Fixed Coffee Grounds:
- This ingredient is pre-set to 1 and cannot be adjusted.
Best Practices for Customisation
- Set Realistic Maximum Quantities: Ensure maximum quantities align with product recipes to avoid over-customization that impacts the product quality.
- Test Mutually Exclusive Categories: Verify that mutual exclusivity resets ingredient quantities correctly during customization.
By configuring and using product modifiers effectively, you can provide a flexible and user-friendly customization experience while maintaining control over product configurations and inventory management.