interface ProductAttributeFieldManagerInterface in Commerce Core 8.2

Manages attribute fields.

Attribute fields are entity reference fields storing values of a specific attribute on the product variation.

Hierarchy

• interface \Drupal\commerce_product\ProductAttributeFieldManagerInterface

4 files declare their use of ProductAttributeFieldManagerInterface

ProductAttributeForm.php in modules/product/src/Form/ProductAttributeForm.php

ProductAttributesOverview.php in modules/product/src/Plugin/Field/FieldFormatter/ProductAttributesOverview.php

ProductVariationAttributesWidget.php in modules/product/src/Plugin/Field/FieldWidget/ProductVariationAttributesWidget.php

ProductVariationTypeForm.php in modules/product/src/Form/ProductVariationTypeForm.php

File

modules/product/src/ProductAttributeFieldManagerInterface.php, line 13

Namespace

Drupal\commerce_product

interface ProductAttributeFieldManagerInterface {

  /**
   * Gets the attribute field definitions.
   *
   * The field definitions are not ordered.
   * Use the field map when the field order is important.
   *
   * @param string $variation_type_id
   *   The product variation type ID.
   *
   * @return \Drupal\Core\Field\FieldDefinitionInterface[]
   *   The attribute field definitions, keyed by field name.
   */
  public function getFieldDefinitions($variation_type_id);

  /**
   * Gets a map of attribute fields across variation types.
   *
   * @param string $variation_type_id
   *   (Optional) The product variation type ID.
   *   When given, used to filter the returned maps.
   *
   * @return array
   *   If a product variation type ID was given, a list of maps.
   *   Otherwise, a list of maps grouped by product variation type ID.
   *   Each map is an array with the following keys:
   *   - attribute_id: The attribute id;
   *   - field_name: The attribute field name.
   *   The maps are ordered by the weight of the attribute fields on the
   *   default product variation form display.
   */
  public function getFieldMap($variation_type_id = NULL);

  /**
   * Clears the attribute field map and definition caches.
   */
  public function clearCaches();

  /**
   * Creates an attribute field for the given attribute.
   *
   * @param \Drupal\commerce_product\Entity\ProductAttributeInterface $attribute
   *   The product attribute.
   * @param string $variation_type_id
   *   The product variation type ID.
   */
  public function createField(ProductAttributeInterface $attribute, $variation_type_id);

  /**
   * Checks whether the attribute field for the given attribute can be deleted.
   *
   * An attribute field is no longer deletable once it has data.
   *
   * @param \Drupal\commerce_product\Entity\ProductAttributeInterface $attribute
   *   The product attribute.
   * @param string $variation_type_id
   *   The product variation type ID.
   *
   * @throws \InvalidArgumentException
   *   Thrown when the attribute field does not exist.
   *
   * @return bool
   *   TRUE if the attribute field can be deleted, FALSE otherwise.
   */
  public function canDeleteField(ProductAttributeInterface $attribute, $variation_type_id);

  /**
   * Deletes the attribute field for the given attribute.
   *
   * @param \Drupal\commerce_product\Entity\ProductAttributeInterface $attribute
   *   The product attribute.
   * @param string $variation_type_id
   *   The product variation type ID.
   */
  public function deleteField(ProductAttributeInterface $attribute, $variation_type_id);

}

Members

Name	Modifiers	Type	Description	Overrides
ProductAttributeFieldManagerInterface::canDeleteField	public	function	Checks whether the attribute field for the given attribute can be deleted.	1
ProductAttributeFieldManagerInterface::clearCaches	public	function	Clears the attribute field map and definition caches.	1
ProductAttributeFieldManagerInterface::createField	public	function	Creates an attribute field for the given attribute.	1
ProductAttributeFieldManagerInterface::deleteField	public	function	Deletes the attribute field for the given attribute.	1
ProductAttributeFieldManagerInterface::getFieldDefinitions	public	function	Gets the attribute field definitions.	1
ProductAttributeFieldManagerInterface::getFieldMap	public	function	Gets a map of attribute fields across variation types.	1