IBX-9845: Solr9

code_samples/data_migration/examples/discounts/discount_code_create.yaml

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

code_samples/discounts/src/Command/ManageDiscountsCommand.php

@@ -1,3 +1,3 @@
 <?php
 
 declare(strict_types=1);
@@ -59,7 +59,8 @@
 
         $discountCodeCreateStruct = new DiscountCodeCreateStruct(
             'summer10',
-            null, // Unlimited usage
+            10, // Global usage limit
+            null, // Unlimited usage per customer
             $this->permissionResolver->getCurrentUserReference()->getUserId(),
             $now
         );
@@ -78,7 +79,11 @@
                 new IsInRegions(['germany', 'france']),
                 new IsProductInArray(['product-1', 'product-2']),
                 new IsInCurrency('EUR'),
-                new IsValidDiscountCode($discountCode->getCode(), $discountCode->getUsedLimit()),
+                new IsValidDiscountCode(
+                    $discountCode->getCode(),
+                    $discountCode->getGlobalLimit(),
+                    $discountCode->getUsedLimit()
+                ),
             ])
             ->setTranslations([
                 new DiscountTranslationStruct('eng-GB', 'Discount name', 'This is a discount description', 'Promotion Label', 'Promotion Description'),

docs/api/event_reference/discounts_events.md

@@ -15,12 +15,12 @@ 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)
+|[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)|
+|[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) |
 
 ## 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_api.md

@@ -113,9 +113,9 @@ The example below contains a Command creating a cart discount. The discount:
 - [depends](#conditions) on
     - being bought from Germany or France
     - 2 products
-    - a `summer10` [discount code](#discount-codes) which can be used unlimited number of times
+    - a `summer10` [discount code](#discount-codes) which can be used only 10 times, but a single customer can use the code multiple times
 
-``` php hl_lines="60-66 68-92"
+``` php hl_lines="60-67 69-97"
 [[= include_file('code_samples/discounts/src/Command/ManageDiscountsCommand.php') =]]
 ```
 

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 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/getting_started/requirements.md

@@ -125,6 +125,10 @@ For production setups it's recommended that you use Varnish/Fastly, Redis, NFS/E
 
 ## PHP
 
+=== "[[= product_name =]] v4.6"
+
+    - 8.3
+
 === "[[= product_name =]] v4.6"
 
     - 8.3
@@ -208,25 +212,54 @@ For production setups it's recommended that you use Varnish/Fastly, Redis, NFS/E
 
 === "[[= product_name =]] v5.0"
 
-    - For content search, Solr 8.11.1 or higher.
-    Alternatively, Elasticsearch 7.16.2 or higher 7.x version.
+    |Name|Version|
+    |---|---|
+    |Solr|8.11.1+ or 9.8.1+|
+    |Elasticsearch| 7.16.2+ |
+
+    If you see a "+" next to the product version, it indicates a recommended version or higher within the same major release.
+    For example, "1.18+" means any 1.x version equal to or higher than 1.18, but not 2.x.
 
 === "[[= product_name =]] v4.6"
 
-    - For content search, Solr 7.7 LTS or Solr 8, recommended 8.11.1 or higher.
-    Alternatively, Elasticsearch 7.16.2 or higher 7.x version.
-    - The above solutions require Oracle Java/Open JDK. The minimum requirement is 8 LTS, recommended 11 LTS.
-    Newer versions aren't supported.
+    |Name|Version|
+    |---|---|
+    |Solr|8.11.1+ or 9.8.1+|
+    |Elasticsearch| 7.16.2+ |
+
+    If you see a "+" next to the product version, it indicates a recommended version or higher within the same major release.
+    For example, "1.18+" means any 1.x version equal to or higher than 1.18, but not 2.x.
 
 === "[[= product_name =]] v3.3"
 
-    - For content search, Solr 7.7 LTS or Solr 8, recommended 8.11.1 or higher.
-    Alternatively, Elasticsearch 7.16.2 or higher 7.x version.
+    |Name|Version|
+    |---|---|
+    |Solr|7.7 LTS or 8.11.1+|
+    |Elasticsearch| 7.16.2+ |
+
+    If you see a "+" next to the product version, it indicates a recommended version or higher within the same major release.
+    For example, "1.18+" means any 1.x version equal to or higher than 1.18, but not 2.x.
+
     - For BinaryFile field indexing, Apache Tika 1.20 or higher 1.x version, recommended 1.28.1 or higher.
     - The above solutions require Oracle Java/Open JDK. The minimum requirement is 8 LTS, recommended 11 LTS. Newer versions aren't supported.
 
 ## Graphic Handler
 
+=== "[[= product_name =]] v5.0"
+
+    - GraphicsMagick
+    - ImageMagick
+    - GD
+
+    Optionally if you intend to edit [PNG, SVG, GIF or WEBP files in the Image Editor](images.md#image-optimization), or use it with image variations:
+
+    - JpegOptim
+    - Optipng
+    - Pngquant 2
+    - SVGO 1
+    - Gifsicle
+    - cwebp
+
 === "[[= product_name =]] v4.6"
 
     - GraphicsMagick
@@ -288,6 +321,10 @@ For production setups it's recommended that you use Varnish/Fastly, Redis, NFS/E
 
 ## Filesystem
 
+=== "[[= product_name =]] v5.0"
+
+    - Linux ext4 / XFS
+
 === "[[= product_name =]] v4.6"
 
     - Linux ext4 / XFS
@@ -339,6 +376,16 @@ For production setups it's recommended that you use Varnish/Fastly, Redis, NFS/E
 
 ## Browser
 
+=== "[[= product_name =]] v5.0"
+
+    [[= product_name =]] is developed to work with *any* web browser that supports modern standards, on *any* screen resolution suitable for web, running on *any* device.
+    However for the Editorial and Administration User Interfaces you need: a minimum of 1366-by-768 screen resolution, a desktop or tablet device, and a recommended/supported browser among the ones found below.
+
+    - Mozilla® Firefox® most recent stable version (recommended)
+    - Google Chrome™ most recent stable version (recommended)
+    - Chromium™ based browsers such as Microsoft® Edge® and Opera®, most recent stable version, desktop *and* tablet
+    - Apple® Safari® most recent stable version, desktop *and* tablet
+
 === "[[= product_name =]] v4.6"
 
     [[= product_name =]] is developed to work with *any* web browser that supports modern standards, on *any* screen resolution suitable for web, running on *any* device.

docs/release_notes/ibexa_dxp_v4.6.md

@@ -10,6 +10,47 @@ 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 limits
+
+- You can now [limit the number of times](discounts_guide.md#discount-codes) a discount code can be used before it expires. The discounts created before this release are set to unlimited global usage
+
+#### 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']) =]]
+
+#### Support for Solr 9
+
+This release comes with support for [Solr 9](https://nightlies.apache.org/solr/draft-guides/solr-reference-guide-antora/solr/10_0/upgrade-notes/major-changes-in-solr-9.html).
+
+Solr 9 comes with support for [Dense Vector Search](https://solr.apache.org/guide/solr/latest/query-guide/dense-vector-search.html), paving the way for incoming improvements to [AI Actions](ai_actions.md) in [[= product_name =]].
+
+#### 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']) =]]