Upgrading to 1.3.2
Hyvä Theme 1.3.2 introduces a new composable header customer account menu and includes bug fixes.
Important: When upgrading, always update the hyva-themes/magento2-theme-module to its latest version. This module update is safe even if you are not updating the Default Theme to 1.3.2.
Backward incompatible changes
There are no backward incompatible changes in 1.3.2.
Noteworthy changes
Updated reset-theme to 1.1.5
The hyva-themes/magento2-reset-theme version constraint is now >=1.1.5. If reset-theme is a dependency in your root composer.json file, ensure you include it in your update.
Composable header customer-account menu
The new composable customer account menu simplifies adding links without template overrides, resolving common conflicts with third-party extensions.
- Previous Issue: Adding links to the
Magento_Customer/templates/header/customer-menu.phtmltemplate required overriding it. - New Solution: Add links by declaring child blocks in the Layout XML for either the
header.customer.logged.in.linksorheader.customer.logged.out.linksblock. - Compatibility: Existing
customer-menu.phtmlfiles will continue to work but will not render menu links added via Layout XML. Consider migrating customized templates to leverage the new functionality.
For example:
<referenceBlock name="header.customer.logged.in.links">
<block name="customer.header.orders.link"
class="Hyva\Theme\Block\SortableItemInterface">
<arguments>
<argument name="label" xsi:type="string" translate="true">My Orders</argument>
<argument name="path" xsi:type="string">sales/order/history</argument>
<argument name="sort_order" xsi:type="number">30</argument>
</arguments>
</block>
</referenceBlock>
For more information on how to add links, headings, and delimiters to the customer header menu, refer to the documentation.
Changelogs
Changelogs are available in the CHANGELOG.md file in the codebase, or via these links:
Tooling
For general upgrade guidance, refer to the Hyvä Theme upgrade documentation.