Skip to content

Changelog - Hyvä Commerce

This page contains the changelog for all Hyvä Commerce features.

1.0.0 - 2025-07-11

1.0.0 is the first General Availability release for Hyvä Commerce that includes various features, bug fixes and improvements.

Please see the release notes for more details.

1.0.0 - Admin Theme

Added

  • SVG loader image to match the one used in Hyvä Theme
  • Missing arrow icon files
  • Improved responsiveness of styles at tablet size breakpoints
  • Translation CSV file

Changed

  • Directory restructure and CSS refactoring for better support of child/alternate theme variations
  • Various color and layout CSS updates to improve extensibility

Fixed

  • Styling fixes to improve output when using RedChamps Clean Admin Menu
  • Margin issue when adding sub groups to menus with top-level items only
  • Vendor icons visibility in system configuration
  • Alignment of chevron icons

Removed

1.0.1 - Admin Theme Module

Fixed

  • Update LICENSE file to latest version
  • Add missing module.xml <sequence/> for MageOS_ThemeAdminhtmlSwitcher

1.0.0 - Commerce Module

Added

  • Translation CSV file

Changed

  • Simplified system.xml translatable strings for admin logo image upload fields

Removed

  • TODO comment for missing logo variations that were added in the previous release
  • module.xml <sequence/> for MageOS_ThemeAdminhtmlSwitcher (now in Hyva_AdminTheme module)

1.0.0 - Hyvä CMS

Added

  • Image lazy loading field for 'Testimonial' and 'USP' components
  • Translation CSV file
  • Support for default LucideIcons included in magento2-theme-module:1.3.15 module
  • Fallback system for icons (it will fallback to magento2-theme-module icons if not found in the module)
  • Support for media optimisation (Hyvä Commerce)
  • Lazy loading field added to Testimonials and USP components as missing and deemed important for performance
  • Whitelist functionality for fields not mapped in components.json (e.g. user_defined_name)
  • Heading tag selection for Slider component
  • Improvements for CMS Blocks store switcher

Changed

  • All image output (for 'Image', 'Banner', 'Testimonial' and 'USP' components) now uses the \Hyva\Theme\ViewModel\Media::getResponsivePictureHtml() method added in the Hyvä Theme 1.3.15 release
    • This provides the base for future integration for the Hyvä Commerce Media Optimization functionality, without requiring a hard dependency
    • \Hyva\CmsLiveviewEditor\Block\Element::processImage() method has been deprecated as part of this implementation as is no longer required
    • The previously deprecated 'CTA' and 'Banner (basic)' templates have not been updated and still use the above deprecated method
  • Changed Link Button variant none to as link to be consistent with the Banner CTA styles
  • Moved icons to the Hyva_CmsLiveviewEditor::svg/lucide directory.
  • Refactoring and method additions made to the \Hyva\CmsLiveviewEditor\Block\Element class to provide support
  • Slideouts now full height (page settings / components edit)
  • Refactored store switching logic in liveview editor controllers to be more reliable. This was working previously but not on all environments.

Fixed

  • Issue where 3rd party modules that inject incompatible scripts via default.xml layout handle (e.g., RequireJS) were breaking the liveview editor. e.g. Mageplaza_Core::js/help.js
  • Filter page assets added to the head section in liveview editor.
  • Add custom liveview-empty.xml page_layout to prevent 3rd party modules adding assets to the body section. This is a backward-compatibility breaking change. If you have customized the Hyva CMS Editor admin page and added assets via the liveview_editor_index.xml layout handle, you must whitelist those assets in the PageConfigStructurePlugin's allowedAssets array via di.xml. See liveview-editor/etc/adminhtml/di.xmlq for an example.
  • The 'Link' field now uses URL rewrites for product and category links, resolving issues with 404s where URL suffixes or custom URL rewrites were added
  • Removed translatable strings from the Height source model as numeric values and '0' value causes bin/magento i18n:collect-phrases to error
  • Fix duplicate block ID error for CMS Block component (affected certain environments only)
  • Issue of full Varnish cache flush when publishing CMS content by replacing direct fullPageCache->clean($tags) calls with clean_cache_by_tags event dispatch, avoiding adminhtml_cache_refresh_type trigger down the stack.
  • Issue where the content state was not set correctly when a new page was created from the editor without any content added.
  • Fix preview interactivity after restoring version history item.
  • CTA component and old Banner template ignored as have been deprecated
  • Type errors in Element.php
  • Select All now selects top level items
  • Text truncation in store switcher
  • Fix handle missing form_key in iframe version preview requests for TW JIT Content update

