Release 4.6.27 (#3035)

mnocon · adriendupuis · dabrt · mnocon · commit ec69366a518b · 2026-02-03T14:58:55.000+01:00
* Removed warning about Safari (#2982) * 4.6.27: Update doc for dropped unused guzzle dependencies (#2995) * Added update section for 4.6.27 * Update docs/update_and_migration/from_4.6/update_from_4.6.md * Described virtual products and added an example creating product type with PHP API (#3024) * Described virtual products and added an example creating product type with PHP API * Apply suggestions from code review Co-authored-by: Adrien Dupuis <61695653+adriendupuis@users.noreply.github.com> * Fixed invalid include * Apply suggestions from code review Co-authored-by: Adrien Dupuis <61695653+adriendupuis@users.noreply.github.com> Co-authored-by: Tomasz Dąbrowski <64841871+dabrt@users.noreply.github.com> * Added link to user doc --------- Co-authored-by: Adrien Dupuis <61695653+adriendupuis@users.noreply.github.com> Co-authored-by: Tomasz Dąbrowski <64841871+dabrt@users.noreply.github.com> * [4.6] Doc for Elasticsearch 8 (#3022) * Added doc for ES8 * Added update guide mention * Fixed header * Formatting fixes * Apply suggestions from code review Co-authored-by: Konrad Oboza <konrad.oboza@ibexa.co> * Apply suggestions from code review Co-authored-by: Tomasz Dąbrowski <64841871+dabrt@users.noreply.github.com> * Manual changes --------- Co-authored-by: Konrad Oboza <konrad.oboza@ibexa.co> Co-authored-by: Tomasz Dąbrowski <64841871+dabrt@users.noreply.github.com> --------- Co-authored-by: Adrien Dupuis <61695653+adriendupuis@users.noreply.github.com> Co-authored-by: Tomasz Dąbrowski <64841871+dabrt@users.noreply.github.com> Co-authored-by: Konrad Oboza <konrad.oboza@ibexa.co>
diff --git a/docs/getting_started/requirements.md b/docs/getting_started/requirements.md
@@ -225,7 +225,7 @@ For production setups it's recommended that you use Varnish/Fastly, Redis/Valkey
     |Name|Version|
     |---|---|
     |Solr|7.7+, 8.11.1+ or 9.8.1+|
-    |Elasticsearch| 7.16.2+ |
+    |Elasticsearch| 7.16.2+ or 8.19+ |
 
     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.
diff --git a/docs/pim/pim_guide.md b/docs/pim/pim_guide.md
@@ -79,6 +79,17 @@ Before you can assign categories to products, you need to [enable product catego
 
 ![Product categories](img/product_categories.png)
 
+### Virtual and physical products
+
+Product types in [[= product_name =]] can be either virtual or physical:
+
+- **Physical products** are tangible items that require shipping (for example: books, clothing, electronics).
+- **Virtual products** are items that don't require physical delivery (for example: software licenses, e-books, online courses, digital downloads, additional warranty, tickets for an event).
+
+This product type property can affect the checkout process.
+A cart of only virtual products skips the [shipping step](shipping_management.md) during checkout.
+To learn more about working with virtual products, see [Virtual products]([[= user_doc =]]/pim/create_virtual_product/) in the User Documentation.
+
 ### Currencies
 
 Currencies are used when calculating product price. In the system you can find a list of available currencies, but you can also create custom ones by providing its code.
diff --git a/docs/search/search_engines/elasticsearch/configure_elasticsearch.md b/docs/search/search_engines/elasticsearch/configure_elasticsearch.md
@@ -256,7 +256,7 @@ ibexa_elasticsearch:
                 credentials: ['VnVhQ2ZHY0JDZGJrUW0tZTVhT3g6dWkybHAyYXhUTm1zeWFrdzl0dk5udw==']
 ```
 
-Refer to the [examples in Elasticsearch documentation](https://www.elastic.co/guide/en/elasticsearch/reference/8.19/security-api-create-api-key.html#security-api-create-api-key-example) to see the difference between API key, API key id, and encoded API key.
+To see the difference between API key, API key id, and encoded API key, refer to the [examples in Elasticsearch documentation](https://www.elastic.co/guide/en/elasticsearch/reference/8.19/security-api-create-api-key.html#security-api-create-api-key-example).
 
 ### SSL
 
@@ -313,7 +313,8 @@ For more information, see [Elasticsearch: SSL Encryption](https://www.elastic.co
 In a staging environment, you can log messages about the status of communication with Elasticsearch.
 You can then use Symfony Profiler to review the logs.
 
-By default, debugging is disabled. To enable debugging, you can use the following setting:
+By default, debugging is disabled.
+To enable debugging, you can use the following setting:
 
 ``` yaml
 <connection_name>:
@@ -412,8 +413,8 @@ For more information and a list of available settings, see [Elasticsearch docume
 For more information about mappings, see [Elasticsearch documentation](https://www.elastic.co/guide/en/elasticsearch/reference/8.19/mapping.html).
 
     When you create a custom index template, with settings for your own field and document types, make sure that it contains mappings for all searchable fields that are available in [[= product_name =]].
-    For an example of default configuration with a list of searchable fields.
-    To see the default configuration, go to `vendor/ibexa/elasticsearch/src/bundle/Resources/config/` and open the `default-config.yaml` file.
+
+To see the default configuration, go to `vendor/ibexa/elasticsearch/src/bundle/Resources/config/` and open the `default-config.yaml` file.
 
 ### Fine-tune the search results
 
@@ -506,7 +507,7 @@ For more information about specifying the pattern for your language, see [Define
 
 For information about configuring an analyzer for each specific language, see [Elasticsearch documentation](https://www.elastic.co/guide/en/elasticsearch/reference/8.19/analysis-lang-analyzer.html).
 
-An adoption of the [English analyzer](https://www.elastic.co/guide/en/elasticsearch/reference/8.19/analysis-lang-analyzer.html#english-analyzer) in [[= product_name =]] configuration looks like this:
+An adoption of the [`english` analyzer](https://www.elastic.co/guide/en/elasticsearch/reference/8.19/analysis-lang-analyzer.html#english-analyzer) in [[= product_name =]] configuration looks like this:
 
 ```yaml hl_lines="3-5 15-23 35 41-52 94 99"
 [[= include_file('code_samples/search/custom/config/packages/elasticsearch-en.yaml') =]]
diff --git a/docs/search/search_engines/elasticsearch/install_elasticsearch.md b/docs/search/search_engines/elasticsearch/install_elasticsearch.md
@@ -20,7 +20,7 @@ docker run -d --name ibexa-dxp-elasticsearch -p 9200:9200 -p 9300:9300 -e "disco
 
 ## Verify the instance
 
-To make sure that the Elasticsearch instance operates properly, access the instance (for example, with `curl http://localhost:9200/`).
+To make sure that the Elasticsearch instance operates properly, access the instance, for example, with `curl http://localhost:9200/`.
 
 If Elasticsearch operates properly, an object with cluster details is displayed.
 It should be similar to the following example:
@@ -92,4 +92,4 @@ php bin/console ibexa:reindex
 !!! caution "Risks of premature indexing"
 
     Don't reindex your data before you create index templates.
-    Otherwise Elasticsearch attempts to use its [dynamic field mapping](https://www.elastic.co/guide/en/elasticsearch/reference/8.19/dynamic-field-mapping.html) feature to create type mappings automatically.
+    Otherwise, Elasticsearch attempts to use its [dynamic field mapping](https://www.elastic.co/guide/en/elasticsearch/reference/8.19/dynamic-field-mapping.html) feature to create type mappings automatically.
diff --git a/docs/update_and_migration/from_4.6/update_from_4.6.md b/docs/update_and_migration/from_4.6/update_from_4.6.md
@@ -452,6 +452,120 @@ Run the provided SQL upgrade script to add the missing indexes to your database:
 
 No additional steps needed.
 
+## v4.6.27
+
+### Elasticsearch 8 support
+
+As of v4.6.27, [[= product_name =]] adds optional support for Elasticsearch 8.19 or higher through the new `ibexa/elasticsearch8` package.
+
+By default, [[= product_name =]] continues to support Elasticsearch 7.16.2+ with the `ibexa/elasticsearch` package.
+To use Elasticsearch 8, follow these steps:
+
+#### Install Elasticsearch 8 package
+
+Replace the existing Elasticsearch package and install Elasticsearch 8:
+
+```bash
+composer require ibexa/elasticsearch8:[[= latest_tag_4_6 =]]
+```
+
+#### Update Elasticsearch server
+
+Upgrade your Elasticsearch server to version 8.19 or higher.
+For detailed instructions, follow the [Elasticsearch upgrade guide](https://www.elastic.co/guide/en/elastic-stack/8.19/upgrading-elastic-stack.html#prepare-to-upgrade).
+
+When you use [[= product_name_cloud =]], see [Elasticsearch service](https://docs.upsun.com/add-services/elasticsearch.html) for a list of supported versions.
+
+#### Update configuration
+
+Update your configuration in `config/packages/ibexa_elasticsearch.yaml` as decribed below:
+
+##### Replace connection pool settings
+
+The `connection_pool` and `connection_selector` settings are ignored when using Elasticsearch 8.
+Replace them with appropriate `node_pool_selector` and `node_pool_resurrect` settings:
+
+``` yaml
+# Elasticsearch 7 configuration
+ibexa_elasticsearch:
+    connections:
+        default:
+            connection_pool: 'Elasticsearch\ConnectionPool\StaticNoPingConnectionPool'
+            connection_selector: 'Elasticsearch\ConnectionPool\Selectors\RoundRobinSelector'
+```
+
+``` yaml
+# Elasticsearch 8 configuration
+ibexa_elasticsearch:
+    connections:
+        default:
+            node_pool_selector: 'Elastic\Transport\NodePool\Selector\RoundRobin'
+            node_pool_resurrect: 'Elastic\Transport\NodePool\Resurrect\NoResurrect'
+```
+
+For more information, see [Connection pool and node pool settings](configure_elasticsearch.md#connection-pool-and-node-pool-settings).
+
+##### Remove trace option
+
+The `trace` debugging option is no longer available in Elasticsearch 8:
+
+``` yaml
+# Elasticsearch 7 configuration
+ibexa_elasticsearch:
+    connections:
+        default:
+            debug: true
+            trace: true
+```
+
+``` yaml
+# Elasticsearch 8 configuration
+ibexa_elasticsearch:
+    connections:
+        default:
+            debug: true
+            # Trace option is no longer available
+```
+
+#### Reindex content
+
+After upgrading to Elasticsearch 8 and updating your configuration, reindex the search engine:
+
+1. Push the index templates:
+
+    ``` bash
+    php bin/console ibexa:elasticsearch:put-index-template --overwrite
+    ```
+
+2. Reindex your content:
+
+    ``` bash
+    php bin/console ibexa:reindex
+    ```
+
+### Removed Composer dependencies
+
+The following unused Composer dependencies have been removed from `ibexa/core`:
+
+- `guzzlehttp/guzzle`
+- `php-http/guzzle6-adapter`
+
+If your project uses Guzzle directly, you should add these dependencies to your project's `composer.json` file.
+
+To check if you need to add these dependencies, run:
+
+```bash
+composer why guzzlehttp/guzzle
+composer why php-http/guzzle6-adapter
+```
+
+If only the `ibexa/core` entry appears in the output, check your codebase to determine if you use Guzzle directly.
+If you do, add the required dependencies to your project:
+
+```bash
+composer require guzzlehttp/guzzle:^6.5 php-http/guzzle6-adapter:^2.0
+```
+
 <!-- End of update instructions -->
 
 [[% include 'snippets/update/notify_support.md' %]]
diff --git a/docs/update_and_migration/from_4.6/update_to_5.0.md b/docs/update_and_migration/from_4.6/update_to_5.0.md
@@ -206,6 +206,17 @@ composer remove --no-update \
 ;
 ```
 
+#### Remove separate Elasticsearch 8 package
+
+If you were using the separate `ibexa/elasticsearch8` package in v4.6, you should switch back to the built-in `ibexa/elasticsearch` package, as it now supports both Elasticsearch 7 and Elasticsearch 8.
+
+```bash
+composer remove --no-update ibexa/elasticsearch8
+```
+
+The `ibexa/elasticsearch` package is automatically installed as part of your [[= product_name =]] 5.0 update.
+Your existing Elasticsearch 8 server and configuration continue to work with the `ibexa/elasticsearch` package.
+
 #### Remove PHP 8.2 error handler
 
 If you were using the [`Php82HideDeprecationsErrorHandler`](update_from_4.6.md#v468) to avoid deprecation messages,
diff --git a/docs/update_and_migration/from_5.0/update_from_5.0.md b/docs/update_and_migration/from_5.0/update_from_5.0.md
@@ -194,9 +194,9 @@ If you choose to upgrade to Elasticsearch 8, follow these steps:
 #### Update Elasticsearch server
 
 Upgrade your Elasticsearch server to version 8.19 or higher.
-Follow the [Elasticsearch upgrade guide](https://www.elastic.co/guide/en/elastic-stack/8.19/upgrading-elastic-stack.html#prepare-to-upgrade) for detailed instructions.
+For detailed instructions, follow the [Elasticsearch upgrade guide](https://www.elastic.co/guide/en/elastic-stack/8.19/upgrading-elastic-stack.html#prepare-to-upgrade).
 
-When using [[= product_name_cloud =]], see [Elasticsearch service](https://docs.upsun.com/add-services/elasticsearch.html) for a list of supported versions.
+When you use [[= product_name_cloud =]], see [Elasticsearch service](https://docs.upsun.com/add-services/elasticsearch.html) for a list of supported versions.
 
 #### Update configuration
 
