[5.7] Added ContainsPurchasablesConditionRule

[lukeholder]

Description

Adds a new Contains Purchasables order condition rule with three match modes:

• Any – order contains at least one of the selected purchasables
• All – order contains all of the selected purchasables (may contain others)
• Only – order contains exactly the selected purchasables and nothing else

hasPurchasables vs containsPurchasables

The existing hasPurchasables query param is unchanged. It accepts a single purchasable or a flat array of purchasables/IDs and always uses "any" matching — i.e. the order must contain at least one of them.

Order::find()->hasPurchasables([$variantA, $variantB])->all();
// returns orders that contain variantA OR variantB

The new containsPurchasables param accepts an array shape with a purchasables key (mixed IDs and/or objects) and a match key (ContainsPurchasablesMatch enum). All three modes are handled with correct SQL:

Mode	SQL	Meaning
any	Single EXISTS with IN (...)	Order contains at least one of the purchasables
all	One EXISTS per ID, AND-joined	Order contains every one of the purchasables (may contain others)
only	AND-joined EXISTS per ID + NOT EXISTS for any others	Order contains exactly these purchasables and nothing else

use craft\commerce\enums\ContainsPurchasablesMatch;

// any
Order::find()->containsPurchasables(['purchasables' => [1, 2, 3], 'match' => ContainsPurchasablesMatch::Any])->all();

// all
Order::find()->containsPurchasables(['purchasables' => [1, 2, 3], 'match' => ContainsPurchasablesMatch::All])->all();

// only
Order::find()->containsPurchasables(['purchasables' => [1, 2, 3], 'match' => ContainsPurchasablesMatch::Only])->all();

Twig examples

{# Orders containing at least one of the given purchasables #}
{% set orders = craft.orders()
  .containsPurchasables({ purchasables: [1, 2, 3], match: 'any' })
  .all() %}

{# Orders containing all of the given purchasables (may contain others) #}
{% set orders = craft.orders()
  .containsPurchasables({ purchasables: [1, 2, 3], match: 'all' })
  .all() %}

{# Orders containing exactly the given purchasables and nothing else #}
{% set orders = craft.orders()
  .containsPurchasables({ purchasables: [1, 2, 3], match: 'only' })
  .all() %}

New classes and methods

• Added craft\commerce\elements\conditions\orders\ContainsPurchasablesConditionRule.

• Added craft\commerce\enums\ContainsPurchasablesMatch.

• Added craft\commerce\elements\db\OrderQuery::$containsPurchasables.

• Added craft\commerce\elements\db\OrderQuery::containsPurchasables().

• Added craft\commerce\elements\Order::hasPurchasables().

• Needs translations

Fixes #4242