Removed

  • Redundant cache handling logic from Hyva\CmsMagento\Model\CoreSettings\Block as it is handled in the repository save method.
  • Removed duplicated icons stored in the Hyva_CmsLiveviewEditor::svg/lucide directory.

1.0.0 - Image Editor

Added

  • Notice to module configuration to denote the 'new' media gallery is a requirement

Changed

  • Image editor background now uses a checkerboard effect to better support different background colors in admin themes
  • Various CSS enhancements to better support inheritance of colors from the active admin theme

Fixed

  • Images are now loaded into the image editor using the admin URL, resolving a CORS issue when admin URL differs to the storefront

Removed

  • Translations from the CSV file that were not unique to this module

0.6.0 - 2025-06-26

0.6.0 is a feature and compatibility release for Hyvä CMS that introduces significant improvements, performance optimizations. This release includes backward-compatibility breaking changes that require updates for custom content type extensions and custom components using children fields. Please see the release notes for more details.

0.6.0 - Hyvä CMS

Added

  • Added Tailwind safelist to tailwind.config.js and updated JIT compiler to remove safelist classes from generated stylesheets. i.e. removes the prose class from the generated stylesheets as it include a lot of style rules which already exist in most themes.
  • Support for PHP 8.4 For more information, please refer to merge request #182.
  • A unique liveview_preview key per version history item This is backward-compatibility breaking change.
    Projects that have extended Hyvä CMS for custom content types must update their Hyva\CmsLiveviewEditor\Api\ProviderInterface implementations to be compatible with this version.
  • A signout dialog which is shown when admin session ends, the session checks are by session_lifetime timeout or invalid request responses.
  • Additional checks to the content generation controller for additional validation of the request.
  • renderBlockId utility class in Element.php
  • "require_parent" option in components to hide from full list, this can be show if a parent passes it in "accepts"
  • Image dimensions to the image component.
  • Added info message in settings slideout to clarify that saving content settings updates both the draft preview and the enabled storefront block/page.
  • Cache for components list hyva_cms
    • Patch implemented to enable on production/default mode (disabled on developer)
    • Caches all collected components (components.json)
  • Tooltip utility class to ensure tooltip starts from other side
  • Re-added generate urls command
  • Batching Url requests (UrlBatchProcessor)

Changed

  • Formatting of changelog to match the Hyvä documentation, i.e. use * instead of - for bullet points.
  • Moved component template variants from JSON to PHP source models for better plugin extension support.
  • Updated components
    • Columns (text + bg color)
    • Html (classes + block id)
    • Slider (default block id + multiple instances)
    • Product slider (classes)
    • Testimonial (block id)
    • Cta (heading/paragraph colors + loading to advanced)
    • Cms block (remove bg color)
    • Banner (alignment, remove color, add heading/subtitle color, remove default typography)
    • Text (block id + classes)
    • Spacer (block id change + classes)
  • Changed how children fields are declared in the components.json file. Children fields must now be declared at the root level of the component declaration instead of within the content section. This enforces the logical hierarchy and prevents UI issues. This is a backward-compatibility breaking change. Projects with custom components using children fields must update them to follow the new schema. See upgrade documentation for migration assistance.
  • Moved page/block settings tab to slideout (seperated from main)
  • Updated UX (focus states for header buttons)
  • Refactor preview url params to use liveview_preview instead of both key & is_liveview_preview
  • Changed default value of heading component to h2 from h1.
  • Introduced a Call to Action (CTA) component as a variant of the banner
    • Includes both Split and Text layout options
  • Added configurable text and content alignment options for banner elements.
  • Enhanced banner functionality to support Button components, with a fallback to standard link behavior.
  • Refactored JIT CSS classes. This is backward-compatibility breaking change. Projects that have extended Hyvä CMS for custom content types and which support Tailwind JIT must update their implementations to use Hyva\CmsLiveviewEditor\Model\Tailwind.
  • Uses native checkbox as switch/boolean toggle instead of a button
  • Replaces JS accordion in Page/Block settings for Native HTML Details Accordion
  • UX improvements, related to A11Y, including more consistency in button styles
  • Component Panel close button icon, to avoid having two x icons close to each other
  • Magento constants for filter values
  • Move Url Models to Model/Url folder
  • Refactored status indicator in the header to use different colours and to give more meaningful information.

