Kiyoh Hyvä Compatibility plugin

The Kiyoh compatibility plugin for the Magento Hyvä theme provides Tailwind-styled, Alpine-driven templates for the Magmodules Kiyoh Reviews module, so the review page and every review widget render natively on a Hyvä storefront.

The Kiyoh compatibility plugin has the following requirements:

• Magento 2.4.x
• Hyvä Theme 1.x, up to and including the Tailwind 4 builds of 1.5 and later
• Magmodules Kiyoh Reviews 1.12.0 or later

What this plugin covers

The Kiyoh module ships its storefront as Luma templates with Knockout and LESS. Hyvä renders neither, so without this plugin the review page shows a loader that never ends and the widgets show their content without any styling. This plugin replaces those templates with Hyvä equivalents:

• Review page (/kiyoh): header with score and stars, the review list with the one-liner, opinion and recommendation per review, pagination, and the filter modal for rating and year. Built with Alpine.js on the same data the Luma page uses.
• Review widgets: Full, Small, Plain, Overview, Textual, Badge, Carousel, Sidebar and Floating.
• Review sliders: Default, Extended and Full width.

Settings, imports, invitations, product reviews and structured data stay in the Kiyoh module; this plugin only changes how the storefront is drawn. The Widget Preview page from the Kiyoh configuration (Stores → Configuration → Magmodules → Kiyoh → Widget Preview) shows every widget at once on a Hyvä store view, which is the quickest way to check a theme against all of them.

Installation

1. Install the module using composer:

composer require magmodules/magento2-hyva-kiyoh

1. Enable the module:

bin/magento module:enable Magmodules_HyvaKiyOhSR

1. Upgrade the database:

bin/magento setup:upgrade

1. Let Hyvä know about the new module:

bin/magento hyva:config:generate

1. Generate the CSS files:

npm --prefix vendor/hyva-themes/magento2-default-theme/web/tailwind/ run ci
npm --prefix vendor/hyva-themes/magento2-default-theme/web/tailwind/ run build-prod

Or from your theme:

npm --prefix app/design/frontend/<Vendor>/<Theme>/web/tailwind run ci
npm --prefix app/design/frontend/<Vendor>/<Theme>/web/tailwind run build-prod

Hyvä 1.5 and later build with Tailwind 4 and read the plugin's module.css; earlier versions read its tailwind.config.js. Both files ship, so the steps above are the same on every version.

Upgrading

After updating this plugin or the Kiyoh module, run bin/magento hyva:config:generate and rebuild the CSS (step 5) again: the templates carry their Tailwind classes, and a class that was not in the build is not in the stylesheet.

Magento Support

If you have any questions, please fill out our secure contact form by clicking here.

Magmodules & Hyvä

Magmodules and Hyvä have established a strong partnership, working closely together to provide enhanced e-commerce solutions. As an official Hyvä partner, we specialize in developing integrations for various platforms and services.

We have created integrations for well-known providers such as Mollie, Sooqr, Paazl, and many more. This collaboration ensures seamless compatibility and optimized performance for online stores utilizing the Hyvä theme.

Check out our other Hyvä plugins

• Magento 2 Hyvä Shopreview
• Magento 2 Hyvä Product Review Reminder
• Magento 2 Hyvä Feedback Company
• Magento 2 Hyvä WebwinkelKeur
• Magento 2 Hyvä Google Reviews

Changelog

All notable changes to the Kiyoh Hyvä compatibility module will be documented in this file.

[1.2.0]

Features:

• Builds with Hyvä 1.5 and later, whose Tailwind 4 reads module.css instead of tailwind.config.js; the config file stays for earlier Hyvä versions.

Improvements:

• The stars in the Full, Small and Plain review widgets and in the three sliders show the score. The width was calculated for a five-point scale, so every score above 5 showed five full stars.
• The overview widget counts the same reviews in "based on" as in the star distribution below it.
• The filter modal on the review page closes once the filters are applied.
• The floating widget gets a position when none is configured.

Compatibility:

• Magento 2.4.x
• Hyvä 1.x, including the Tailwind 4 builds of 1.5 and later
• Requires Kiyoh 1.12.0 or later.

[1.1.0]

Features:

• Seven new widgets, matching the ones Kiyoh 1.7.0 added: overview, textual, badge, carousel, sidebar, floating and plain.

Compatibility:

• Requires Kiyoh 1.7.0 or later.

[1.0.0]

Features:

• Tailwind templates for the Kiyoh review page and the Full and Small review widgets and the three sliders.