diff --git a/src/6.6/6.6.10.0.md b/src/6.6/6.6.10.0.md new file mode 100644 index 0000000..cc6f5ae --- /dev/null +++ b/src/6.6/6.6.10.0.md @@ -0,0 +1,186 @@ +--- +nav: + title: v6.6.10.0 +meta: + date: "2025-02-19" +--- + +# Release notes Shopware 6.6.10.0 + +## Abstract + +This minor release contains improvements like MySQL invalidator storage, external media URLs via API, even more A11y improvents and more. Additionally, 10+ bugs had been fixed. + +## System requirements + +* tested on PHP 8.2 and 8.3 +* tested on MySQL 8 and MariaDB 10.11 + +## Improvements + +### Upgrade to Symfony 7.2 + +* Changed `symfony/*` dependencies to `^7.2` + +### Addition of MySQLInvalidatorStorage + +* Introduced `/Shopware/Core/Framework/Adapter/Cache/InvalidatorStorage/MySQLInvalidatorStorage` to collect and handle cache invalidations in MySQL as an atomic operation. +* This new storage option allows delayed cache invalidation without requiring Redis (although Redis remains the recommended solution). +* To switch to MySQL for delayed cache invalidation, update your configuration as follows: +```yaml +shopware: + cache: + invalidation: + delay: 1 + delay_options: + storage: mysql +``` + +### [A11y-HTML] Offer HTML alternative to our pdf standard documents + +* Besides the existing PDF document which is based on DOMPDF, we added our standard document as HTML documents for fulfilling the A11y criteria. + +### Introduce global template data for language and navigation + +Some of the data for the Twig template in the storefront, like the current currency or navigation ID, should not depend on the current page object; instead, the should be available globally and independently. The following changes facilitate the introduction of those global template data: + +* Added new Twig function `sw_breadcrumb_full_by_id` to get the full breadcrumb for a category ID. +* Added /Shopware/Storefront/Framework/Twig/NavigationInfo to the global shopware Twig variable, to provide the ID of the main navigation and the current navigation path as ID list. +* Added `minSearchLength` to the global Shopware Twig variable, which defines the minimum search term length. +* Added `showStagingBanner` to the global shopware Twig variable, which defines if the staging banner should be shown. +* Deprecated the global `showStagingBanner` Twig variable. Use `shopware.showStagingBanner` instead. +* Deprecated the usage of the header and footer properties of page Twig objects outside the dedicated header and footer templates. Use the following alternatives instead: + * `context.currency` instead of `page.header.activeCurrency` + * `shopware.navigation.id` instead of `page.header.navigation.active.id` + * `shopware.navigation.pathIdList` instead of `page.header.navigation.active.path` + * `context.saleschannel.languages.first` instead of `page.header.activeLanguage` +* Added new optional parameter `serviceMenu` of type /Shopware/Core/Content/Category/CategoryCollection to /Shopware/Storefront/Pagelet/Footer/FooterPagelet. It will be required in the next major version. + +### Introduce Edge Side Includes (ESI) for header and + +With the next major version, the header and footer will be loaded via ESI. Due to this change, many things were deprecated and will be removed with the next major version, as they are not needed anymore (Please refer to the [changelog](https://github.com/shopware/shopware/blob/v6.6.10.0/CHANGELOG.md) for a detailed list of associated deprecations). + +* This changes are currently behind the `cache_rework` flag. +* The header and footer are now loaded via ESI. This allows to cache the header and footer separately from the rest of the page. +* Two new routes `/header` and `/footer` were added to receive the rendered header and footer. +* The rendered header and footer are included into the page with the Twig function `render_esi`, which calls the previously mentioned routes. +* Two new templates `src/Storefront/Resources/views/storefront/layout/header.html.twig` and `src/Storefront/Resources/views/storefront/layout/footer.html.twig` were introduced as new entry points for the header and footer. +* Make sure to adjust your template extensions to be compatible with the new structure. The block names are still the same, so it just should be necessary to extend from the new templates. + +### Removal of the asterisk next to every price + +* When activating the `ACCESSIBILITY_TWEAKS` feature flag the price asterisk * are no longer displayed next to every price. A text link for tax and shipping information is displayed instead. + +### Bulk entity extension + +* Deprecated EntityExtension::getDefinitionClass. It will be replaced by `EntityExtension::getEntityName`, which needs to return the entity name. + +Before: + +```php +