Fixed

  • Bug where draft content for blocks were being shown in page preview.
  • Text change in header of widget handler
  • The Liveview editor setting is no longer disabled when saving CMS Pages or Blocks when the is_liveview_enabled key is not present in the payload.
    This provides compatibility when using Adobe Commerce Content Staging to schedule updates for other block/page settings (i.e. excluding Hyvä CMS content) as well when pages/blocks are saved via other methods (e.g. custom code or via APIs).
  • Issue where image dimensions were not being preserved when the same image was selected in the image handler.
  • Double aria alert announcement fix
  • Fix empty preview toggle component list button to be CSP compatible
  • Children quick actions add button passes accepts correctly
  • Overflow issue with tooltip on right side
  • CORS issue for some multi-site setups by reverting to using admin domain for building ajax endpoint to generate content.
  • Fix TW JIT issue where classes which included the characters & and , were not being applied properly to the generated CSS.
  • Contrast A11Y issues with colors
  • Fixed extra label in icons
  • Link handler selectbox, by using interactive element
  • Landmarks with proper tag and labels
  • Tooltip label value, now uses the aria-label for visual users only, so it is not used double.
  • Better indent liveview.phtml file
  • Fix z-index to show header dropdowns while component slide-out is open
  • Copy paste issue with children (component ordering issue)
  • Link tooltip fix
  • Added missing block id to spacer
  • Url Params fix (force string)
  • Bumped cms-tailwind-jit to resolve an issue preventing the TW JIT iframe from loading on the storefront for compiling version history CSS, especially in cross-domain Admin/Storefront or CSP-restricted setups.

Removed

  • Legacy patching tool (legacy items will be handled automatically instead of a manual patch)
  • Tabs in sidebar
  • CTA component declaration
  • Unrequired filter class usage

0.5.2 - 2025-06-20

0.5.2 is a bug fix release for the Hyvä Admin Theme and base Hyva_Commerce module that addresses issues from the previous version. Please see the release notes for more details.

0.1.3 - Commerce Module

Removed

  • The default value to make the Hvyä Commerce Admin Theme the 'active admin theme' has been removed from etc/config.xml

0.1.1 - Admin Theme

Changed

  • The admin theme now depends on the Hyva_AdminTheme module and no longer depends on the Hyva_Commerce or MageOS_ThemeAdminhtmlSwitcher modules, as these are dependencies of the Hyva_AdminTheme module

1.0.0 - Admin Theme Module

Added

  • The default value to make the Hvyä Commerce Admin Theme the 'active admin theme' has been added to etc/config.xml
  • Dependency on the Hyva_Commerce and MageOS_ThemeAdminhtmlSwitcher modules

0.5.1 - 2025-06-17

0.5.1 is a feature release for initial versions of Image Editor and Admin Theme. Please see the release notes for more details.

0.1.2 - Commerce Module

Added

  • Set Hyvä Commerce Admin Theme as default
  • Hyvä Commerce default admin logos
  • Ability to add custom login, menu and favicon admin logos

0.1.0 - Image Editor

Added

  • Integration of Filerobot Image Editor into the Magento Media Gallery
  • Ability to save duplicates and revert to original images
  • Hyvä CMS support

0.1.0 - Admin Theme

Added

0.5.0 - 2025-06-04

