Doc for Quable

code_samples/back_office/search/src/Query/ProductCategorySubtreeQuery.php

@@ -0,0 +1,12 @@
+<?php declare(strict_types=1);
+
+use Ibexa\Contracts\ProductCatalog\Values\Product\ProductQuery;
+use Ibexa\Contracts\ProductCatalog\Values\Product\Query\Criterion\ProductCategorySubtree;
+
+$taxonomyEntryId = 42;
+$criteria = new ProductCategorySubtree($taxonomyEntryId);
+
+/** @var \Ibexa\Contracts\ProductCatalog\ProductServiceInterface $productService */
+$productQuery = new ProductQuery();
+$productQuery->setQuery($criteria);
+$results = $productService->findProducts($productQuery);

code_samples/back_office/search/src/Query/UpdatedAtQuery.php

@@ -0,0 +1,16 @@
+<?php declare(strict_types=1);
+
+use DateTimeImmutable;
+use Ibexa\Contracts\ProductCatalog\Values\Product\ProductQuery;
+use Ibexa\Contracts\ProductCatalog\Values\Product\Query\Criterion\Operator;
+use Ibexa\Contracts\ProductCatalog\Values\Product\Query\Criterion\UpdatedAt;
+
+$criteria = new UpdatedAt(
+    new DateTimeImmutable('2023-03-01'),
+    Operator::GTE,
+);
+
+/** @var \Ibexa\Contracts\ProductCatalog\ProductServiceInterface $productService */
+$productQuery = new ProductQuery();
+$productQuery->setQuery($criteria);
+$results = $productService->findProducts($productQuery);

code_samples/back_office/search/src/Query/UpdatedAtRangeQuery.php

@@ -0,0 +1,15 @@
+<?php declare(strict_types=1);
+
+use DateTimeImmutable;
+use Ibexa\Contracts\ProductCatalog\Values\Product\ProductQuery;
+use Ibexa\Contracts\ProductCatalog\Values\Product\Query\Criterion\UpdatedAtRange;
+
+$criteria = new UpdatedAtRange(
+    new DateTimeImmutable('2020-07-10T00:00:00+00:00'),
+    new DateTimeImmutable('2023-07-12T00:00:00+00:00'),
+);
+
+/** @var \Ibexa\Contracts\ProductCatalog\ProductServiceInterface $productService */
+$productQuery = new ProductQuery();
+$productQuery->setQuery($criteria);
+$results = $productService->findProducts($productQuery);

code_samples/product_catalog/src/EventSubscriber/MyAttributeRenderSubscriber.php

@@ -0,0 +1,18 @@
+<?php declare(strict_types=1);
+
+namespace App\EventSubscriber;
+
+use Ibexa\Contracts\ProductCatalog\Events\ProductAttributeRenderEvent;
+use Symfony\Component\EventDispatcher\Attribute\AsEventListener;
+
+final readonly class MyAttributeRenderSubscriber
+{
+    #[AsEventListener]
+    public function onAttributeRender(ProductAttributeRenderEvent $event): void
+    {
+        $event->addTemplateBefore(
+            'templates/product/attributes/integer_attribute.html.twig',
+            '@ibexadesign/product_catalog/product/attributes/attribute_blocks.html.twig',
+        );
+    }
+}

composer.json

@@ -78,8 +78,9 @@
         "ibexa/messenger": "~5.0.x-dev",
         "ibexa/collaboration": "~5.0.x-dev",
         "ibexa/share": "~5.0.x-dev",
-        "ibexa/shopping-list": "~5.0.x-dev",
         "ibexa/phpstan": "~5.0.-dev",
+        "ibexa/connector-quable": "5.0.x-dev",
+        "ibexa/shopping-list": "~5.0.x-dev",
         "deptrac/deptrac": "^3.0",
         "ibexa/cdp": "~5.0.x-dev",
         "ibexa/connector-raptor": "~5.0.x-dev",

docs/ai_actions/ai_actions_guide.md

@@ -168,7 +168,7 @@ Instead of manually browsing through extensive taxonomy trees, editors can reque
 
 ### Performing advanced image to text analysis
 
-With some additional customization, store managers could benefit from automating part of product management by integrating their [[= product_name =]] with Google Cloud Vision and [PIM](pim_guide.md) by using [[= product_name_connect =]].
+With some additional customization, store managers could benefit from automating part of product management by integrating their [[= product_name =]] with Google Cloud Vision and the [product catalog](product_catalog_guide.md) by using [[= product_name_connect =]].
 Instead of manually selecting and linking images stored in a [DAM](add_image_asset_from_dam.md) solution to their products, they could use of a no-code workflow where an AI service, for example, Google Cloud Vision, extracts text and attributes from product images, which are then matched with existing items in a product catalog.
 
 This would enable automatic product identification, tagging, and catalog updates, resulting in less manual work and more efficient product management.

