Documentation >
Release notes >
Ibexa DXP v4.0 deprecations and BC breaks

Ibexa DXP v4.0 deprecations and backwards compatibility breaks¶

Ibexa DXP v4.0 introduces changes to significant parts of the code to align with the product name change from earlier eZ Platform.

These changes include changing repository names, namespaces, filenames, function names, and others.

A backwards compatibility layer ensures that custom implementations and extensions using the older naming should function without change.

Namespaces¶

Namespaces in the product which referred to old product names now use the Ibexa name.

All namespace changes are listed in the ibexa/compatibility-layer repository.

Refer to mapping reference for a full comparison of old and new bundle names and namespaces.

Tip

To make sure your code is up to date with the new namespaces, you can use the Ibexa PhpStorm plugin. The plugin indicates deprecated namespaces and suggests updating them to new ones.

Richtext namespace¶

The internal format of richtext has changed.

All namespace changes are listed in the richtext repository.

Configuration keys¶

ezplatform and ezpublish configuration keys have been replaced with ibexa.

Other package-specific configuration keys have also been updated.

Old name	New name
`ezplatform`	`ibexa`
`ezpublish`	`ibexa`
`ez_doctrine_schema`	`ibexa_doctrine_schema`
`ez_io`	`ibexa_io`
`ez_platform_fastly_cache`	`ibexa_fastly`
`ez_platform_http_cache`	`ibexa_http_cache`
`ez_platform_page_builder`	`ibexa_page_builder`
`ez_platform_standard_design`	`ibexa_standard_design`
`ez_search_engine_legacy`	`ibexa_legacy_search_engine`
`ez_search_engine_solr`	`ibexa_solr`
`ezdesign`	`ibexa_design_engine`
`ezplatform_elastic_search_engine`	`ibexa_elasticsearch`
`ezplatform_form_builder`	`ibexa_form_builder`
`ezplatform_graphql`	`ibexa_graphql`
`ezplatform_page_fieldtype`	`ibexa_fieldtype_page`
`ezplatform_support_tools`	`ibexa_system_info`
`ezrecommendation`	`ibexa_personalization_client`
`ezrichtext`	`ibexa_fieldtype_richtext`
`ibexa_platform_commerce_field_types`	`ibexa_commerce_field_types`
`one_sky`	`ibexa_commerce_one_sky`
`ses_specificationstypefieldtype`	`ibexa_commerce_specifications_type`
`shop_price_engine_plugin`	`ibexa_commerce_price_engine`
`silversolutions_eshop`	`ibexa_commerce_eshop`
`silversolutions_tools`	`ibexa_commerce_shop_tools`
`silversolutions_translation`	`ibexa_commerce_translation`
`siso_admin_erp`	`ibexa_commerce_erp_admin`
`siso_basket`	`ibexa_commerce_basket`
`siso_checkout`	`ibexa_commerce_checkout`
`siso_comparison`	`ibexa_commerce_comparison`
`siso_content_plugin`	`ibexa_commerce_base_design`
`siso_ez_studio`	`ibexa_commerce_ez_studio`
`siso_local_order_management`	`ibexa_commerce_local_order_management`
`siso_newsletter`	`ibexa_commerce_newsletter`
`siso_order_history`	`ibexa_commerce_order_history`
`siso_payment`	`ibexa_commerce_payment`
`siso_price`	`ibexa_commerce_price`
`siso_quick_order`	`ibexa_commerce_quick_order`
`siso_search`	`ibexa_commerce_search`
`siso_shop_frontend`	`ibexa_commerce_shop_frontend`
`siso_test`	`ibexa_commerce_test_tools`
`siso_tools`	`ibexa_commerce_tools`
`siso_voucher`	`ibexa_commerce_voucher`

Service names¶

Service names which referred to old product names now use the Ibexa name.

All service name changes are listed in the ibexa/compatibility-layer repository.

Refer to mapping reference for a full comparison of old and new names.

Service tags¶

Service tag which referred to old product names now use the Ibexa name.

All service tag changes are listed in the ibexa/compatibility-layer repository.

Refer to mapping reference for a full comparison of old and new service tags.

CSS classes for Back Office¶

CSS classes with the ez- prefix have been modified with an ibexa- prefix.

JavaScript event names¶

JavaScript event names with the ez- prefix have been modified with an ibexa- prefix, for example:

ez-notify > ibexa-notify ez-content-tree-refresh > ibexa-content-tree-refresh

REST API¶

REST API route prefix has changed from /api/ezp/v2/ to /api/ibexa/v2/.

REST API media types have changed from application/vnd.ez.api.* to application/vnd.ibexa.api.*.

