Merge remote-tracking branch 'origin/release-4.6.22' into update-4.6.22

Author: mnocon

code_samples/back_office/components/twig_components.yaml

@@ -1,34 +1,24 @@
 ibexa_twig_components:
     admin-ui-user-menu:
-        custom-html-component:
-            type: html
-            arguments:
-                content: '<b>Hello world!</b>'
-        custom-template-component:
-            type: template
-            arguments:
-                template: '@ibexadesign/ui/component/user_thumbnail/user_thumbnail.html.twig'
-                parameters:
-                    user_content:
-                        name: "Thumbnail"
-                        thumbnail:
-                            resource: https://placecats.com/100/100
         custom-controller-component:
             type: controller
             arguments:
                 controller: '\App\Controller\MyController::requestAction'
                 parameters:
                     parameter1: 'custom'
                     parameter2: true
-    admin-ui-stylesheet-head:
-        custom-link-component:
-            type: stylesheet
+        custom-html-component:
+            type: html
+            priority: 0
             arguments:
-                href: 'https://fonts.googleapis.com/css?family=Roboto:300,300i,400,400i,700,700i%7CRoboto+Mono:400,400i,700,700i&amp;display=fallback'
-                rel: stylesheet
-                crossorigin: anonymous
-                integrity: sha384-LN/mLhO/GN6Ge8ZPvI7uRsZpiXmtSkep+aFlJcHa8by4TvA34o1am9sa88eUzKTD
-                type: text/css
+                content: '<b>Hello world!</b>'
+    admin-ui-user-menu:
+        duplicated_user_menu:
+            type: menu
+            arguments:
+                name: ezplatform_admin_ui.menu.user
+                template: '@ibexadesign/ui/menu/user.html.twig'
+                depth: 1
     admin-ui-script-head:
         custom-script-component:
             type: script
@@ -39,3 +29,23 @@ ibexa_twig_components:
                 async: true
                 integrity: sha384-Ewi2bBDtPbbu4/+fs8sIbBJ3zVl0LDOSznfhFR/JBK+SzggdRdX8XQKauWmI9HH2
                 type: text/javascript
+    admin-ui-stylesheet-head:
+        custom-link-component:
+            type: stylesheet
+            arguments:
+                href: 'https://fonts.googleapis.com/css?family=Roboto:300,300i,400,400i,700,700i%7CRoboto+Mono:400,400i,700,700i&amp;display=fallback'
+                rel: stylesheet
+                crossorigin: anonymous
+                integrity: sha384-LN/mLhO/GN6Ge8ZPvI7uRsZpiXmtSkep+aFlJcHa8by4TvA34o1am9sa88eUzKTD
+                type: text/css
+    admin-ui-global-search:
+        custom-template-component:
+            type: template
+            priority: 50
+            arguments:
+                template: '@ibexadesign/ui/component/user_thumbnail/user_thumbnail.html.twig'
+                parameters:
+                    user_content:
+                        name: "Thumbnail"
+                        thumbnail:
+                            resource: https://placecats.com/100/100

code_samples/data_migration/examples/delete_content.yaml

@@ -0,0 +1,8 @@
+-
+    type: content
+    mode: delete
+    match:
+        field: content_remote_id
+        value: __REMOTE_ID__
+        only_visible_content: true # Optional, default: true. If set to true, only visible content will be deleted. 
+    allow_no_delete: false # Optional, default: false. If set to true, the migration will not fail if no content is found using the specified criteria.

docs/administration/back_office/back_office_elements/custom_components.md

@@ -47,6 +47,7 @@ The available groups for the back office are:
 |`admin-ui-systeminfo-tab-groups`| `vendor/ibexa/system-info/src/bundle/Resources/views/themes/admin/system_info/info.html.twig` |
 |`admin-ui-user-menu`| `vendor/ibexa/admin-ui-ui/src/bundle/Resources/views/themes/admin/ui/layout.html.twig` |
 |`admin-ui-user-profile-blocks`| `vendor/ibexa/admin-ui/src/bundle/Resources/views/themes/admin/account/profile/view.html.twig` |
