# Product catalog events

## Products

| Event                                  | Dispatched by                                           | Properties                                                                                               |
| -------------------------------------- | ------------------------------------------------------- | -------------------------------------------------------------------------------------------------------- |
| `BeforeCreateAttributeDefinitionEvent` | `AttributeDefinitionService::createAttributeDefinition` | `AttributeDefinitionCreateStruct $createStruct`                                                          |
| `BeforeCreateAttributeGroupEvent`      | `AttributeGroupService::createAttributeGroup`           | `AttributeGroupCreateStruct $createStruct`                                                               |
| `BeforeCreateProductEvent`             | `ProductService::createProduct`                         | `ProductCreateStruct $createStruct`                                                                      |
| `BeforeDeleteAttributeDefinitionEvent` | `AttributeDefinitionService::deleteAttributeDefinition` | `AttributeDefinitionInterface $attributeDefinition`                                                      |
| `BeforeDeleteAttributeGroupEvent`      | `AttributeGroupService::deleteAttributeGroup`           | `AttributeGroupInterface $attributeGroup`                                                                |
| `BeforeDeleteProductEvent`             | `ProductService::deleteProduct`                         | `ProductInterface $product`                                                                              |
| `BeforeUpdateAttributeDefinitionEvent` | `AttributeDefinitionService::updateAttributeDefinition` | ``` AttributeDefinitionInterface $attributeDefinition``AttributeDefinitionUpdateStruct $updateStruct ``` |
| `BeforeUpdateAttributeGroupEvent`      | `AttributeGroupService::updateAttributeGroup`           | ``` AttributeGroupInterface $attributeGroup``AttributeGroupUpdateStruct $updateStruct ```                |
| `BeforeUpdateProductEvent`             | `ProductService::updateProduct`                         | `ProductUpdateStruct $updateStruct`                                                                      |
| `CreateAttributeDefinitionEvent`       | `AttributeDefinitionService::createAttributeDefinition` | ``` AttributeDefinitionCreateStruct $createStruct``AttributeDefinitionInterface $attributeDefinition ``` |
| `CreateAttributeGroupEvent`            | `AttributeGroupService::createAttributeGroup`           | ``` AttributeGroupCreateStruct $createStruct``AttributeGroupInterface $attributeGroup ```                |
| `CreateProductEvent`                   | `ProductService::createProduct`                         | ``` ProductCreateStruct $createStruct``ProductInterface $product ```                                     |
| `DeleteAttributeDefinitionEvent`       | `AttributeDefinitionService::deleteAttributeDefinition` | `AttributeDefinitionInterface $attributeDefinition`                                                      |
| `DeleteAttributeGroupEvent`            | `AttributeGroupService::deleteAttributeGroup`           | `AttributeGroupInterface $attributeGroup`                                                                |
| `DeleteProductEvent`                   | `ProductService::deleteProduct`                         | `ProductInterface $product`                                                                              |
| `UpdateAttributeDefinitionEvent`       | `AttributeDefinitionService::updateAttributeDefinition` | ``` AttributeDefinitionInterface $attributeDefinition``AttributeDefinitionUpdateStruct $updateStruct ``` |
| `UpdateAttributeGroupEvent`            | `AttributeGroupService::updateAttributeGroup`           | ``` AttributeGroupInterface $attributeGroup``AttributeGroupUpdateStruct $updateStruct ```                |
| `UpdateProductEvent`                   | `ProductService::updateProduct`                         | ``` ProductInterface $product``ProductUpdateStruct $updateStruct ```                                     |

## Product variants

| Event                              | Dispatched by                           | Properties                                                                                |
| ---------------------------------- | --------------------------------------- | ----------------------------------------------------------------------------------------- |
| `BeforeCreateProductVariantsEvent` | `ProductService::createProductVariants` | ``` ProductInterface $product``iterable $createStructs ```                                |
| `BeforeUpdateProductVariantEvent`  | `ProductService::updateProductVariant`  | ``` ProductVariantInterface $productVariant``ProductVariantUpdateStruct $updateStruct ``` |
| `CreateProductVariantsEvent`       | `ProductService::createProductVariants` | ``` ProductInterface $product``iterable $createStructs ```                                |
| `UpdateProductVariantEvent`        | `ProductService::updateProductVariant`  | ``` ProductVariantInterface $productVariant``ProductVariantUpdateStruct $updateStruct ``` |

## Product availability

