Skip to content

Upgrading to 1.1.4

This release is a maintenance release, mostly focused on bug fixes.

Please refer to the changelog for details.

Please check the upgrade process overview for Hyvä-Checkout first.
Then, to upgrade, run the command

composer update --with-dependencies hyva-themes/magento2-hyva-checkout:1.1.4

Backward incompatible changes

Page Layout changed to 1column

Previously Hyvä Checkout used the checkout page layout.

This was changed to 1column in order to provide better styling and improved compatibility with Hyvä theme out-of-the-box.
In order to remove the top menu, search box and customer account menu, a new header template Hyva_Checkout::page/header/checkout-header.phtml was introduced.

In order to preserve the styling for existing checkout implementations, a small manual change is required after upgrading.
The exact change that is required depends on the implementation.

A) Checkouts using the checkout page layout

Existing checkout implementations using the checkout page layout through inheritance from the Hyva_Checkout module will need to add layout="checkout" to their theme hyva_checkout_index_index.xml file to revert the header.

<page xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
      layout="checkout"
      xsi:noNamespaceSchemaLocation="urn:magento:framework:View/Layout/etc/page_configuration.xsd"
>
...
</page>

B) Checkouts using the 1column page layout

If existing checkouts already uses the 1column page layout, then the header template needs to be set to Magento_Theme/templates/html/header.phtml in order to revert to the previous header layout.

In your themes hyva_checkout_index_index.xml:

<referenceBlock name="header-content"
                template="Magento_Theme/templates/html/header.phtml"/>

C) Checkouts using the 2columns-left, 2columns-right or 3columns page layout

In this case both the page layout and the header block need to be reverted to the previous values in your theme.

In your themes hyva_checkout_index_index.xml:

<page xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
      layout="checkout"
      xsi:noNamespaceSchemaLocation="urn:magento:framework:View/Layout/etc/page_configuration.xsd"
>
    <body>
        <referenceBlock name="header-content"
                        template="Magento_Theme/templates/html/header.phtml"/>
    </body>
</page>

Changelogs

Changelogs are available from the CHANGELOG.md in the codebase, or here in the docs.