docs/api/event_reference/catalog_events.md → docs/api/event_reference/product_catalog_events.md

@@ -1,9 +1,10 @@
 ---
-description: Events that are triggered when working with products, prices and currencies.
+description: Events that are triggered when working with products, prices, currencies, and attribute rendering.
 page_type: reference
+month_change: true
 ---
 
-# Catalog events
+# Product catalog events
 
 ## Products
 
@@ -84,3 +85,13 @@
 |`CreateCatalogEvent`|`CatalogService::createCatalog`|`CatalogCreateStruct $createStruct`</br>`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`](product_twig_functions.md#ibexa_format_product_attribute) Twig filter renders an attribute value.
+
+| Event | Dispatched by | Properties |
+|---|---|---|
+|`ProductAttributeRenderEvent`|`ibexa_format_product_attribute` Twig filter|`list<string> $templates`</br>[`AttributeInterface`](/api/php_api/php_api_reference/classes/Ibexa-Contracts-ProductCatalog-Values-AttributeInterface.html)</br>`array $parameters`|
+
+For a usage example, see [Customize product attribute templates](customize_product_attribute_templates.md).

docs/content_management/content_model.md

@@ -139,6 +139,6 @@ A new version is also created when a new [language](languages.md) is added to th
 
 ## Products
 
-Products are a special type of content that holds products you can manage in the built-in PIM system.
+Products are a special type of content that holds products you can manage with the product catalog capabilities.
 
-For more information, see [PIM](pim.md).
+For more information, see [Product catalog](../product_catalog/product_catalog.md).

docs/content_management/field_types/field_type_reference/productspecificationfield.md

@@ -6,7 +6,7 @@ month_change: false
 # Product specification field type
 
 This field represents and handles [product attributes](products.md#product-attributes) and [VAT](prices.md#vat).
-Consider it as internal to the [PIM](pim.md).
+Consider it as internal to the [product catalog](product_catalog.md).
 
 | Name                   | Internal name                 | Expected input |
 |------------------------|-------------------------------|----------------|

docs/content_management/rich_text/online_editor_guide.md

@@ -77,7 +77,7 @@
 
 ### Plugins
 
-Because Online Editor is based on CKEditor 5, you can use CKEditor's capabilities to [create plugins](extend_online_editor.md#add-ckeditor-plugins) for the editor.
+Online Editor is based on CKEditor 5, and you can use CKEditor's capabilities to [create plugins](extend_online_editor.md#add-ckeditor-plugins) for the editor.
 
 ## Benefits
 
@@ -112,6 +112,15 @@
 
 Refer to [Extend Online Editor](extend_online_editor.md#link-tag) for a similar use case.
 
+### Product marketing campaigns
+
+With the Online Editor, editors can embed products from the product catalog directly into RichText fields.
+Products can be embedded as block-level or inline elements.
+
+You can use it to weave marketing content around your product data, showcasing your product capabilities and bringing it closer to your customers.
+
+See [Embed products in content](products.md#embed-products-in-content) for details.
+
 ### Embed external resources
 
 Custom tags allow embedding content from external resources inside RichText fields.

docs/discounts/discounts_guide.md

@@ -71,7 +71,7 @@
 - **Fixed amount** - where a specified amount of money, for example, 5 Euro, is deducted from the base price of the product
 - **Percentage** - where a specified percentage, for example, 10%, is used to calculate the deducted amount from the product's base price
 
-Discounts are translatable and you can limit them to specific [regions](pim_guide.md#regions) or a single currency.
+Discounts are translatable and you can limit them to specific [regions](product_catalog_guide.md#regions) or a single currency.
 They can be permanent or be active only in a specified time frame.
 Regardless of the specified dates, you can disable a discount at any time to prevent customers from using it.
 
@@ -86,10 +86,10 @@
 
 #### Product selection
 
-All products, including [product variants](pim_guide.md#product-variants), can be selected when creating a discount.
+All products, including [product variants](product_catalog_guide.md#product-variants), can be selected when creating a discount.
 You can also limit this choice to a subset of products:
 
-- belonging to selected [product categories](pim_guide.md#product-categories)
+- belonging to selected [product categories](product_catalog_guide.md#product-categories)
 - hand-picked manually for special cases
 
 #### Conditions

docs/discounts/extend_discounts.md

@@ -32,7 +32,7 @@ You can also [create your own](#custom-expressions).
 | Type | Name | Value | Available for |
 | --- | --- | --- | --- |
 | Function | `get_current_region()` | [Region object](/api/php_api/php_api_reference/classes/Ibexa-Contracts-ProductCatalog-Values-RegionInterface.html) of the current siteaccess.| Conditions, rules |
-| Function | `is_in_category()` | `true/false`, depending if a product belongs to given [product categories](pim_guide.md#product-categories).| Conditions, rules |
+| Function | `is_in_category()` | `true/false`, depending if a product belongs to given [product categories](product_catalog_guide.md#product-categories).| Conditions, rules |
 | Function | `is_user_in_customer_group()` | `true/false`, depending if an user belongs to given [customer groups](customer_groups.md). | Conditions, rules |
 | Function | `calculate_purchase_amount()` | Purchase amount, calculated for all products in the cart before the discounts are applied.| Conditions, rules |
 | Function | <nobr>`is_product_in_product_codes()`</nobr> | Parameters: <br> - [Product object](/api/php_api/php_api_reference/classes/Ibexa-Contracts-ProductCatalog-Values-ProductInterface.html)<br>- array of product codes<br> Returns `true` if the product is part of the given list.| Conditions, rules |

docs/ibexa_products/editions.md

@@ -30,7 +30,7 @@ Compare all features available in [[= product_name_headless =]], [[= product_nam
 | [Search]([[= user_doc =]]/search/search_for_content/) | ✔ | ✔ | ✔ |
 | [Editorial workflow]([[= user_doc =]]/content_management/workflow_management/editorial_workflow/) | ✔ | ✔ | ✔ |
 | [Digital Asset Management]([[= user_doc =]]/dam/ibexa_dam/) | ✔ | ✔ | ✔ |
-| [Product Information Management]([[= user_doc =]]/pim/pim/) | ✔ | ✔ | ✔ |
+| [Product catalog capabilities]([[= user_doc =]]/pim/pim/) | ✔ | ✔ | ✔ |
 | [Date and time attribute type](date_and_time.md) | ✔ | ✔ | ✔ |
 | [Symbol attribute type](symbol_attribute_type.md) | ✔ | ✔ | ✔ |
 | [Personalization](personalization_guide.md) | ✔ | ✔ | ✔ |

docs/ibexa_products/ibexa_commerce.md

@@ -84,7 +84,7 @@ You can set up your search engine using [[= product_name_com =]] to help clients
 
 #### Catalog management
 
-[[= product_name_com =]] gives you the ability to manage your product repository - [PIM](pim_guide.md), and construct an infinite number of product catalogs, each with unique prices, to further customize the experience for your customers.
+[[= product_name_com =]] gives you the ability to manage your product repository - [Product catalog](product_catalog_guide.md), and construct an infinite number of catalogs, each with unique prices, to further customize the experience for your customers.
 
 #### Transactional emails
 

docs/ibexa_products/ibexa_headless.md

@@ -10,7 +10,7 @@ description: Get to know Ibexa Headless - an edition that focuses on content man
 The Headless edition of [[= product_name =]] focuses on content management.
 It provides tools to collaboratively create content, and interfaces (API) to distribute this content.
 
-Multilingual, multichannel, extensible, [[= product_name_headless =]] is an advanced Content Management Framework (CMF), a Product Information Management (PIM) platform, and a Digital Asset Management (DAM) repository.
+Multilingual, multichannel, extensible, [[= product_name_headless =]] is an advanced Content Management Framework (CMF) with product catalog capabilities, and a Digital Asset Management (DAM) repository.
 It's provided without a default front office, but with a complete back office and several APIs to manage and access content.
 
 ![Ibexa Headless](ibexa_headless.png)
@@ -118,7 +118,7 @@ Like everything in the back office, the calendar is extendable: you can add an e
 
 #### Many ways to structure and organize content
 
-[Product Information Management](pim_guide.md) (PIM) helps organize complex products and their catalogs:
+[Product catalog](product_catalog_guide.md) helps organize complex products and their catalogs:
 
 - Products are organized by using product types, variants, catalogs, categories, and tags.
 - Product attributes are grouped and factorized among product types. For example, fabric + color + size can be shared by many clothing product types.

docs/index.md

@@ -122,8 +122,8 @@
                         </div>
                         <div class="col-12 col-lg-6 col-fhd-3">
                             <ul>
-                                <li><a href="release_notes/ibexa_dxp_v5.0/#date-and-time-attribute">Date and time attibute for PIM</a></li>
-                                <li><a href="release_notes/ibexa_dxp_v5.0/#symbol-attribute">Symbol attribute for PIM</a></li>
+                                <li><a href="release_notes/ibexa_dxp_v5.0/#date-and-time-attribute">Date and time attribute for product catalog</a></li>
+                                <li><a href="release_notes/ibexa_dxp_v5.0/#symbol-attribute">Symbol attribute for product catalog</a></li>
                                 <li><a href="release_notes/ibexa_dxp_v5.0/#developer-experience">Developer experience improvements</a></li>
                             </ul>
                         </div>
@@ -185,15 +185,16 @@
             <div class="info-tile info-tile--link-card">
                 <div class="info-tile__content">
                     <h3>
-                        <a href="pim/pim/">
+                        <a href="product_catalog/product_catalog/">
                             <svg><use xlink:href="images/icons.svg#product" /></svg>
-                            Product
+                            Product catalog
                         </a>
                     </h3>
                     <ul>
-                        <li><a href="pim/pim_configuration/">PIM configuration</a></li>
-                        <li><a href="pim/catalogs/">Catalogs</a></li>
-                        <li><a href="pim/prices/">Prices</a></li>
+                        <li><a href="product_catalog/product_catalog_configuration/">Product catalog configuration</a></li>
+                        <li><a href="product_catalog/quable_integration/">Quable PIM Integration</a></li>
+                        <li><a href="product_catalog/catalogs/">Catalogs</a></li>
+                        <li><a href="product_catalog/prices/">Prices</a></li>
                     </ul>
                 </div>
             </div>

docs/permissions/limitation_reference.md

@@ -290,6 +290,10 @@ The Personalization limitation specifies the SiteAccesses for which the user can
 
 The Product Type (`ProductType`) limitation specifies whether the user has access to products belonging to a specific product type.
 
+!!! warning
+
+    The `ProductType` limitation can't be used when using [[[= pim_product_name =]]](/product_catalog/quable/quable.md).
+
 ### Possible values
 
 |Value|UI value|Description|

docs/permissions/policies.md

@@ -289,7 +289,7 @@
 | <nobr>`comparison`</nobr> | <nobr>`view`</nobr>         | view version comparison                |
 | <nobr>`workflow`</nobr>   | <nobr>`change_stage`</nobr> | change stage in the specified workflow | [Workflow Transition](limitation_reference.md#workflow-transition-limitation) |
 
-### PIM
+### Product catalog
 
 #### Catalogs
 
@@ -309,6 +309,10 @@
 |                        | <nobr>`edit`</nobr>   | edit a product                              | [Product Type](limitation_reference.md#product-type-limitation)</br>[Language](limitation_reference.md#language-limitation) |
 |                        | <nobr>`view`</nobr>   | view products listed in the product catalog | [Product Type](limitation_reference.md#product-type-limitation)                                                             |
 
+!!! warning
+
+    The `ProductType` limitation can't be used when using [[[= pim_product_name =]]](/product_catalog/quable/quable.md).
+
 #### Product collaborative editing
 
 | Module               | Function              | Effect                                                                   | Possible limitations |
@@ -317,12 +321,16 @@
 
 #### Product types
 
-| Module                      | Function              | Effect                                                                                                          | Possible limitations |
-|-----------------------------|-----------------------|-----------------------------------------------------------------------------------------------------------------|----------------------|
-| <nobr>`product_type`</nobr> | <nobr>`create`</nobr> | create a product type, a new attribute, a new attribute group, and add translation to product type and attribute |
-|                             | <nobr>`delete`</nobr> | delete a product type, attribute, attribute group                                                               |
-|                             | <nobr>`edit`</nobr>   | edit a product type, attribute, attribute group                                                                 |
-|                             | <nobr>`view`</nobr>   | view product types, attributes and attribute groups                                                             |
+| Module                      | Function              | Effect                                                                                                           | Possible limitations |
+|-----------------------------|-----------------------|------------------------------------------------------------------------------------------------------------------|----------------------|
+| <nobr>`product_type`</nobr> | <nobr>`create`</nobr> | create a product type, a new attribute, a new attribute group, and add translation to product type and attribute | [Product Type](limitation_reference.md#product-type-limitation) |
+|                             | <nobr>`delete`</nobr> | delete a product type, attribute, attribute group                                                                |                      |
+|                             | <nobr>`edit`</nobr>   | edit a product type, attribute, attribute group                                                                  | [Product Type](limitation_reference.md#product-type-limitation) |
+|                             | <nobr>`view`</nobr>   | view product types, attributes and attribute groups                                                              |                      |
+
+!!! warning
+
+    The `ProductType` limitation can't be used when using [[[= pim_product_name =]]](/product_catalog/quable/quable.md).
 
 ## Combining policies