| Event                                    | Dispatched by                                             | Properties                                                                                        |
| ---------------------------------------- | --------------------------------------------------------- | ------------------------------------------------------------------------------------------------- |
| `BeforeCreateProductAvailabilityEvent`   | `ProductAvailabilityService::createProductAvailability`   | `ProductAvailabilityCreateStruct $createStruct`                                                   |
| `BeforeDecreaseProductAvailabilityEvent` | `ProductAvailabilityService::decreaseProductAvailability` | ``` ProductInterface $product``int $amount ```                                                    |
| `BeforeDeleteProductAvailabilityEvent`   | `ProductAvailabilityService::deleteProductAvailability`   | `ProductInterface $product`                                                                       |
| `BeforeIncreaseProductAvailabilityEvent` | `ProductAvailabilityService::increaseProductAvailability` | ``` ProductInterface $product``int $amount ```                                                    |
| `BeforeUpdateProductAvailabilityEvent`   | `ProductAvailabilityService::updateProductAvailability`   | `ProductAvailabilityUpdateStruct $updateStruct`                                                   |
| `CreateProductAvailabilityEvent`         | `ProductAvailabilityService::createProductAvailability`   | ``` ProductAvailabilityCreateStruct $createStruct``AvailabilityInterface $productAvailability ``` |
| `DecreaseProductAvailabilityEvent`       | `ProductAvailabilityService::decreaseProductAvailability` | ``` AvailabilityInterface $productAvailability``ProductInterface $product``int $amount ```        |
| `DeleteProductAvailabilityEvent`         | `ProductAvailabilityService::deleteProductAvailability`   | `ProductInterface $product`                                                                       |
| `IncreaseProductAvailabilityEvent`       | `ProductAvailabilityService::increaseProductAvailability` | ``` AvailabilityInterface $productAvailability ProductInterface $product``int $amount ```         |
| `UpdateProductAvailabilityEvent`         | `ProductAvailabilityService::updateProductAvailability`   | ``` AvailabilityInterface $productAvailability``ProductAvailabilityUpdateStruct $updateStruct ``` |

## Price

| Event                    | Dispatched by                             | Properties                                                                     |
| ------------------------ | ----------------------------------------- | ------------------------------------------------------------------------------ |
| `BeforeCreatePriceEvent` | `ProductPriceService::createProductPrice` | `ProductPriceCreateStructInterface $createStruct`                              |
| `BeforeDeletePriceEvent` | `ProductPriceService::deletePrice`        | `ProductPriceDeleteStructInterface $deleteStruct`                              |
| `BeforeUpdatePriceEvent` | `ProductPriceService::updateProductPrice` | `ProductPriceUpdateStructInterface $updateStruct`                              |
| `CreatePriceEvent`       | `ProductPriceService::createProductPrice` | ``` ProductPriceCreateStructInterface $createStruct``PriceInterface $price ``` |
| `DeletePriceEvent`       | `ProductPriceService::deletePrice`        | `ProductPriceDeleteStructInterface $deleteStruct`                              |
| `UpdatePriceEvent`       | `ProductPriceService::updateProductPrice` | ``` PriceInterface $price``ProductPriceUpdateStructInterface $updateStruct ``` |

## Currency

| Event                       | Dispatched by                     | Properties                                                              |
| --------------------------- | --------------------------------- | ----------------------------------------------------------------------- |
| `BeforeCreateCurrencyEvent` | `CurrencyService::createCurrency` | `CurrencyCreateStruct $createStruct`                                    |
| `BeforeDeleteCurrencyEvent` | `CurrencyService::deleteCurrency` | `CurrencyInterface $currency`                                           |
| `BeforeUpdateCurrencyEvent` | `CurrencyService::updateCurrency` | ``` CurrencyInterface $currency``CurrencyUpdateStruct $updateStruct ``` |
| `CreateCurrencyEvent`       | `CurrencyService::createCurrency` | ``` CurrencyCreateStruct $createStruct``CurrencyInterface $currency ``` |
| `DeleteCurrencyEvent`       | `CurrencyService::deleteCurrency` | `CurrencyInterface $currency`                                           |
| `UpdateCurrencyEvent`       | `CurrencyService::updateCurrency` | ``` CurrencyInterface $currency``CurrencyUpdateStruct $updateStruct ``` |

## Catalogs

| Event                      | Dispatched by                   | Properties                                                           |
| -------------------------- | ------------------------------- | -------------------------------------------------------------------- |
| `BeforeCreateCatalogEvent` | `CatalogService::createCatalog` | `CatalogCreateStruct $createStruct`                                  |
| `BeforeDeleteCatalogEvent` | `CatalogService::deleteCatalog` | `CatalogInterface $catalog`                                          |
| `BeforeUpdateCatalogEvent` | `CatalogService::updateCatalog` | `CatalogUpdateStruct $updateStruct`                                  |
| `CreateCatalogEvent`       | `CatalogService::createCatalog` | ``` CatalogCreateStruct $createStruct``CatalogInterface $catalog ``` |
| `DeleteCatalogEvent`       | `CatalogService::deleteCatalog` | `CatalogInterface $catalog`                                          |
| `UpdateCatalogEvent`       | `CatalogService::updateCatalog` | `CatalogUpdateStruct $updateStruct`                                  |

## Attribute rendering

The following event is dispatched when the [`ibexa_format_product_attribute`](https://doc.ibexa.co/en/latest/templating/twig_function_reference/product_twig_functions/#ibexa_format_product_attribute) Twig filter renders an attribute value.

| Event                         | Dispatched by                                | Properties                                                                                                                                                                                             |
| ----------------------------- | -------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| `ProductAttributeRenderEvent` | `ibexa_format_product_attribute` Twig filter | `list<string> $templates`[`AttributeInterface`](https://doc.ibexa.co/en/latest/api/php_api/php_api_reference/classes/Ibexa-Contracts-ProductCatalog-Values-AttributeInterface.html)`array $parameters` |

For a usage example, see [Customize product attribute templates](https://doc.ibexa.co/en/latest/product_catalog/customize_product_attribute_templates/index.md).