[Discounts] Added doc for 4.6.22

Author: mnocon

code_samples/data_migration/examples/discounts/discount_code_create.yaml

@@ -0,0 +1,7 @@
+type: discount_code
+mode: create
+code: TEST_CODE
+global_usage_limit: 100 # Optional
+user_usage_limit: 5 # Optional
+created_at: '2023-01-01T12:00:00+00:00' # Optional
+creator_id: 42 # Optional

docs/api/event_reference/discounts_events.md

@@ -13,14 +13,16 @@ month_change: true
 
 The events below are dispatched when managing [discounts](discounts_guide.md):
 
-| Event | Dispatched by |
-|---|---|
-|[BeforeCreateDiscountEvent](/api/php_api/php_api_reference/classes/Ibexa-Contracts-Discounts-Event-BeforeCreateDiscountEvent.html)| [DiscountServiceInterface](/api/php_api/php_api_reference/classes/Ibexa-Contracts-Discounts-DiscountServiceInterface.html)
-|[CreateDiscountEvent](/api/php_api/php_api_reference/classes/Ibexa-Contracts-Discounts-Event-CreateDiscountEvent.html)| [DiscountServiceInterface](/api/php_api/php_api_reference/classes/Ibexa-Contracts-Discounts-DiscountServiceInterface.html)
-|[BeforeDeleteDiscountEvent](/api/php_api/php_api_reference/classes/Ibexa-Contracts-Discounts-Event-BeforeDeleteDiscountEvent.html)| [DiscountServiceInterface](/api/php_api/php_api_reference/classes/Ibexa-Contracts-Discounts-DiscountServiceInterface.html)
-|[DeleteDiscountEvent](/api/php_api/php_api_reference/classes/Ibexa-Contracts-Discounts-Event-DeleteDiscountEvent.html)| [DiscountServiceInterface](/api/php_api/php_api_reference/classes/Ibexa-Contracts-Discounts-DiscountServiceInterface.html)
-|[BeforeUpdateDiscountEvent](/api/php_api/php_api_reference/classes/Ibexa-Contracts-Discounts-Event-BeforeUpdateDiscountEvent.html)| [DiscountServiceInterface](/api/php_api/php_api_reference/classes/Ibexa-Contracts-Discounts-DiscountServiceInterface.html)|
-|[UpdateDiscountEvent](/api/php_api/php_api_reference/classes/Ibexa-Contracts-Discounts-Event-UpdateDiscountEvent.html)| [DiscountServiceInterface](/api/php_api/php_api_reference/classes/Ibexa-Contracts-Discounts-DiscountServiceInterface.html)|
+| Event | Dispatched by | Description |
+|---|---|---|
+|[BeforeCreateDiscountEvent](/api/php_api/php_api_reference/classes/Ibexa-Contracts-Discounts-Event-BeforeCreateDiscountEvent.html)| [DiscountServiceInterface](/api/php_api/php_api_reference/classes/Ibexa-Contracts-Discounts-DiscountServiceInterface.html) | Dispatched before a discount is created. |
+|[CreateDiscountEvent](/api/php_api/php_api_reference/classes/Ibexa-Contracts-Discounts-Event-CreateDiscountEvent.html)| [DiscountServiceInterface](/api/php_api/php_api_reference/classes/Ibexa-Contracts-Discounts-DiscountServiceInterface.html) | Dispatched after a discount is created. |
+|[BeforeDeleteDiscountEvent](/api/php_api/php_api_reference/classes/Ibexa-Contracts-Discounts-Event-BeforeDeleteDiscountEvent.html)| [DiscountServiceInterface](/api/php_api/php_api_reference/classes/Ibexa-Contracts-Discounts-DiscountServiceInterface.html) | Dispatched before a discount is deleted. |
+|[DeleteDiscountEvent](/api/php_api/php_api_reference/classes/Ibexa-Contracts-Discounts-Event-DeleteDiscountEvent.html)| [DiscountServiceInterface](/api/php_api/php_api_reference/classes/Ibexa-Contracts-Discounts-DiscountServiceInterface.html) | Dispatched after a discount is deleted. |
+|[BeforeUpdateDiscountEvent](/api/php_api/php_api_reference/classes/Ibexa-Contracts-Discounts-Event-BeforeUpdateDiscountEvent.html)| [DiscountServiceInterface](/api/php_api/php_api_reference/classes/Ibexa-Contracts-Discounts-DiscountServiceInterface.html)| Dispatched before a discount is updated. |
+|[UpdateDiscountEvent](/api/php_api/php_api_reference/classes/Ibexa-Contracts-Discounts-Event-UpdateDiscountEvent.html)| [DiscountServiceInterface](/api/php_api/php_api_reference/classes/Ibexa-Contracts-Discounts-DiscountServiceInterface.html) | Dispatched after a discount is updated. |
+|[OverridePrioritizationOnCreateEvent](TODO)| [DiscountServiceInterface](/api/php_api/php_api_reference/classes/Ibexa-Contracts-Discounts-DiscountServiceInterface.html)| Dispatched before a discount is created. Use it to set the `overridePrioritization` property to give a discount [higher priority](discounts_guide.md#discounts-priority). |
+|[OverridePrioritizationOnUpdateEvent](TODO)| [DiscountServiceInterface](/api/php_api/php_api_reference/classes/Ibexa-Contracts-Discounts-DiscountServiceInterface.html)| Dispatched before a discount is updated. Use it to set the `overridePrioritization` property to give a discount [higher priority](discounts_guide.md#discounts-priority). |
 
 ## Form events
 

docs/content_management/data_migration/importing_data.md

@@ -56,6 +56,7 @@ The following data migration step modes are available:
 | `currency`             | ✔ | ✔ | ✔ |          |
 | `customer_group`       | ✔ | ✔ | ✔ |          |
 | `discount`             | ✔ | ✔ |          |          |
+| `discount_code`        | ✔ |          |          |          |
 | `language`             | ✔ |          |          |          |
 | `location`             |          | ✔ |          | ✔ |
 | `object_state`         | ✔ |          |          |          |
@@ -525,6 +526,14 @@ The provided conditions overwrite any already existing ones.
 
 For a list of available conditions, see [Discounts API](discounts_api.md#conditions).
 
+### Discount codes [[% include 'snippets/lts-update_badge.md' %]]
+
+You can create a discount code as in the following example:
+
+``` yaml
+[[= include_file('code_samples/data_migration/examples/discounts/discount_code_create.yaml') =]]
+```
+
 ## Criteria
 
 When using `update` or `delete` modes, you can use criteria to identify the objects to operate on.

docs/discounts/discounts_guide.md

@@ -59,6 +59,7 @@ A shopping cart can have multiple active discounts, but a specific product can o
 
 When two or more discounts can be applied to a single product, the system evaluates the following properties to choose the right one:
 
+- discount code existence (discounts with discount codes have priority over the others)
 - discount activation place (cart discounts rank higher over catalog discounts)
 - discount priority (higher priority ranks higher)
 - discount creation date (newer discounts rank higher)
@@ -107,7 +108,8 @@ These conditions can include:
 
 For **cart discounts**, you can specify an additional text value that needs to be entered in the cart for the discount to apply.
 
-The discount code usage can be limited per customer:
+The discount code usage can be limited globally, for example by making the discount valid only for the first 10 customers using it before it expires.
+You can also limit the usage per customer:
 
 - single use: every customer can use this code only once
 - limited use: every customer can use the code a specified number of times

docs/release_notes/ibexa_dxp_v4.6.md

@@ -10,6 +10,44 @@ month_change: true
 
 <div class="release-notes" markdown="1">
 
+[[% set version = 'v4.6.22' %]]
+[[= release_note_entry_begin("Discounts " + version, 'TODO', ['LTS Update', 'Commerce']) =]]
+
+#### Global discount codes
+
+- You can now [limit the number of times](discounts_guide.md#discount-codes) a discount code can be used before it expires
+
+#### Discount codes prioritization
+
+- Discounts with discount codes now have priority over the other discounts
+
+#### Discount codes migrations
+
+- You can now create discount codes using [data migrations](importing_data.md#discount-codes).
+
+#### PHP API
+
+The PHP API has been enhanced with the following new classes:
+
+- TODO
+
+[[= release_note_entry_end() =]]
+[[= release_note_entry_begin("Ibexa DXP " + version, 'TODO', ['Headless', 'Experience', 'Commerce']) =]]
+
+#### TODO
+
+#### PHP API
+
+The PHP API has been enhanced with the following new classes:
+
+- TODO
+
+#### Full changelog
+[[% include 'snippets/release_46.md' %]]
+[[= release_note_entry_end() =]]
+
+
+
 [[% set version = 'v4.6.21' %]]
 
 [[= release_note_entry_begin("Discounts " + version, '2025-06-11', ['LTS Update', 'Commerce']) =]]

docs/search/discounts_search_reference/discounts_sort_clauses.md

@@ -15,6 +15,7 @@ Sort Clauses are found in the [`Ibexa\Contracts\Discounts\Value\Query\SortClause
 | [EndDate](/api/php_api/php_api_reference/classes/Ibexa-Contracts-Discounts-Value-Query-SortClause-EndDate.html)| Sort by discount's end date |
 | [Id](/api/php_api/php_api_reference/classes/Ibexa-Contracts-Discounts-Value-Query-SortClause-Id.html)| Sort by discount's database ID |
 | [Identifier](/api/php_api/php_api_reference/classes/Ibexa-Contracts-Discounts-Value-Query-SortClause-Identifier.html)| Sort by discount identifier |
+| [OverridePrioritization](TODO: PHP REF LINK) | Sort by the discount's `overridePrioritization` property. |
 | [Priority](/api/php_api/php_api_reference/classes/Ibexa-Contracts-Discounts-Value-Query-SortClause-Priority.html)| Sort by discount priority |
 | [StartDate](/api/php_api/php_api_reference/classes/Ibexa-Contracts-Discounts-Value-Query-SortClause-StartDate.html)| Sort by discount start date |
 | [Type](/api/php_api/php_api_reference/classes/Ibexa-Contracts-Discounts-Value-Query-SortClause-Type.html)| Sort by the place where the discount activates: catalog or cart. When sorting with ascending order, cart discounts are returned first. |

docs/update_and_migration/from_4.6/update_from_4.6.md

@@ -522,6 +522,28 @@ To use the [latest features](ibexa_dxp_v4.6.md) added to them, update them separ
                 REFERENCES ezuser (contentobject_id) ON UPDATE CASCADE ON DELETE CASCADE NOT DEFERRABLE INITIALLY IMMEDIATE;
         ```
 
+    ## 4.6.22
+
+    ### Database update
+
+    Run the following scripts:
+
+    === "MySQL"
+
+        ``` sql
+        ALTER TABLE ibexa_discount ADD override_prioritization tinyint(1) NOT NULL DEFAULT 0;
+        CREATE INDEX ibexa_discount_prioritization_idx ON ibexa_discount (override_prioritization, type, priority);
+        ALTER TABLE ibexa_discount_code ADD global_limit INT DEFAULT NULL;
+        ```
+
+    === "PostgreSQL"
+
+        ``` sql
+        ALTER TABLE ibexa_discount ADD override_prioritization tinyint(1) NOT NULL DEFAULT 0;
+        CREATE INDEX ibexa_discount_prioritization_idx ON ibexa_discount (override_prioritization, type, priority);
+        ALTER TABLE ibexa_discount_code ADD global_limit INT DEFAULT NULL;
+        ```
+
 === "AI actions"
 
     Run the following command to get the latest version: