Option Dependencies ↑ Back to top
The Composite type allows you to make specific product/variation selections conditionally available based on compatibility limitations that may exist between products/variations in different Components.
This is possible using Scenarios, which can be understood by looking at a practical example. The Full Frame DSLR Kit composite product:
The kit consists of the following Components:
- Camera Body
- Memory Card
Without any Scenario definitions, it is possible to select and purchase any Camera, Lens and Memory Card combination, including potentially incompatible parts.
In this scenario, Cameras only work with Lenses of the same manufacturer. Additionally, each Camera works with a specific Memory Card type.
To ensure that only compatible products can be selected and purchased together, Scenarios can be used to define the valid combinations of Camera, Lens and Memory Card selections.
For simplicity, the Full Frame DSLR Kit used in this example includes only 2 Cameras, 6 Lenses and 2 Memory Cards. These relatively few options translate into 24 different configurations – out of these 24, only 6 are valid.
Fortunately, only 2 Scenarios are required to describe the valid Full Frame DSLR Kit configurations:
How Scenarios Work ↑ Back to top
Every time you make a new product/variation selection, the chosen options are used to create a list of matching Scenarios. Then, a series of actions associated with these matching Scenarios is triggered. Matching conditions for a Scenario are defined under the Scenario Configuration section, while the associated action is defined by ticking an option in the Scenario Actions section.
The Create Dependency Group action uses the products/variations included in the Scenario to define a valid combination set. Products/variations that are not found in any matching Scenario are disabled and cannot be chosen.
This is easier to understand by looking at the Full Frame DSLR Kit example. After having chosen the Canon DSLR camera in the first step, it is not possible to choose the Nikon lens in the next step:
The same can be observed with the Memory Card options:
Scenarios Configuration ↑ Back to top
To create a Scenario:
- Go to Product Data > Scenarios.
- Click Add Scenario.
- Assign a Name and – optionally – a Description to the created Scenario.
- Define matching conditions in the Scenario Configuration section by including or excluding product/variation selections. Choose selection is or selection is not in the drop-down associated with each Component to include or exclude the specified products/variations. To add all products and variations without selecting them one by one, choose Any Product or Variation.
- Tick an action associated with the created Scenario: Create Dependency Group or Hide Components.
In the Full Frame DSLR Kit example, No Selection has been included in the Memory Card Component in both Scenarios. This allows customers to skip the (optional) Memory Card Component without choosing an option.
When creating Scenarios to introduce option dependencies:
- The Create Dependency Group action must be enabled to define a valid combination set.
- The defined Scenarios must include all valid combination sets.
As the count of Components, Component Options, or dependencies increases, the process of splitting up product/variation selections into valid combination sets can become quite tedious. To make things easier, the extension allows you to focus on fewer Components and fewer dependency relationships at a time, by allowing you to mask Components when defining Scenario matching conditions.
Consider a Composite Product with the following simple structure:
|Component Name||Component Options|
|Component 1||Products X & Y|
|Component 2||Products A, B & C|
|Component 3||Products K & L|
The following dependencies exist:
- X is compatible with A and B.
- Y is compatible with B and C.
- A is compatible with K only.
- B is compatible with L only.
Without Component Masking
Without the ability to mask Components, the easiest way to create these dependencies with Scenarios is to:
- Make a list of all selection combinations: [ 2 selections in Component 1 ] x [ 3 selections in Component 2 ] x [ 2 selections in Component 3 ] = 12.
- Go through each combination of products and determine whether it’s a valid one. If so, create a new Scenario and use the combination as a matching condition.
- Tick the Create Dependency Group action.
The result — 5 valid combinations and an equal number of Scenarios: X-A-K, X-B-L, Y-B-L, Y-C-K and Y-C-L.
Note that it is possible to reduce these Scenarios to the following 3: X-A-K, XY-B-L, and Y-C-KL.
With Component Masking
Component masking makes it possible to transform the dependencies into Scenarios in a more direct manner: X-AB-masked, Y-BC-masked, masked-A-K and masked-B-L.
Conditional Components ↑ Back to top
In addition to creating option dependencies, Scenarios can be used to conditionally disable and hide individual Components based on product/variation selections.
This allows you to create multiple configuration paths by introducing or removing Components as product/variation selections are being made.
To conditionally disable a Component, follow these steps:
- Go to Product Data > Scenarios.
- Click Add Scenario.
- Assign a Name and/or Description to the created Scenario.
- Define selection matching conditions in the Scenario Configuration section by including or excluding products/variations. Choose selection is or selection is not in the drop-down associated with each Component to include or exclude the specified products/variations. To add all products and variations without selecting them one by one, choose Any Product or Variation.
- Tick the Hide Components action.
- Choose one or more Components to disable.
Selecting Multiple Component Options ↑ Back to top
Out of the box, it is only possible to select one option under each Component.
However, by using Product Bundles in combination with Composite Products, multiple products can be chosen under a single Component.
The concept is easier to understand with an example based on the Full Frame DSLR Kit. Our objective is to offer the following optional products in an additional Accessories Component:
- Neoprene Cover
- Dust-Aid Sensor Cleaner
Customers will be able to choose any combination of accessories, without being limited to a single selection.
The Accessories component can be created by following these steps:
- Using the Product Bundles extension, create a new product bundle and add the products that you want to appear in the Accessories Component inside this bundle, ensuring they are all Optional. Then, set its Catalog visibility status to Hidden. For guidance, refer to the Product Bundles documentation.
- Create the Accessories Component and add this newly created bundle as its only Component Option.
- In the Advanced Settings section of the Accessories Component, locate the Selected Option group and check the Hide Title and Hide Thumbnail options.