final class Adjustment in Commerce Core 8.2

Represents an adjustment.

Hierarchy

• class \Drupal\commerce_order\Adjustment

25 files declare their use of Adjustment

AdjustmentComparator.php in modules/order/src/Comparator/AdjustmentComparator.php

AdjustmentDefaultWidget.php in modules/order/src/Plugin/Field/FieldWidget/AdjustmentDefaultWidget.php

AdjustmentItem.php in modules/order/src/Plugin/Field/FieldType/AdjustmentItem.php

AdjustmentItemList.php in modules/order/src/Plugin/Field/FieldType/AdjustmentItemList.php

AdjustmentItemListInterface.php in modules/order/src/Plugin/Field/FieldType/AdjustmentItemListInterface.php

... See full list

File

modules/order/src/Adjustment.php, line 10

Namespace

Drupal\commerce_order

final class Adjustment {

  /**
   * The adjustment type.
   *
   * @var string
   */
  protected $type;

  /**
   * The adjustment label.
   *
   * @var string
   */
  protected $label;

  /**
   * The adjustment amount.
   *
   * @var \Drupal\commerce_price\Price
   */
  protected $amount;

  /**
   * The adjustment percentage.
   *
   * @var string
   */
  protected $percentage;

  /**
   * The source identifier of the adjustment.
   *
   * Points to the source object, if known. For example, a promotion entity for
   * a discount adjustment.
   *
   * @var string
   */
  protected $sourceId;

  /**
   * Whether the adjustment is included in the base price.
   *
   * @var bool
   */
  protected $included = FALSE;

  /**
   * Whether the adjustment is locked.
   *
   * @var bool
   */
  protected $locked = FALSE;

  /**
   * Constructs a new Adjustment object.
   *
   * @param array $definition
   *   The definition.
   */
  public function __construct(array $definition) {
    foreach ([
      'type',
      'label',
      'amount',
    ] as $required_property) {
      if (empty($definition[$required_property])) {
        throw new \InvalidArgumentException(sprintf('Missing required property %s.', $required_property));
      }
    }
    if (!$definition['amount'] instanceof Price) {
      throw new \InvalidArgumentException(sprintf('Property "amount" should be an instance of %s.', Price::class));
    }
    $adjustment_type_manager = \Drupal::service('plugin.manager.commerce_adjustment_type');
    $types = $adjustment_type_manager
      ->getDefinitions();
    if (empty($types[$definition['type']])) {
      throw new \InvalidArgumentException(sprintf('%s is an invalid adjustment type.', $definition['type']));
    }
    if (isset($definition['percentage'])) {
      if (is_float($definition['percentage'])) {
        throw new \InvalidArgumentException(sprintf('The provided percentage "%s" must be a string, not a float.', $definition['percentage']));
      }
      if (!is_numeric($definition['percentage'])) {
        throw new \InvalidArgumentException(sprintf('The provided percentage "%s" is not a numeric value.', $definition['percentage']));
      }
    }

    // Assume that 'custom' adjustments are always locked, for BC reasons.
    if ($definition['type'] == 'custom' && !isset($definition['locked'])) {
      $definition['locked'] = TRUE;
    }
    $this->type = $definition['type'];
    $this->label = (string) $definition['label'];
    $this->amount = $definition['amount'];
    $this->percentage = isset($definition['percentage']) ? $definition['percentage'] : NULL;
    $this->sourceId = !empty($definition['source_id']) ? $definition['source_id'] : NULL;
    $this->included = !empty($definition['included']);
    $this->locked = !empty($definition['locked']);
  }

  /**
   * Gets the adjustment type.
   *
   * @return string
   *   The adjustment type.
   */
  public function getType() : string {
    return $this->type;
  }

  /**
   * Gets the adjustment label.
   *
   * @return string
   *   The adjustment label.
   */
  public function getLabel() : string {
    return $this->label;
  }

  /**
   * Gets the adjustment amount.
   *
   * @return \Drupal\commerce_price\Price
   *   The adjustment amount.
   */
  public function getAmount() : Price {
    return $this->amount;
  }

  /**
   * Gets whether the adjustment is positive.
   *
   * @return bool
   *   TRUE if the adjustment is positive, FALSE otherwise.
   */
  public function isPositive() : bool {
    return $this->amount
      ->getNumber() >= 0;
  }

  /**
   * Gets whether the adjustment is negative.
   *
   * @return bool
   *   TRUE if the adjustment is negative, FALSE otherwise.
   */
  public function isNegative() : bool {
    return $this->amount
      ->getNumber() < 0;
  }

  /**
   * Gets the adjustment percentage.
   *
   * @return string|null
   *   The percentage as a decimal. For example, "0.2" for a 20% adjustment.
   *   Otherwise NULL, if the adjustment was not calculated from a percentage.
   */
  public function getPercentage() {
    return $this->percentage;
  }

  /**
   * Get the source identifier.
   *
   * @return string|null
   *   The source identifier, if available.
   */
  public function getSourceId() {
    return $this->sourceId;
  }

  /**
   * Gets whether the adjustment is included in the price.
   *
   * @return bool
   *   TRUE if the adjustment is included in the price, FALSE otherwise.
   */
  public function isIncluded() : bool {
    return $this->included;
  }

