Upgrading to 1.3.4
1.3.4 includes bug fixes and improvements.
Most noteworthy, the hyva-themes/magento2-theme-module
has been incompatible with themes using Alpine v2 since release 1.2.6.
This situation has been resolved - the latest version of the theme module is compatible with all previous Hyvä-Theme releases again.
When updating the Hyvä Theme to version 1.3.4, please note to always update the hyva-themes/magento2-theme-module
to the latest version as well.
Even if not updating the Default Theme to 1.3.4, it should always be safe to update the Hyva_Theme
module to the latest version (package hyva-themes/magento2-theme-module
).
Backward incompatible changes
Existing themes based on Hyvä 1.3.3 will not break during the upgrade of the default theme, but a few adjustments may be required for end-to-end tests.
Unordered HTML list for product listings
To improve accessibility, product listings now use semantically correct ul > li elements for products, where previously divs were used.
This may require changes to selectors used in end-to-end tests like with Cypress or Playwright.
HTML tables for customer order history, recent orders, and customer downloadable products
To improve accessibility, customer order history, recent orders, and customer downloadable products now use semantically correct table elements for products.
This may require changes to selectors used in end-to-end tests like with Cypress or Playwright.
Customer login form styling improvement
The class customer-login-container
declared in web/tailwind/components/customer.css
no longer has any styles associated with it.
It only remains for backward compatibility. To benefit from the layout changes, be sure to remove the class styles from the file, too, after updating the template files.
Login form templates diff
diff --git a/Magento_Customer/layout/customer_account_login.xml b/Magento_Customer/layout/customer_account_login.xml
index 8f7927d8b89588432b34a5c14e85e32e276dfc83..cc82b36cd2790404b2a010d0948ff044dc0097cb 100644
--- a/Magento_Customer/layout/customer_account_login.xml
+++ b/Magento_Customer/layout/customer_account_login.xml
@@ -13,17 +13,21 @@
</head>
<body>
<referenceContainer name="content">
- <container name="customer.login.container"
- htmlTag="div"
- htmlId="customer-login-container"
- htmlClass="login-container">
- <block class="Magento\Customer\Block\Form\Login" name="customer_form_login"
- template="Magento_Customer::form/login.phtml">
+ <container
+ name="customer.login.container"
+ htmlTag="div"
+ htmlId="customer-login-container"
+ htmlClass="login-container grid gap-x-4 gap-y-8 grid-cols-1 py-8 md:grid-cols-2"
+ >
+ <block
+ class="Magento\Customer\Block\Form\Login"
+ name="customer_form_login"
+ template="Magento_Customer::form/login.phtml"
+ >
<container name="form.additional.info" as="form_additional_info"/>
</block>
<block class="Magento\Customer\Block\Form\Login\Info" name="customer.new" template="Magento_Customer::newcustomer.phtml"/>
</container>
</referenceContainer>
-
</body>
</page>
diff --git a/Magento_Customer/templates/form/login.phtml b/Magento_Customer/templates/form/login.phtml
index dd001e866ad1a21ccc61b9815c5dc9d5f620d264..1ebf086152ba455c35565242dd3830c8a2521d4a 100644
--- a/Magento_Customer/templates/form/login.phtml
+++ b/Magento_Customer/templates/form/login.phtml
@@ -35,7 +35,7 @@ $loginButtonViewModel = $viewModels->require(LoginButton::class);
// on the Magento_ReCaptchaCustomer module
$recaptcha = $block->getData('viewModelRecaptcha');
?>
-<div class="w-full md:w-1/2 card mr-4">
+<div class="card">
<div aria-labelledby="block-customer-login-heading">
<form class="form form-login"
action="<?= $escaper->escapeUrl($block->getPostActionUrl()) ?>"
diff --git a/Magento_Customer/templates/newcustomer.phtml b/Magento_Customer/templates/newcustomer.phtml
index 5460babad0a8ce8f3d3646ca24ce409655ac7746..8694bab4d8ebf9bd60d55b44dc162d6c8af537b8 100644
--- a/Magento_Customer/templates/newcustomer.phtml
+++ b/Magento_Customer/templates/newcustomer.phtml
@@ -15,7 +15,7 @@ use Magento\Framework\Escaper;
/** @var Escaper $escaper */
?>
<?php if ($block->getRegistration()->isAllowed()): ?>
- <div class="block-new-customer card w-full md:w-1/2 my-8 md:my-0">
+ <div class="block-new-customer card">
<div class="block-title">
<h2 class="text-xl font-medium title-font mb-3 text-primary" role="heading"
aria-level="2"><?= $escaper->escapeHtml(__('New Customers')) ?></h2>
Changelogs
Changelogs are available from the CHANGELOG.md in the codebase, or here:
Tooling
Please refer to the Hyvä Theme upgrade docs for helpful information how to upgrade.
Known Issues
Please check the GitLab issue tracker for the default-theme and the theme-module for known issues.