Twig functions and filters¶

The following Twig functions and filter have been renamed, including:

Old name	New name
`ez_content_name`	`ibexa_content_name`
`ez_render_field`	`ibexa_render_field`
`ez_render`	`ibexa_render`
`ez_field`	`ibexa_field`
`ez_image_alias`	`ibexa_image_alias`

Full list of changed Twig function and filter names

Old name	New name
`calculate_shipping`	`ibexa_commerce_calculate_shipping`
`code_label`	`ibexa_commerce_code_label`
`date_format`	`ibexa_commerce_date_format`
`ez_content_field_identifier_first_filled_image`	`ibexa_content_field_identifier_first_filled_image`
`ez_content_field_identifier_image_asset`	`ibexa_content_field_identifier_image_asset`
`ez_content_name`	`ibexa_content_name`
`ez_content_type_icon`	`ibexa_content_type_icon`
`ez_data_attributes_serialize`	`ibexa_data_attributes_serialize`
`ez_datetime_diff`	`ibexa_datetime_diff`
`ez_field_description`	`ibexa_field_description`
`ez_field_is_empty`	`ibexa_field_is_empty`
`ez_field_name`	`ibexa_field_name`
`ez_field_value`	`ibexa_field_value`
`ez_field`	`ibexa_field`
`ez_file_size`	`ibexa_file_size`
`ez_full_date`	`ibexa_full_date`
`ez_full_datetime`	`ibexa_full_datetime`
`ez_full_time`	`ibexa_full_time`
`ez_http_cache_tag_location`	`ibexa_http_cache_tag_location`
`ez_http_tag_location`	`ibexa_http_cache_tag_location`
`ez_http_tag_relation_ids`	`ibexa_http_cache_tag_relation_ids`
`ez_http_tag_relation_location_ids`	`ibexa_http_cache_tag_relation_location_ids`
`ez_image_alias`	`ibexa_image_alias`
`ez_page_layout`	`ibexa_page_layout`
`ez_path_to_locations`	`ibexa_path_to_locations`
`ez_path`	`ibexa_path`
`ez_recommendation_enabled`	`ibexa_recommendation_enabled`
`ez_recommendation_track_user`	`ibexa_recommendation_track_user`
`ez_render__query_`	`ibexa_render_*_query_`
`ez_render_*_query`	`ibexa_render_*_query`
`ez_render_comparison_result`	`ibexa_render_comparison_result`
`ez_render_content`	`ibexa_render_content`
`ez_render_field_definition_settings`	`ibexa_render_field_definition_settings`
`ez_render_field`	`ibexa_render_field`
`ez_render_limitation_value`	`ibexa_render_limitation_value`
`ez_render_location`	`ibexa_render_location`
`ez_render`	`ibexa_render`
`ez_richtext_to_html5_edit`	`ibexa_richtext_to_html5_edit`
`ez_richtext_to_html5`	`ibexa_richtext_to_html5`
`ez_richtext_youtube_extract_id`	`ibexa_richtext_youtube_extract_id`
`ez_route`	`ibexa_route`
`ez_short_date`	`ibexa_short_date`
`ez_short_datetime`	`ibexa_short_datetime`
`ez_short_time`	`ibexa_short_time`
`ez_url`	`ibexa_url`
`get_characteristics_b2b`	`ibexa_commerce_get_characteristics_b2b`
`get_relation_content`	`ibexa_commerce_get_relation_content`
`get_search_query`	`ibexa_commerce_get_search_query`
`get_shipping_free_value`	`ibexa_commerce_get_shipping_free_value`
`get_siteaccess_locale`	`ibexa_commerce_get_siteaccess_locale`
`get_stored_baskets`	`ibexa_commerce_get_stored_baskets`
`ibexa_commerce_render_stock`	`ibexa_commerce_render_stock`
`ibexa_platform_asset`	`ibexa_dam_asset`
`ibexa_platform_dam_image_transformation`	`ibexa_dam_image_transformation`
`is_shipping_free`	`ibexa_commerce_is_shipping_free`
`price_format`	`ibexa_commerce_price_format`
`ses_assets_by_group`	`ibexa_commerce_assets_by_group`
`ses_assets_image_list`	`ibexa_commerce_assets_image_list`
`ses_assets_main_image`	`ibexa_commerce_assets_main_image`
`ses_basket`	`ibexa_commerce_basket`
`ses_check_product_in_comparison`	`ibexa_commerce_check_product_in_comparison`
`ses_check_product_in_wish_list`	`ibexa_commerce_check_product_in_wish_list`
`ses_comparison_category`	`ibexa_commerce_comparison_category`
`ses_config_parameter`	`ibexa_commerce_config_parameter`
`ses_contains_basket_vouchers`	`ibexa_commerce_contains_basket_vouchers`
`ses_content_pagination`	`ibexa_commerce_content_pagination`
`ses_correct_url`	`ibexa_commerce_correct_url`
`ses_erp_to_default`	`ibexa_commerce_erp_to_default`
`ses_format_args`	`ibexa_commerce_format_args`
`ses_get_basket_vouchers`	`ibexa_commerce_get_basket_vouchers`
`ses_invoice_number`	`ibexa_commerce_invoice_number`
`ses_navigation`	`ibexa_commerce_navigation`
`ses_pagination`	`ibexa_commerce_pagination`
`ses_product`	`ibexa_commerce_product`
`ses_render_field`	`ibexa_commerce_render_field`
`ses_render_price`	`ibexa_commerce_render_price`
`ses_render_specification_matrix`	`ibexa_commerce_render_specification_matrix`
`ses_render_stock`	`ibexa_commerce_render_stock`
`ses_scope_request_active`	`ibexa_commerce_scope_request_active`
`ses_to_float`	`ibexa_commerce_to_float`
`ses_total_comparison`	`ibexa_commerce_total_comparison`
`ses_track_base`	`ibexa_commerce_track_base`
`ses_track_basket`	`ibexa_commerce_track_basket`
`ses_track_product`	`ibexa_commerce_track_product`
`ses_user_menu`	`ibexa_commerce_user_menu`
`ses_variant_product_by_sku`	`ibexa_commerce_variant_product_by_sku`
`ses_wish_list`	`ibexa_commerce_wish_list`
`sort_characteristic_codes`	`ibexa_commerce_sort_characteristic_codes`
`sort_characteristics`	`ibexa_commerce_sort_characteristics`
`st_image`	`ibexa_commerce_image`
`st_imageconverter`	`ibexa_commerce_imageconverter`
`st_resolve_template`	`ibexa_commerce_resolve_template`
`st_siteaccess_lang`	`ibexa_commerce_siteaccess_lang`
`st_siteaccess_path`	`ibexa_commerce_siteaccess_path`
`st_siteaccess_url`	`ibexa_commerce_siteaccess_url`
`st_tag`	`ibexa_commerce_tag`
`st_translate`	`ibexa_commerce_translate`
`truncate`	`ibexa_commerce_truncate`
`unserialize`	`ibexa_commerce_unserialize`
`youtube_video_id`	`ibexa_commerce_youtube_video_id`