  /**
   * Gets whether the adjustment is locked.
   *
   * Locked adjustments are not removed during the order refresh process.
   *
   * @return bool
   *   TRUE if the adjustment is locked, FALSE otherwise.
   */
  public function isLocked() : bool {
    return $this->locked;
  }

  /**
   * Gets the array representation of the adjustment.
   *
   * @return array
   *   The array representation of the adjustment.
   */
  public function toArray() : array {
    return [
      'type' => $this->type,
      'label' => $this->label,
      'amount' => $this->amount,
      'percentage' => $this->percentage,
      'source_id' => $this->sourceId,
      'included' => $this->included,
      'locked' => $this->locked,
    ];
  }

  /**
   * Adds the given adjustment to the current adjustment.
   *
   * @param \Drupal\commerce_order\Adjustment $adjustment
   *   The adjustment.
   *
   * @return static
   *   The resulting adjustment.
   */
  public function add(Adjustment $adjustment) : Adjustment {
    $this
      ->assertSameType($adjustment);
    $this
      ->assertSameSourceId($adjustment);
    $definition = [
      'amount' => $this->amount
        ->add($adjustment
        ->getAmount()),
    ] + $this
      ->toArray();
    return new static($definition);
  }

  /**
   * Subtracts the given adjustment from the current adjustment.
   *
   * @param \Drupal\commerce_order\Adjustment $adjustment
   *   The adjustment.
   *
   * @return static
   *   The resulting adjustment.
   */
  public function subtract(Adjustment $adjustment) : Adjustment {
    $this
      ->assertSameType($adjustment);
    $this
      ->assertSameSourceId($adjustment);
    $definition = [
      'amount' => $this->amount
        ->subtract($adjustment
        ->getAmount()),
    ] + $this
      ->toArray();
    return new static($definition);
  }

  /**
   * Multiplies the adjustment amount by the given number.
   *
   * @param string $number
   *   The number.
   *
   * @return static
   *   The resulting adjustment.
   */
  public function multiply($number) : Adjustment {
    $definition = [
      'amount' => $this->amount
        ->multiply($number),
    ] + $this
      ->toArray();
    return new static($definition);
  }

  /**
   * Divides the adjustment amount by the given number.
   *
   * @param string $number
   *   The number.
   *
   * @return static
   *   The resulting adjustment.
   */
  public function divide($number) : Adjustment {
    $definition = [
      'amount' => $this->amount
        ->divide($number),
    ] + $this
      ->toArray();
    return new static($definition);
  }

  /**
   * Asserts that the given adjustment's type matches the current one.
   *
   * @param \Drupal\commerce_order\Adjustment $adjustment
   *   The adjustment to compare.
   *
   * @throws \InvalidArgumentException
   *   Thrown when the adjustment type does not match the current one.
   */
  protected function assertSameType(Adjustment $adjustment) {
    if ($this->type != $adjustment
      ->getType()) {
      throw new \InvalidArgumentException(sprintf('Adjustment type "%s" does not match "%s".', $adjustment
        ->getType(), $this->type));
    }
  }

  /**
   * Asserts that the given adjustment's source ID matches the current one.
   *
   * @param \Drupal\commerce_order\Adjustment $adjustment
   *   The adjustment to compare.
   *
   * @throws \InvalidArgumentException
   *   Thrown when the adjustment source ID does not match the current one.
   */
  protected function assertSameSourceId(Adjustment $adjustment) {
    if ($this->sourceId != $adjustment
      ->getSourceId()) {
      throw new \InvalidArgumentException(sprintf('Adjustment source ID "%s" does not match "%s".', $adjustment
        ->getSourceId(), $this->sourceId));
    }
  }

}

Members

Name	Modifiers	Type	Description	Overrides
Adjustment::$amount	protected	property	The adjustment amount.
Adjustment::$included	protected	property	Whether the adjustment is included in the base price.
Adjustment::$label	protected	property	The adjustment label.
Adjustment::$locked	protected	property	Whether the adjustment is locked.
Adjustment::$percentage	protected	property	The adjustment percentage.
Adjustment::$sourceId	protected	property	The source identifier of the adjustment.
Adjustment::$type	protected	property	The adjustment type.
Adjustment::add	public	function	Adds the given adjustment to the current adjustment.
Adjustment::assertSameSourceId	protected	function	Asserts that the given adjustment's source ID matches the current one.
Adjustment::assertSameType	protected	function	Asserts that the given adjustment's type matches the current one.
Adjustment::divide	public	function	Divides the adjustment amount by the given number.
Adjustment::getAmount	public	function	Gets the adjustment amount.
Adjustment::getLabel	public	function	Gets the adjustment label.
Adjustment::getPercentage	public	function	Gets the adjustment percentage.
Adjustment::getSourceId	public	function	Get the source identifier.
Adjustment::getType	public	function	Gets the adjustment type.
Adjustment::isIncluded	public	function	Gets whether the adjustment is included in the price.
Adjustment::isLocked	public	function	Gets whether the adjustment is locked.
Adjustment::isNegative	public	function	Gets whether the adjustment is negative.
Adjustment::isPositive	public	function	Gets whether the adjustment is positive.
Adjustment::multiply	public	function	Multiplies the adjustment amount by the given number.
Adjustment::subtract	public	function	Subtracts the given adjustment from the current adjustment.
Adjustment::toArray	public	function	Gets the array representation of the adjustment.
Adjustment::__construct	public	function	Constructs a new Adjustment object.