class OrderItemMatcher in Commerce Core 8.2

Default implementation of the order item matcher.

Hierarchy

• class \Drupal\commerce_cart\OrderItemMatcher implements OrderItemMatcherInterface

1 string reference to 'OrderItemMatcher'

commerce_cart.services.yml in modules/cart/commerce_cart.services.yml

modules/cart/commerce_cart.services.yml

1 service uses OrderItemMatcher

commerce_cart.order_item_matcher in modules/cart/commerce_cart.services.yml

Drupal\commerce_cart\OrderItemMatcher

File

modules/cart/src/OrderItemMatcher.php, line 14

Namespace

Drupal\commerce_cart

class OrderItemMatcher implements OrderItemMatcherInterface {

  /**
   * The entity type manager.
   *
   * @var \Drupal\Core\Entity\EntityTypeManagerInterface
   */
  protected $entityTypeManager;

  /**
   * The event dispatcher.
   *
   * @var \Symfony\Component\EventDispatcher\EventDispatcherInterface
   */
  protected $eventDispatcher;

  /**
   * Constructs a new OrderItemMatcher object.
   *
   * @param \Drupal\Core\Entity\EntityTypeManagerInterface $entity_type_manager
   *   The entity type manager.
   * @param \Symfony\Component\EventDispatcher\EventDispatcherInterface $event_dispatcher
   *   The event dispatcher.
   */
  public function __construct(EntityTypeManagerInterface $entity_type_manager, EventDispatcherInterface $event_dispatcher) {
    $this->entityTypeManager = $entity_type_manager;
    $this->eventDispatcher = $event_dispatcher;
  }

  /**
   * {@inheritdoc}
   */
  public function match(OrderItemInterface $order_item, array $order_items) {
    $order_items = $this
      ->matchAll($order_item, $order_items);
    return count($order_items) ? $order_items[0] : NULL;
  }

  /**
   * {@inheritdoc}
   */
  public function matchAll(OrderItemInterface $order_item, array $order_items) {
    $purchased_entity = $order_item
      ->getPurchasedEntity();
    if (empty($purchased_entity)) {

      // Don't support combining order items without a purchased entity.
      return [];
    }
    $comparison_fields = [
      'type',
      'purchased_entity',
    ];
    $comparison_fields = array_merge($comparison_fields, $this
      ->getCustomFields($order_item));
    $event = new OrderItemComparisonFieldsEvent($comparison_fields, $order_item);
    $this->eventDispatcher
      ->dispatch(CartEvents::ORDER_ITEM_COMPARISON_FIELDS, $event);
    $comparison_fields = $event
      ->getComparisonFields();
    $comparison_fields = array_unique($comparison_fields);
    $matched_order_items = [];

    /** @var \Drupal\commerce_order\Entity\OrderItemInterface $existing_order_item */
    foreach ($order_items as $existing_order_item) {
      foreach ($comparison_fields as $field_name) {
        if (!$existing_order_item
          ->hasField($field_name) || !$order_item
          ->hasField($field_name)) {

          // The field is missing on one of the order items.
          continue 2;
        }
        $existing_order_item_field = $existing_order_item
          ->get($field_name);
        $order_item_field = $order_item
          ->get($field_name);

        // Two empty fields should be considered identical, but an empty item
        // can affect the comparison and cause a false mismatch.
        $existing_order_item_field = $existing_order_item_field
          ->filterEmptyItems();
        $order_item_field = $order_item_field
          ->filterEmptyItems();
        if (!$existing_order_item_field
          ->equals($order_item_field)) {

          // Order item doesn't match.
          continue 2;
        }
      }
      $matched_order_items[] = $existing_order_item;
    }
    return $matched_order_items;
  }

  /**
   * Gets the names of custom fields shown on the add to cart form.
   *
   * @param \Drupal\commerce_order\Entity\OrderItemInterface $order_item
   *   The order item.
   *
   * @return string[]
   *   The field names.
   */
  protected function getCustomFields(OrderItemInterface $order_item) {
    $field_names = [];
    $storage = $this->entityTypeManager
      ->getStorage('entity_form_display');

    /** @var \Drupal\Core\Entity\Display\EntityFormDisplayInterface $form_display */
    $form_display = $storage
      ->load('commerce_order_item.' . $order_item
      ->bundle() . '.' . 'add_to_cart');
    if ($form_display) {
      $field_names = array_keys($form_display
        ->getComponents());

      // Remove base fields.
      $field_names = array_diff($field_names, [
        'purchased_entity',
        'quantity',
        'created',
      ]);
    }
    return $field_names;
  }

}

Members

Name	Modifiers	Type	Description	Overrides
OrderItemMatcher::$entityTypeManager	protected	property	The entity type manager.
OrderItemMatcher::$eventDispatcher	protected	property	The event dispatcher.
OrderItemMatcher::getCustomFields	protected	function	Gets the names of custom fields shown on the add to cart form.
OrderItemMatcher::match	public	function	Finds the first matching order item for the given order item. Overrides OrderItemMatcherInterface::match
OrderItemMatcher::matchAll	public	function	Finds all matching order items for the given order item. Overrides OrderItemMatcherInterface::matchAll
OrderItemMatcher::__construct	public	function	Constructs a new OrderItemMatcher object.