URL Alias route name¶

URL Alias route name has changed from ez_urlalias to ibexa.url.alias.

Configuration file names¶

Built-in configuration files starting with ezplatform now use names with ibexa, including:

Old name	New name
`ezplatform.yaml`	`ibexa.yaml`
`ezplatform_admin_ui.yaml`	`ibexa_admin_ui.yaml`
`ezplatform_assets.yaml`	`ibexa_assets.yaml`
`ezplatform_doctrine_schema.yaml`	`ibexa_doctrineschema.yaml`
`ezplatform_elastic_search_engine.yaml`	`ibexa_elasticsearch.yaml`
`ezplatform_form_builder.yaml`	`ibexa_form_builder.yaml`
`ezplatform_http_cache.yaml`	`ibexa_http_cache.yaml`
`ezplatform_http_cache_fastly.yaml`	`ibexa_fastly.yaml`
`ezplatform_page_builder.yaml`	`ibexa_page_builder.yaml`
`ezplatform_site_factory.yaml`	`ibexa_site_factory.yaml`
`ezplatform_solr.yaml`	`ibexa_solr.yaml`
`ezplatform_welcome_page.yaml`	`ibexa_welcome_page.yaml`

Minor changes¶

AbstractBuilder::createMenuItem return type is now ItemInterface only.
Meaningless properties added to the Doctrine schema now throw an exception. This is prevents indexes from being placed erroneously in the root table.
The following deprecated service tags have been dropped: ezsystems.platformui.application_config_provider, ezpublish.content_view_provider, ezpublish.fieldType, ezpublish.fieldType.parameterProvider, ezpublish.fieldType.indexable, ezpublish.fieldType.externalStorageHandler, ezpublish.fieldType.externalStorageHandler.gateway, ezpublish.location_view_provider, ezpublish.query_type, ezpublish.searchEngineIndexer, ezpublish.searchEngine, ezpublish.storageEngine.legacy.converter
Ibexa\Contracts\Core\MVC\EventSubscriber\onConfigScopeChange::onConfigScopeChange now takes ScopeChangeEvent $event instead of SiteAccess $siteAccess as argument.