Table of Contents & Menu
Navigation

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.phtml template required overriding it.
  • New Solution: Add links by declaring child blocks in the Layout XML for either the header.customer.logged.in.links or header.customer.logged.out.links block.
  • Compatibility: Existing customer-menu.phtml files 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.