diff --git a/docs/release_notes/ibexa_dxp_v4.6.md b/docs/release_notes/ibexa_dxp_v4.6.md index c681524bfc..2bfd21e2c7 100644 --- a/docs/release_notes/ibexa_dxp_v4.6.md +++ b/docs/release_notes/ibexa_dxp_v4.6.md @@ -10,6 +10,78 @@ month_change: true
+[[% set version = 'v4.6.29' %]] + +[[= release_note_entry_begin( + "Integrated help " + version, + '2026-04-20', + ['Headless', 'Experience', 'Commerce', 'LTS Update', 'New feature'] +) =]] + +### Product tour + +The product tour is a new Integrated help feature that helps back office contributors to discover [[= product_name =]]. + +With product tours, you can create customized onboarding journeys. +This accelerates user adoption, reduces training time, and helps users confidently navigate the platform. + +For more information, see [Product tour](https://doc.ibexa.co/en/4.6/administration/back_office/product_tour/). + +[[= release_note_entry_end() =]] + +[[= release_note_entry_begin( + "Ibexa DXP " + version, + '2026-04-20', + ['Headless', 'Experience', 'Commerce', 'New feature'] +) =]] + +### Developer experience + +#### Taxonomy search + +One [taxonomy search](https://doc.ibexa.co/en/4.6/content_management/taxonomy/taxonomy_api/search) criterion is added: + +- [`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. + +#### Custom parameters in `ibexa_render()` + +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())`. + +This allows you to provide additional context or data to your view templates: + +``` html+twig +{{ ibexa_render(content, { + 'viewType': 'line', + 'method': 'inline', + 'params': { + 'custom_param': 'custom_value', + 'another_param': 'another_value' + } +}) }} +``` + +The parameters are available in your template as regular variables. + +For more information, see [`ibexa_render()` Twig function](https://doc.ibexa.co/en/4.6/templating/twig_function_reference/content_twig_functions/#ibexa_render). + +#### PHP API + +The following additions were made to the PHP API: + +- [`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) +- [`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) +- [`Ibexa\Contracts\CorporateAccount\Order`](https://doc.ibexa.co/en/4.6/api/php_api/php_api_reference/namespaces/ibexa-contracts-corporateaccount-order.html) +- [`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) +- [`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) +
For more information, see [search criteria reference entry](https://doc.ibexa.co/en/4.6/search/criteria_reference/taxonomy_no_entries/). +- [`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/) + +### Full changelog + +[[% include 'snippets/release_46.md' %]] + +[[= release_note_entry_end() =]] + [[% set version = 'v4.6.28' %]] [[= release_note_entry_begin( diff --git a/docs/release_notes/ibexa_dxp_v5.0.md b/docs/release_notes/ibexa_dxp_v5.0.md index fd8ea68827..9b37f7eb72 100644 --- a/docs/release_notes/ibexa_dxp_v5.0.md +++ b/docs/release_notes/ibexa_dxp_v5.0.md @@ -10,6 +10,165 @@ month_change: true
+[[% set version = 'v5.0.7' %]] + +[[= release_note_entry_begin( + "Google Gemini connector " + version, + '2026-04-20', + ['Headless', 'Experience', 'Commerce', 'LTS Update', 'New feature', 'First release'] +) =]] + +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). +You can also use it as an alternative embeddings provider for the [taxonomy suggestions feature](taxonomy.md#taxonomy-suggestions). + +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). + +[[= release_note_entry_end() =]] + +[[= release_note_entry_begin( + "Integrated help " + version, + '2026-04-20', + ['Headless', 'Experience', 'Commerce', 'LTS Update', 'New feature'] +) =]] + +### Product tour + +The product tour is a new Integrated help feature that helps back office contributors to discover [[= product_name =]]. + +With product tours, you can create customized onboarding journeys. +This accelerates user adoption, reduces training time, and helps users confidently navigate the platform. + +For more information, see [Product tour](https://doc.ibexa.co/en/5.0/administration/back_office/product_tour/). + +[[= release_note_entry_end() =]] + +[[= release_note_entry_begin( + "Ibexa DXP " + version, + '2026-04-20', + ['Headless', 'Experience', 'Commerce', 'New feature'] +) =]] + +### Raptor connector + +The Raptor connector provides a seamless integration between [[= product_name =]] and [Raptor Recommendation Engine](https://www.raptorservices.com/website-recommendations/). + +For more information, see [Raptor connector](https://doc.ibexa.co/en/5.0/cdp/raptor_integration/raptor_connector/). + +#### Tracking + +This add-on includes two Twig functions to ease tracking setting: + +- `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/) +- `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/) + +#### Recommendations blocks [[% include 'snippets/experience_badge.md' %]] [[% include 'snippets/commerce_badge.md' %]] + +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. + +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/). + +### Quable PIM + +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 =]]. + +[[= pim_product_name =]] can serve as the single source of truth for all product data, including attributes, classifications, variants, and translations. +[[= product_name =]] consumes this data and makes it available for use in content and digital experiences. + +For more information, see [Quable PIM Integration](https://doc.ibexa.co/en/5.0/product_catalog/quable/). + +### AI Actions in Page Builder blocks [[% include 'snippets/experience_badge.md' %]] [[% include 'snippets/commerce_badge.md' %]] + +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. + +### Developer experience + +#### Symfony 7.4 + +Symfony is upgraded from 7.3 to 7.4. +It's the latest [LTS release](https://symfony.com/releases#long-term-support-release), maintainted till November 2029. +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). + +#### Taxonomy search + +One [taxonomy search](https://doc.ibexa.co/en/5.0/content_management/taxonomy/taxonomy_api/search) criterion is added: + +- [`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. + +#### Custom parameters in `ibexa_render()` + +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())`. + +This allows you to provide additional context or data to your view templates: + +``` html+twig +{{ ibexa_render(content, { + 'viewType': 'line', + 'method': 'inline', + 'params': { + 'custom_param': 'custom_value', + 'another_param': 'another_value' + } +}) }} +``` + +The parameters are available in your template as regular variables. + +For more information, see [`ibexa_render()` Twig function](https://doc.ibexa.co/en/5.0/templating/twig_function_reference/content_twig_functions/#ibexa_render). + +#### Try-catch support in data migrations + +Data migrations now support try-catch error handling, allowing you to wrap migration steps with exception handling logic. +You can use it for migrations that might fail under certain conditions but should not break the entire migration process. + +For example, you can create languages without checking if they already exist: + +``` yaml +[[= include_file('code_samples/data_migration/examples/try_catch_step.yaml') =]] +``` + +The `try_catch` step allows you to specify which exceptions to catch and whether to continue executing remaining steps after an exception occurs. + +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). + +#### Translation-related Twig Component groups + +Four new [Twig component groups](https://doc.ibexa.co/en/5.0/templating/components/) related to Admin UI translation are added: + +- `admin-ui-product-translation-modal-footer` +- `admin-ui-product-translations-actions-modal` +- `admin-ui-product-translations-actions` +- `admin-ui-product-translations-row-actions` + +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). + +#### REST API + +You can now find examples for some REST request bodies in the [OpenAPI REST API](rest_api_usage.md#openapi-support): + +- 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), + and in the downloadable OpenAPI specification files +- on your dev instance at `/api/ibexa/v2/doc` in an “Example Value” tab of the "Request Body" section, alongside the "Schema" tab +- in the generated JSON or YAML OpenAPI specifications when running `ibexa:openapi` command + +#### PHP API + +The following additions were made to the PHP API: + +- [`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) +- [`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) +- [`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) +- [`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) +- [`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) +
For more information, see [search criteria reference entry](https://doc.ibexa.co/en/5.0/search/criteria_reference/taxonomy_no_entries/). +- [`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/) +- [`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/) + +### Full changelog + +[[% include 'snippets/release_50.md' %]] + +[[= release_note_entry_end() =]] + [[% set version = 'v5.0.6' %]] [[= release_note_entry_begin( diff --git a/docs/snippets/release_46.md b/docs/snippets/release_46.md index d564479e48..669a4a13cb 100644 --- a/docs/snippets/release_46.md +++ b/docs/snippets/release_46.md @@ -9,5 +9,5 @@ To learn more about all the included changes, see the full release change logs: - [[[= product_name_com =]] [[= version =]]](https://github.com/ibexa/commerce/releases/tag/[[= version =]]) [[% if version != 'v4.6.0' %]] -To update your application, see the [update instructions](../update_and_migration/from_4.6/update_from_4.6.md#[[= version_to_anchor(version) =]]). +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) =]]). [[% endif %]] diff --git a/docs/snippets/release_50.md b/docs/snippets/release_50.md index 8376c2d425..fe6221fb63 100644 --- a/docs/snippets/release_50.md +++ b/docs/snippets/release_50.md @@ -9,5 +9,5 @@ To learn more about all the included changes, see the full release change logs: - [[[= product_name_com =]] [[= version =]]](https://github.com/ibexa/commerce/releases/tag/[[= version =]]) [[% if version != 'v5.0.0' %]] -To update your application, see the [update instructions](../update_and_migration/from_5.0/update_from_5.0.md#[[= version_to_anchor(version) =]]). +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) =]]). [[% endif %]] diff --git a/mkdocs.yml b/mkdocs.yml index 358ef260c3..a2082cc594 100644 --- a/mkdocs.yml +++ b/mkdocs.yml @@ -1028,8 +1028,8 @@ extra: latest_tag_4_3: '4.3.5' latest_tag_4_4: '4.4.4' latest_tag_4_5: '4.5.7' - latest_tag_4_6: '4.6.28' - latest_tag_5_0: '5.0.6' + latest_tag_4_6: '4.6.29' + latest_tag_5_0: '5.0.7' symfony_doc: 'https://symfony.com/doc/7.4' user_doc: 'https://doc.ibexa.co/projects/userguide/en/5.0'