0.5.0 is a bug fix release for Hyvä CMS that addresses issues from the previous version. Please see the release notes for more details.

0.5.0 - Hyvä CMS

Added

  • Nothing

Changed

  • quill downgrade 2.0.3 to 2.0.2 to fix   issue in richtext component.
    REF: https://github.com/slab/quill/issues/4509
  • Refactor store switcher into reusable component to be used in both toolbar and version history.

Fixed

  • Undefined array key in usp variants
    Many thanks to Klaas van der Weij (Sparkable) for the contribution!
  • CSS cascade conflict where JIT-generated classes, e.g. cmsp1_flex, overrode template Tailwind classes, e.g. lg:grid, breaking responsive layouts.
    This is a backward-compatibility breaking change. Projects that have extended Hyvä CMS for custom content types must now call the TailwindCssJit::processContentWithStyles() method rather than TailwindCssJit::prependContentStyles(). JIT styles are now injected in the head section before the main stylesheet to preserve proper CSS cascade order.
  • HyvaCompatibleOptions now only excludes Hyva/reset theme from design options. The preview store view allows all themes which are based on a Hyva theme including Hyva/reset, unless restrict_preview_to_hyva_themes is disabled.
  • JavaScript destructuring error in image handler when imageOptions is null

0.4.0 - 2025-05-29

0.4.0 is a feature and maintenance release for Hyvä CMS which introduces Tailwind JIT compilation support, an much improved link field, several bug fixes and improvements. Please see the release notes for more details.

0.4.0 - Hyvä CMS

Added

  • Component visibility control to show components in editor but hide them on frontend
  • Cut in the toolbar
  • Cut components from the quick actions
  • Copy components from the quick actions
  • Add children direct from the quick actions
  • New controllers to fetch values for the link handler
  • New options in link handler
  • Command to patch data for Hyva Liveview version upgrades
  • Improvements to layout rendering
  • Added "Edit - Hyvä CMS" option to the beginning of actions column in the CMS Pages and CMS Blocks grids.
  • Image editor event to open/close the image handler sidebar
  • Config option to restrict preview to Hyva themes only. As only Hyva themes are supported in the editor at the moment it is enabled by default. Until Luma themes are supported this setting can only be changed in config file rather than from the admin panel.
  • Search as you type filter to the store switcher

Changed

  • Switch Tailwind JIT compilation to use hyva-themes/magento2-cms-tailwind-jit for consistency across Hyvä products, class prefixing, custom config/CSS support, support for multiple themes, better scalability and portability.
    This is backward-compatibility breaking change. Projects that have extended Hyvä CMS for custom content types must update their Hyva\CmsLiveviewEditor\Api\ProviderInterface implementations to be compatible with this version.
  • Simplified liveview preview content loading on Magento admin forms using just a postMessage, AJAX call was redundant.
  • Used consistent Page loaders and messages across the editor matching brand colour guidelines.
  • Enhanced message system with dynamic status updates for improved user feedback. Maintained legacy events.
  • Removed the custom breakpoint options from the spacer component and replaced them with tailwind default values.
  • Replaced text color on the accordion component with seperate heading and content color settings on accordion items.
  • Refactored USP to component to include text and background colors.
  • Added text color options to the testimonial componenet.
  • Updated UX for the link handler
  • Updated component templates to use the new link handler
  • Using controllers instead of GraphQL for handlers
  • Minor UX updates to the image handler
  • Add prose class to richtext component by default

Fixed

  • Sharable Preview URLs which were over a day old.
  • Duplicate layered nav filters when a Hyvä CMS block is used on the page
  • Slider component layout bug using previous method for adding children
  • Removed the custom breakpoint options from the spacer component and replaced them with tailwind default values.
  • Replaced text color on the accordion component with separate heading and content color settings on accordion items.
  • Refactored USP to component to include text and background colors.
  • Added text color options to the testimonial component.
  • Sorting on CMS Pages and CMS Blocks magento admin listing grids.
  • Newly created content in the editor from returning to a new page or block form in the magento admin. Now it returns to the correct page or block form.
  • Removed logic setting the return URL from the editor. It is now handled by the Hyva_CmsMagento integration module so that it may now be set by other integration modules. Default return paths are set in the editor incase integration modules do not set them.
  • Update edited image preview to use a cache busting parameter to force reload the image.
  • Fixed issue where bullet lists were not converted to ul tags in the richtext component.

