Table of Contents & Menu
Navigation

Upgrading to 1.3.12

Version 1.3.12 introduces CSP compatibility for components shared between Hyvä Checkout and the default theme, along with various bug fixes.

Important: When updating to Hyvä Theme 1.3.12, always update the hyva-themes/magento2-theme-module package to its latest version. This module can be safely updated even if you are not updating the Default Theme itself to 1.3.12.

Backward Incompatible Changes

To achieve strict CSP compatibility, all components shared between the Hyvä Default Theme and Hyvä Checkout have been refactored. This involved updating Alpine Components to work without the unsafe-eval CSP policy, which may introduce backward compatibility breaking changes.

For detailed information, refer to the Hyvä Checkout docs on shared components.

Potentially affected templates include:

  • Cookie Notice Component

  • Magento_Cookie::notices.phtml

  • The Authentication Drawer

  • Magento_Customer::account/authentication-popup.phtml

  • Footer Components (Currency, Store, Language Selector, and Newsletter Subscription)

  • Magento_Directory::currency.phtml

  • Magento_Newsletter::subscribe.phtml
  • Magento_Store::switch/languages.phtml
  • Magento_Store::switch/stores.phtml

  • Header Components (Login as Customer Notice and Logout Link)

  • Magento_LoginAsCustomerFrontendUi::html/notices.phtml
  • Magento_LoginAsCustomerFrontendUi::html/notices/logout-link.phtml

  • Messaging Component

  • Magento_Theme::messages.phtml

Changelogs

Detailed changelogs are available in the CHANGELOG.md file within the codebase, or via these links:

Tooling

For general upgrade guidance, please refer to the Hyvä Theme upgrade documentation.