Rules

The rule system pervades Shopware 6. It solves the problem of calculating the cart differently based on the context (SalesChannel, CustomerGroup, ...) and the current state (LineItems, Amount, ...), but user controlled and decoupled from the cart itself. In theory every part of Shopware 6 can contribute to the set of available rules.

Scenario

The problem solved by the rule system can be imagined by the following scenario:

If a customer orders a car, a pair of sunglasses in the same order will be free.

This carelessly uttered sentence relies on the knowledge of multiple different data points:

  • A product called car

  • A product called sunglasses

Both are independent, separately buyable and stored to the database.

  • The whole state of a single cart

  • The quantity of a line item

This is a runtime concept - in memory, resulting in the adjustment of a single line items price, which in turn changes the whole calculation of the cart.

In this example the rule system sits right in the middle of the scenario, providing the necessary mapping information to get from point a (car is in the cart) to point b (sunglasses are free).

Rule Design

The center of the rule system is the Rule, it is realized as a variant of the Specification pattern, but omits the name due to a few key differences.

  • Storable and retrievable and identifiable through the Data Abstraction Layer.

  • A RuleScope parameter instead of any arbitrary object

  • match instead of isSatisfiedBy

As well as a Specification class, a Rule class represents a condition to fulfill. It implements the match(RuleScope $scope) function to validate user defined values against a runtime state. See the following object diagram for a better understanding:

Which will result in the following call order:

As you can see a single rule can either contain user defined values or other, user defined, rules. These are Container rules. The rule system here bears some resemblance to the SearchCriteria, although independent. Where a criteria is the representation of a query that gets translated and executed through the storage engine, the rule matches in memory in PHP.

The last building block then is the Rule Scope. The Scope contains the current runtime state of the application and is necessary to match the data. The whole picture is visualized in the next diagram:

Connection to the System

Following Shopware 6s data driven approach the rule objects are stored to the database and used to trigger behaviour in the cart through the associations present.

For more insights on the rule validation take a look at the cart documentation: