Skip to content

Commit 255e84f

Browse files
adriendupuisdabrtjulitafalconduszamnocon
authored
Release notes for v5.0.7 and v4.6.29 (#3133)
* Init next release notes w/ postponed * mkdocs.yml: Increment latest_tag_* * Symfony 7.4 #3098 * Apply suggestion from @adriendupuis * Revert "Apply suggestion from @adriendupuis" This reverts commit 519103f. * ibexa_dxp_v5.0.md: Raptor connector LTS Update * ibexa_dxp_v5.0.md: Raptor connector LTS Update (Format) * Apply suggestion from vale * Apply suggestions from @julitafalcondusza Co-authored-by: Adrien Dupuis <61695653+adriendupuis@users.noreply.github.com> * ibexa_dxp_v5.0.md: translation components, AI in PB * ibexa_dxp_v5.0.md: Narrowed link for Raptor connector * ibexa_dxp_v5.0.md: Sort editions and add Quable * ibexa_dxp_vX.Y.md: Taxonomy search criteria * ibexa_dxp_v4.6.md: Taxonomy search criteria: fix links * Comment include 'snippets/release_XY.md' * Use absolute links in snippets/release_XY.md * Add Quable to ibexa_dxp_v4.6.md * Add Integrated help's Product tour * Raptor connector isn't an LTS Update * Raptor connector isn't an LTS Update * Quable is an add-on * ibexa_dxp_v5.0.md: REST API request body examples * ibexa_dxp_v5.0.md: PHP API * ibexa_dxp_v5.0.md: PHP API * Quable PIM isn't for Commerce * Move Quable PIM up, rm badges * ibexa_dxp_v5.0.md: Fix link * Quable isn't for 4.6 * Add PHP API draft to release notes * Apply suggestion from @dabrt * remove blur, set versions and date * uncomment include_file * Apply suggestions from code review Co-authored-by: julitafalcondusza <117284672+julitafalcondusza@users.noreply.github.com> * resync ibexa_dxp_v5.0.md and ibexa_dxp_v4.6.md * Apply suggestions from code review Co-authored-by: Marek Nocoń <mnocon@users.noreply.github.com> * resync ibexa_dxp_v5.0.md and ibexa_dxp_v4.6.md * Move AI Actions in blocks upper * TaxonomySubtree isn't new to these release * Update the next release date --------- Co-authored-by: Tomasz Dąbrowski <64841871+dabrt@users.noreply.github.com> Co-authored-by: julitafalcondusza <117284672+julitafalcondusza@users.noreply.github.com> Co-authored-by: Marek Nocoń <mnocon@users.noreply.github.com>
1 parent b6b31f9 commit 255e84f

5 files changed

Lines changed: 235 additions & 4 deletions

File tree

docs/release_notes/ibexa_dxp_v4.6.md

Lines changed: 72 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -10,6 +10,78 @@ month_change: true
1010

1111
<div class="release-notes" markdown="1">
1212

13+
[[% set version = 'v4.6.29' %]]
14+
15+
[[= release_note_entry_begin(
16+
"Integrated help " + version,
17+
'2026-04-20',
18+
['Headless', 'Experience', 'Commerce', 'LTS Update', 'New feature']
19+
) =]]
20+
21+
### Product tour
22+
23+
The product tour is a new Integrated help feature that helps back office contributors to discover [[= product_name =]].
24+
25+
With product tours, you can create customized onboarding journeys.
26+
This accelerates user adoption, reduces training time, and helps users confidently navigate the platform.
27+
28+
For more information, see [Product tour](https://doc.ibexa.co/en/4.6/administration/back_office/product_tour/).
29+
30+
[[= release_note_entry_end() =]]
31+
32+
[[= release_note_entry_begin(
33+
"Ibexa DXP " + version,
34+
'2026-04-20',
35+
['Headless', 'Experience', 'Commerce', 'New feature']
36+
) =]]
37+
38+
### Developer experience
39+
40+
#### Taxonomy search
41+
42+
One [taxonomy search](https://doc.ibexa.co/en/4.6/content_management/taxonomy/taxonomy_api/search) criterion is added:
43+
44+
- [`TaxonomyNoEntries`](https://doc.ibexa.co/en/4.6/search/criteria_reference/taxonomy_no_entries/) to find content items to which no taxonomy entries have been assigned.
45+
46+
#### Custom parameters in `ibexa_render()`
47+
48+
You can now pass custom parameters to templates when using the `ibexa_render()` Twig function with the new `params` option, similar to how you can with `render(controller())`.
49+
50+
This allows you to provide additional context or data to your view templates:
51+
52+
``` html+twig
53+
{{ ibexa_render(content, {
54+
'viewType': 'line',
55+
'method': 'inline',
56+
'params': {
57+
'custom_param': 'custom_value',
58+
'another_param': 'another_value'
59+
}
60+
}) }}
61+
```
62+
63+
The parameters are available in your template as regular variables.
64+
65+
For more information, see [`ibexa_render()` Twig function](https://doc.ibexa.co/en/4.6/templating/twig_function_reference/content_twig_functions/#ibexa_render).
66+
67+
#### PHP API
68+
69+
The following additions were made to the PHP API:
70+
71+
- [`Ibexa\Contracts\Core\FieldType\ReferenceAwareExternalStorage`](https://doc.ibexa.co/en/4.6/api/php_api/php_api_reference/classes/Ibexa-Contracts-Core-FieldType-ReferenceAwareExternalStorage.html)
72+
- [`Ibexa\Contracts\Core\Options\Context`](https://doc.ibexa.co/en/4.6/api/php_api/php_api_reference/classes/Ibexa-Contracts-Core-Options-Context.html)
73+
- [`Ibexa\Contracts\CorporateAccount\Order`](https://doc.ibexa.co/en/4.6/api/php_api/php_api_reference/namespaces/ibexa-contracts-corporateaccount-order.html)
74+
- [`Ibexa\Contracts\CorporateAccount\Order\OrderStatusLabelProviderInterface`](https://doc.ibexa.co/en/4.6/api/php_api/php_api_reference/classes/Ibexa-Contracts-CorporateAccount-Order-OrderStatusLabelProviderInterface.html)
75+
- [`Ibexa\Contracts\Taxonomy\Search\Query\Criterion\TaxonomyNoEntries`](https://doc.ibexa.co/en/4.6/api/php_api/php_api_reference/classes/Ibexa-Contracts-Taxonomy-Search-Query-Criterion-TaxonomyNoEntries.html)
76+
<br>For more information, see [search criteria reference entry](https://doc.ibexa.co/en/4.6/search/criteria_reference/taxonomy_no_entries/).
77+
- [`Ibexa\Contracts\IntegratedHelp` namespace](https://doc.ibexa.co/en/4.6/api/php_api/php_api_reference/namespaces/ibexa-contracts-integratedhelp.html) from the [Integrated help LTS-Update](https://doc.ibexa.co/en/4.6/administration/back_office/integrated_help/)
78+
79+
### Full changelog
80+
81+
[[% include 'snippets/release_46.md' %]]
82+
83+
[[= release_note_entry_end() =]]
84+
1385
[[% set version = 'v4.6.28' %]]
1486

1587
[[= release_note_entry_begin(

docs/release_notes/ibexa_dxp_v5.0.md

Lines changed: 159 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -10,6 +10,165 @@ month_change: true
1010

1111
<div class="release-notes" markdown="1">
1212

13+
[[% set version = 'v5.0.7' %]]
14+
15+
[[= release_note_entry_begin(
16+
"Google Gemini connector " + version,
17+
'2026-04-20',
18+
['Headless', 'Experience', 'Commerce', 'LTS Update', 'New feature', 'First release']
19+
) =]]
20+
21+
This release introduces a new AI connector that allows you to integrate [AI Actions](https://doc.ibexa.co/en/5.0/ai_actions/ai_actions/) with [Google Gemini](https://gemini.google/overview/#what-gemini-is).
22+
You can also use it as an alternative embeddings provider for the [taxonomy suggestions feature](taxonomy.md#taxonomy-suggestions).
23+
24+
For more information, see how to [install and configure the Google Gemini connector](https://doc.ibexa.co/en/5.0/ai_actions/configure_ai_actions/#install-google-gemini-connector).
25+
26+
[[= release_note_entry_end() =]]
27+
28+
[[= release_note_entry_begin(
29+
"Integrated help " + version,
30+
'2026-04-20',
31+
['Headless', 'Experience', 'Commerce', 'LTS Update', 'New feature']
32+
) =]]
33+
34+
### Product tour
35+
36+
The product tour is a new Integrated help feature that helps back office contributors to discover [[= product_name =]].
37+
38+
With product tours, you can create customized onboarding journeys.
39+
This accelerates user adoption, reduces training time, and helps users confidently navigate the platform.
40+
41+
For more information, see [Product tour](https://doc.ibexa.co/en/5.0/administration/back_office/product_tour/).
42+
43+
[[= release_note_entry_end() =]]
44+
45+
[[= release_note_entry_begin(
46+
"Ibexa DXP " + version,
47+
'2026-04-20',
48+
['Headless', 'Experience', 'Commerce', 'New feature']
49+
) =]]
50+
51+
### Raptor connector
52+
53+
The Raptor connector provides a seamless integration between [[= product_name =]] and [Raptor Recommendation Engine](https://www.raptorservices.com/website-recommendations/).
54+
55+
For more information, see [Raptor connector](https://doc.ibexa.co/en/5.0/cdp/raptor_integration/raptor_connector/).
56+
57+
#### Tracking
58+
59+
This add-on includes two Twig functions to ease tracking setting:
60+
61+
- `ibexa_tracking_script` to load the JavaScript tracking code, for more information, see [Tracking script](https://doc.ibexa.co/en/5.0/cdp/raptor_integration/tracking_script/)
62+
- `ibexa_tracking_track_event` to send tracking events from your pages, for more information, see [Tracking event function](https://doc.ibexa.co/en/5.0/cdp/raptor_integration/tracking_event_function/)
63+
64+
#### Recommendations blocks [[% include 'snippets/experience_badge.md' %]] [[% include 'snippets/commerce_badge.md' %]]
65+
66+
This add-on introduces a set of recommendation blocks available in the [Page Builder](https://doc.ibexa.co/en/5.0/content_management/pages/page_builder_guide/), designed to suggest relevant content or products to users, such as the most popular items or viewed by others.
67+
68+
For more information about Recommendation blocks in Page Builder, see the relevant [Developer Documentation](https://doc.ibexa.co/en/5.0/cdp/raptor_integration/pb_blocks/) and [User Documentation](https://doc.ibexa.co/projects/userguide/en/5.0/recommendations/raptor_integration/raptor_recommendation_blocks/).
69+
70+
### Quable PIM
71+
72+
The [[= pim_product_name =]] integration add-on allows you to connect [[= product_name =]] with [[[= pim_product_name =]] Product Information Management (PIM)](https://www.quable.com/en), making [[= pim_product_name =]] the authoritative source of product information for every website powered by [[= product_name =]].
73+
74+
[[= pim_product_name =]] can serve as the single source of truth for all product data, including attributes, classifications, variants, and translations.
75+
[[= product_name =]] consumes this data and makes it available for use in content and digital experiences.
76+
77+
For more information, see [Quable PIM Integration](https://doc.ibexa.co/en/5.0/product_catalog/quable/).
78+
79+
### AI Actions in Page Builder blocks [[% include 'snippets/experience_badge.md' %]] [[% include 'snippets/commerce_badge.md' %]]
80+
81+
You can now use the [refining text AI Actions](https://doc.ibexa.co/en/5.0/ai_actions/ai_actions_guide/#refining-text) in Page Builder blocks string and text inputs.
82+
83+
### Developer experience
84+
85+
#### Symfony 7.4
86+
87+
Symfony is upgraded from 7.3 to 7.4.
88+
It's the latest [LTS release](https://symfony.com/releases#long-term-support-release), maintainted till November 2029.
89+
See [what's new in Symfony 7.4](https://symfony.com/blog/category/living-on-the-edge/8.0-7.4) and [how to update Symfony within [[= product_name =]]](https://doc.ibexa.co/en/5.0/update_and_migration/from_5.0/update_from_5.0/#update-symfony-from-73-to-74).
90+
91+
#### Taxonomy search
92+
93+
One [taxonomy search](https://doc.ibexa.co/en/5.0/content_management/taxonomy/taxonomy_api/search) criterion is added:
94+
95+
- [`TaxonomyNoEntries`](https://doc.ibexa.co/en/5.0/search/criteria_reference/taxonomy_no_entries/) to find content items to which no taxonomy entries have been assigned.
96+
97+
#### Custom parameters in `ibexa_render()`
98+
99+
You can now pass custom parameters to templates when using the `ibexa_render()` Twig function with the new `params` option, similar to how you can with `render(controller())`.
100+
101+
This allows you to provide additional context or data to your view templates:
102+
103+
``` html+twig
104+
{{ ibexa_render(content, {
105+
'viewType': 'line',
106+
'method': 'inline',
107+
'params': {
108+
'custom_param': 'custom_value',
109+
'another_param': 'another_value'
110+
}
111+
}) }}
112+
```
113+
114+
The parameters are available in your template as regular variables.
115+
116+
For more information, see [`ibexa_render()` Twig function](https://doc.ibexa.co/en/5.0/templating/twig_function_reference/content_twig_functions/#ibexa_render).
117+
118+
#### Try-catch support in data migrations
119+
120+
Data migrations now support try-catch error handling, allowing you to wrap migration steps with exception handling logic.
121+
You can use it for migrations that might fail under certain conditions but should not break the entire migration process.
122+
123+
For example, you can create languages without checking if they already exist:
124+
125+
``` yaml
126+
[[= include_file('code_samples/data_migration/examples/try_catch_step.yaml') =]]
127+
```
128+
129+
The `try_catch` step allows you to specify which exceptions to catch and whether to continue executing remaining steps after an exception occurs.
130+
131+
For more information, see [Error handling with try-catch](https://doc.ibexa.co/en/5.0/content_management/data_migration/importing_data/#error-handling-with-try-catch).
132+
133+
#### Translation-related Twig Component groups
134+
135+
Four new [Twig component groups](https://doc.ibexa.co/en/5.0/templating/components/) related to Admin UI translation are added:
136+
137+
- `admin-ui-product-translation-modal-footer`
138+
- `admin-ui-product-translations-actions-modal`
139+
- `admin-ui-product-translations-actions`
140+
- `admin-ui-product-translations-row-actions`
141+
142+
For more information, see [available Admin UI Twig Component groups](https://doc.ibexa.co/en/5.0/administration/back_office/back_office_elements/custom_components/#admin-ui).
143+
144+
#### REST API
145+
146+
You can now find examples for some REST request bodies in the [OpenAPI REST API](rest_api_usage.md#openapi-support):
147+
148+
- in the right column of the [online reference](https://doc.ibexa.co/en/5.0/api/rest_api/rest_api_reference/rest_api_reference.html),
149+
and in the downloadable OpenAPI specification files
150+
- on your dev instance at `/api/ibexa/v2/doc` in an “Example Value” tab of the "Request Body" section, alongside the "Schema" tab
151+
- in the generated JSON or YAML OpenAPI specifications when running `ibexa:openapi` command
152+
153+
#### PHP API
154+
155+
The following additions were made to the PHP API:
156+
157+
- [`Ibexa\Contracts\Core\FieldType\ReferenceAwareExternalStorage`](https://doc.ibexa.co/en/5.0/api/php_api/php_api_reference/classes/Ibexa-Contracts-Core-FieldType-ReferenceAwareExternalStorage.html)
158+
- [`Ibexa\Contracts\Core\Options\Context`](https://doc.ibexa.co/en/5.0/api/php_api/php_api_reference/classes/Ibexa-Contracts-Core-Options-Context.html)
159+
- [`Ibexa\Contracts\CorporateAccount\Order\OrderStatusLabelProviderInterface`](https://doc.ibexa.co/en/5.0/api/php_api/php_api_reference/classes/Ibexa-Contracts-CorporateAccount-Order-OrderStatusLabelProviderInterface.html)
160+
- [`Ibexa\Contracts\ProductCatalog\Events\ProductAttributeRenderEvent`](https://doc.ibexa.co/en/5.0/api/php_api/php_api_reference/classes/Ibexa-Contracts-ProductCatalog-Events-ProductAttributeRenderEvent.html)
161+
- [`Ibexa\Contracts\Taxonomy\Search\Query\Criterion\TaxonomyNoEntries`](https://doc.ibexa.co/en/5.0/api/php_api/php_api_reference/classes/Ibexa-Contracts-Taxonomy-Search-Query-Criterion-TaxonomyNoEntries.html)
162+
<br>For more information, see [search criteria reference entry](https://doc.ibexa.co/en/5.0/search/criteria_reference/taxonomy_no_entries/).
163+
- [`Ibexa\Contracts\ConnectorRaptor` namespace](https://doc.ibexa.co/en/5.0/api/php_api/php_api_reference/namespaces/ibexa-contracts-connectorraptor.html) from the [Raptor connector add-on](https://doc.ibexa.co/en/5.0/cdp/raptor_integration/raptor_connector/)
164+
- [`Ibexa\Contracts\IntegratedHelp` namespace](https://doc.ibexa.co/en/5.0/api/php_api/php_api_reference/namespaces/ibexa-contracts-integratedhelp.html) from the [Integrated help LTS-Update](https://doc.ibexa.co/en/5.0/administration/back_office/integrated_help/)
165+
166+
### Full changelog
167+
168+
[[% include 'snippets/release_50.md' %]]
169+
170+
[[= release_note_entry_end() =]]
171+
13172
[[% set version = 'v5.0.6' %]]
14173

15174
[[= release_note_entry_begin(

docs/snippets/release_46.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -9,5 +9,5 @@ To learn more about all the included changes, see the full release change logs:
99
- [[[= product_name_com =]] [[= version =]]](https://github.com/ibexa/commerce/releases/tag/[[= version =]])
1010

1111
[[% if version != 'v4.6.0' %]]
12-
To update your application, see the [update instructions](../update_and_migration/from_4.6/update_from_4.6.md#[[= version_to_anchor(version) =]]).
12+
To update your application, see the [update instructions](https://doc.ibexa.co/en/4.6/update_and_migration/from_4.6/update_from_4.6/#[[= version_to_anchor(version) =]]).
1313
[[% endif %]]

docs/snippets/release_50.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -9,5 +9,5 @@ To learn more about all the included changes, see the full release change logs:
99
- [[[= product_name_com =]] [[= version =]]](https://github.com/ibexa/commerce/releases/tag/[[= version =]])
1010

1111
[[% if version != 'v5.0.0' %]]
12-
To update your application, see the [update instructions](../update_and_migration/from_5.0/update_from_5.0.md#[[= version_to_anchor(version) =]]).
12+
To update your application, see the [update instructions](https://doc.ibexa.co/en/5.0/update_and_migration/from_5.0/update_from_5.0/#[[= version_to_anchor(version) =]]).
1313
[[% endif %]]

mkdocs.yml

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1028,8 +1028,8 @@ extra:
10281028
latest_tag_4_3: '4.3.5'
10291029
latest_tag_4_4: '4.4.4'
10301030
latest_tag_4_5: '4.5.7'
1031-
latest_tag_4_6: '4.6.28'
1032-
latest_tag_5_0: '5.0.6'
1031+
latest_tag_4_6: '4.6.29'
1032+
latest_tag_5_0: '5.0.7'
10331033

10341034
symfony_doc: 'https://symfony.com/doc/7.4'
10351035
user_doc: 'https://doc.ibexa.co/projects/userguide/en/5.0'

0 commit comments

Comments
 (0)