0.3.0 - 2025-05-06

0.3.0 is a feature release for Hyvä CMS that introduces new components, enhanced validation capabilities, and CSP support, along with several bug fixes. Please see the release notes for more details.

0.3.0 - Hyvä CMS

Added

  • Widget component
  • CSP support for frontend scripts used by component templates.
  • CSP support for liveview editor script for live updates to work with a Hyvä CSP theme.
  • Improvements to field validation.
  • Option to use data-[validation rule] attribute to avoid browser API validation.
  • Options to use data-[validation-message] attribute to set custom validation messages.
  • Feature to allow preview editor to focus on non-input as well as input fields when editing content.
  • Gitlab issue templates

Changed

  • Stop closing modals when clicking the backdrop
  • Move block_id to advanced section in all components
  • Added none option the the button component
  • Synced Slider Basic styles with UI version
  • Field types now require wrapping in a #field-container-[uid]_[field name] div for frontend validation.
    This is backward-compatibility breaking change for any custom field type templates which may have been added to your project. See the documentation for more information how to create a custom field type template.

Fixed

  • Validation for cms_block preview_url_key to allow .html suffix
  • Preview url validation caused by category id conflict with Hyvä CMS entity id
  • Removed random JS debugger statement
  • Translate a string (All)
  • Fix JSON in Alpine.js x-data attributes breaking during CMS directive processing
  • Preview handling to support CSP-compliant themes
  • Empty href in button component
  • Fix to validate against the correct value array vs string for links, images, etc.
  • Fix formatting & positioning of error messages to work better with frontend validation. Allows custom positioning of error messages.
  • Fixed issue where duplicate element IDs could occur in ROOT.phtml by moving child block rendering logic to a ViewModel, ensuring compatibility regardless of block class.
  • Specificity for Columns Component styles, allowing custom style override
  • Fixed issue caused by typo in iframe message type check, causing invalid preview URL message to be shown

0.2.0 - 2025-04-17

0.2.0 is a maintenance release, mostly focused on bug fixes. Please see the release notes for more details.

0.2.0 - Hyvä CMS

Added

  • CSP Support to snap slider plugin, to avoid any errors in the checkout & Hyvä CSP Default Theme

Changed

  • Accordion component refactoring & renaming
    This is a backward-compatibility breaking change
    Please refer to the 0.2.0 upgrade notes for more information on how to upgrade
  • Composer requirements to allow Symfony HTTP Foundation 7.0 for Magento 2.4.8 compatibility

Fixed

  • Hyvä theme module dependency in composer.json
  • Stray JavaScript debug statement
  • Show correct status when new content is created i.e. save/draft
  • Show warning when content is enabled but has no published version
  • Incorrect warning: "Your changes are published, but the content is disabled" shown when new content is created and not yet published
  • Regex validation for page settings on url_key to allow underscores
  • PHP 8.3 issue where null values in regex validation triggered preg_match() deprecation exception in Magento 2.4.8
  • Magewire compatibility with store codes in URLs

0.1.0 - 2025-04-11

0.1.0 is the initial Early Access Release of Hyvä Commerce. Please see the release notes for more details.

0.1.0 - Hyvä CMS

Added

  • All initial features of our new CMS solution
  • See the release notes for more details

Changed

  • Nothing changed

Removed

  • Nothing removed

0.1.1 - Hyva_Commerce

Added

  • Ability to include Alpine.js within the Admin Panel (via Layout XML handle)
  • Extension point for including Hyvä Commerce related messaging via section data (no messaging implemented at this time)
  • Abstract Type Factory and Type Mismatch Exception classes (will be utilised as part of Admin Dashboard)

Changed

  • Nothing changed

Removed

  • Nothing removed