+|`admin-ui-versions-table-before`|`vendor/ibexa/admin-ui/src/bundle/Resources/views/themes/admin/content/tab/versions/table.html.twig`|
 
 For more information, see [this example using few of those components](components.md#example).
 

docs/content_management/data_migration/importing_data.md

@@ -243,6 +243,12 @@ In this case you assign the `parent_folder_location_id` reference name to the lo
 [[= include_file('code_samples/data_migration/examples/create_parent_and_child_content.yaml') =]]
 ```
 
+Use the `delete` mode to delete content items:
+
+``` yaml
+[[= include_file('code_samples/data_migration/examples/delete_content.yaml') =]]
+```
+
 ### Images
 
 The following example shows how to migrate an `example-image.png` located in `public/var/site/storage/images/3/8/3/0/383-1-eng-GB` without manually placing it in the appropriate path.

docs/infrastructure_and_maintenance/performance.md

@@ -52,6 +52,17 @@ In production setups:
 - Always enable opcache for php-fpm/`mod_php`.
 - Prefer php-fpm and web server using it over fast-cgi for lower overall memory usage.
 
+!!! caution
+
+    To avoid deprecations when using PHP 8.2 or 8.3, [[= product_name =]] v4.6 needs an additional error handler.
+    The error handler is present by default for projects that started with 4.6.8 or later.
+    For projects that started with earlier versions, you need to add the error handler manually by running the following commands:
+
+    ``` bash
+    composer config extra.runtime.error_handler "\\Ibexa\\Contracts\\Core\\MVC\\Symfony\\ErrorHandler\\Php82HideDeprecationsErrorHandler"
+    composer dump-autoload
+    ```
+
 ### Symfony
 
 - Review the [Symfony performance documentation]([[= symfony_doc =]]/performance.html) and apply matching suggestions, including OPCache configuration if enabled.

docs/js/custom.js

@@ -2,6 +2,8 @@
 let jquery = jQuery;
 
 $(document).ready(function() {
+    const latestVersionNumber = '5.0';
+
     // replace edit url
     let branchName = 'master';
     const branchNameRegexp = /\/en\/([a-z0-9-_.]*)\//g.exec(document.location.href);
@@ -76,6 +78,14 @@ $(document).ready(function() {
             const allVersions = [...document.querySelectorAll('.switcher__list .versions dd')];
             const olderVersions = document.querySelector('#older-versions');
 
+            // Merge "X.Y" and "latest" entries into "X.Y (latest)"
+            const latestVersion = allVersions.find(v => v.textContent.trim() === 'latest');
+            const versionXY = allVersions.find(v => v.textContent.trim() === latestVersionNumber);
+            
+            const versionXYLink = versionXY.querySelector('a');
+            versionXYLink.textContent = `${latestVersionNumber} (latest)`;
+            latestVersion.remove();
+
             if (eolVersions.length > 0) {
                 olderVersions.hidden = false;
             }

docs/release_notes/ibexa_dxp_v5.0_deprecations.md

@@ -459,7 +459,7 @@ Support for facets in `ibexa/elasticsearch` has been dropped, use the `Aggregati
 | `\Ibexa\Rest\Server\Controller\User::refreshSession` | `\Ibexa\Rest\Server\Controller\SessionController::refreshSessionAction` |
 | `\Ibexa\Rest\Server\Controller\User::deleteSession` | `\Ibexa\Rest\Server\Controller\SessionController::refreshSessionAction` |
 
-### ibexa/ibexa/scheduler
+### ibexa/scheduler
 
 | Old FQN                                              | New FQN / Comment                                                                |
 |:------------------------------------------------------|:------------------------------------------------------------------------|
@@ -651,6 +651,13 @@ The following service definitions have been removed:
 | `ibexa.site_access.config.default.user_registration.group_id` | `ibexa.site_access.config.default.user_registration.group_remote_id` |
 | `ezpublish_http_basic` | Use `http_basic` in `security.yml` directly. |
 
+## Session prefix
+
+The default prefix used for [SiteAccess sessions](sessions.md) has been renamed.
+
+| Old prefix | New prefix |
+|:----|:----|
+| `eZSESSID` | `IBX_SESSION_ID` |
 
 ## CSS settings
 

docs/templating/components.md

@@ -8,9 +8,12 @@ month_change: true
 Twig Components are widgets (for example, **My dashboard** blocks from Headless edition) and HTML code (for example, a tag for loading JS or CSS files) that you can inject into the existing templates to customize and extend the user interface.
 They are combined into groups that are rendered in designated templates.
 
-Built-in Twig Component groups are available for the [back office](custom_components.md), but you can create your own for use anywhere.
+Twig Component groups are available for:
 
-To learn which groups are available in a given view, use the [integration with Symfony Profiler](#symfony-profiler-integration).
+- [back office](custom_components.md)
+- [storefront](customize_storefront_layout.md)
+
+To learn which groups are available in a given view, use the [integration Symfony Profiler](#symfony-profiler-integration).
 
 ## Create Twig Component
 
@@ -44,23 +47,38 @@ ibexa_twig_components:
         # Component name
         google_tag_manager:
             type: script
+            priority: 50
             arguments:
                 src: 'https://...'
 ```
 
-The Component priority cannot be specified when using the YAML configuration, but it allows you to use the built-in components to quickly achieve common goals.
+YAML configuration allows you to use the built-in components to quickly achieve common goals.
 
 You can use an unique group name when creating a Twig Component to create your own group.
 
 ## Built-in components
 
 | Name | Description | YAML type |
 |---|---|---|
+| [Controller](https://github.com/ibexa/twig-components/blob/main/src/lib/Component/ControllerComponent.php) | Renders a Symfony controller |`controller` |
+| [HTML](https://github.com/ibexa/twig-components/blob/main/src/lib/Component/HtmlComponent.php) | Renders static HTML |`html` |
+| [Menu](https://github.com/ibexa/twig-components/blob/main/src/lib/Component/MenuComponent.php) | Renders a [menu](https://symfony.com/bundles/KnpMenuBundle/current/index.html) |`menu` |
 | [Script](https://github.com/ibexa/twig-components/blob/main/src/lib/Component/ScriptComponent.php) | Renders a [`<script>` tag](https://developer.mozilla.org/en-US/docs/Web/HTML/Reference/Elements/script) | `script` |
 | [Stylesheet](https://github.com/ibexa/twig-components/blob/main/src/lib/Component/LinkComponent.php) | Renders a [`<link>` tag](https://developer.mozilla.org/en-US/docs/Web/HTML/Reference/Elements/link) | `stylesheet`
 | [Template](https://github.com/ibexa/twig-components/blob/main/src/lib/Component/TemplateComponent.php) | Renders a Twig template|`template` |
-| [Controller](https://github.com/ibexa/twig-components/blob/main/src/lib/Component/ControllerComponent.php) | Renders a Symfony controller |`controller` |
-| [HTML](https://github.com/ibexa/twig-components/blob/main/src/lib/Component/HtmlComponent.php) | Renders static HTML |`html` |
+
+For the menu component, the following properties are available:
+
+| parameter | type                 | required | description                    |
+|-----------|----------------------|----------|--------------------------------|
+| name      | string               | yes      | Menu name                      |
+| options   | array<string, mixed> | no       | Options passed to menu builder |
+| path      | string[]             | no       | Path to starting node          |
+| template  | string               | no       | Template used to render menu   |
+| depth     | int                  | no       | Menu depth limit               |
+
+The menu component, same as [back office menus](back_office_menus.md), relies on the [KnpMenuBundle](https://symfony.com/bundles/KnpMenuBundle/current/index.html).
+For more information about the available properties, refer to the [official documentation of the bundle](https://symfony.com/bundles/KnpMenuBundle/current/index.html#create-your-first-menu).
 
 ## Example
 

docs/templating/layout/customize_storefront_layout.md

@@ -11,6 +11,24 @@ To customize your shop, you can override either whole templates, or specific com
 The built-in templates belong to the `storefront` [theme](design_engine.md).
 To override any of them, copy its directory structure in your template directory.
 
+## Customize with Twig Components
+
+You can customize parts of the storefront by using [Twig components](components.md).
+It allows you to inject your own widgets, extending the storefront behavior.
+
+The available groups for the storefront are:
+
+| Group name | Template file |
+|---|---|
+| `storefront-before-maincart` | `vendor/ibexa/storefront/src/bundle/Resources/views/themes/storefront/cart/component/maincart/maincart.html.twig` |
+| `storefront-after-maincart` | `vendor/ibexa/storefront/src/bundle/Resources/views/themes/storefront/cart/component/maincart/maincart.html.twig` |
+| `storefront-before-minicart` | `vendor/ibexa/storefront/src/bundle/Resources/views/themes/storefront/cart/component/minicart/minicart.html.twig` |
+| `storefront-after-minicart` | `vendor/ibexa/storefront/src/bundle/Resources/views/themes/storefront/cart/component/minicart/minicart.html.twig` |
+| `storefront-before-add-to-cart` | `vendor/ibexa/storefront/src/bundle/Resources/views/themes/storefront/cart/component/add_to_cart/add_to_cart.html.twig` |
+| `storefront-after-add-to-cart` | `vendor/ibexa/storefront/src/bundle/Resources/views/themes/storefront/cart/component/add_to_cart/add_to_cart.html.twig` |
+| `storefront-before-summary` | `vendor/ibexa/storefront/src/bundle/Resources/views/themes/storefront/cart/component/summary/summary.html.twig` |
+| `storefront-after-summary` | `vendor/ibexa/storefront/src/bundle/Resources/views/themes/storefront/cart/component/summary/summary.html.twig` |
+
 ## Template customization example
 
 As an example, to change the cart display when it contains no products, you need to override `vendor/ibexa/storefront/src/bundle/Resources/views/themes/storefront/cart/component/maincart/maincart_empty_cart.html.twig` template.