README

Bring BerryPath guided selling flows to Magento 2 Hyvä category pages, product pages, and CMS content with responsive, Tailwind-based storefront templates.

This companion package works with berrypath/magento2-berrypath-flow. It uses the same Magento configuration and BerryPath Flow UUIDs; no second integration setup is required.

New to BerryPath? A free plan is available with 1 guided selling flow and up to 2,500 products. Existing customers keep using their current plan.

Built for Magento 2 Hyvä storefronts

Replaces the standard BerryPath frontend templates through Hyvä's compatibility fallback.
Supports category, product, and CMS widget placements.
Supports popup, sidebar, and inline guided selling flows.
Preserves market, locale, product identifier, and assisted conversion behavior from the main module.
Uses responsive Tailwind utility classes for banners, buttons, and inline flow containers.
Keeps the stable berrypath-flow-widget CSS classes for integrations and custom styling.

Requirements

PHP 8.1 or newer.
berrypath/magento2-berrypath-flow.
hyva-themes/magento2-compat-module-fallback.
A Magento 2 Hyvä storefront.

Composer installs the main BerryPath module and Hyvä compatibility fallback as package dependencies.

Installation

composer require berrypath/magento2-berrypath-flow-hyva-compat
bin/magento module:enable BerryPath_Flow BerryPath_FlowHyvaCompat
bin/magento setup:upgrade
bin/magento cache:flush

For local app/code development, place the module at:

app/code/BerryPath/FlowHyvaCompat

Rebuild the Hyvä theme CSS after installation when the storefront uses a production Tailwind build.

Configuration

This compatibility package adds no separate admin settings. Configure guided selling flows through the main Magento module:

Store defaults: Stores > Configuration > BerryPath > Flow
Category:       Catalog > Categories > BerryPath Flow
Product:        Catalog > Products > BerryPath Flow
CMS:            Content > Widgets > Add Widget > BerryPath Flow

Add the BerryPath Flow UUID or published widget URL to the desired placement. The Hyvä templates automatically use the configured display type, content, locale, market, and product identifier.

Template compatibility

The module registers this mapping with Hyva\CompatModuleFallback\Model\CompatModuleRegistry:

BerryPath_Flow → BerryPath_FlowHyvaCompat

Compatible templates are included for:

category.phtml
product.phtml
widget.phtml

Tailwind content sources are declared under view/frontend/tailwind/ so the module's template classes can be included in a Hyvä CSS build.

Screenshots

Ask relevant, easy-to-answer questions:

Turn shopper answers into focused product recommendations:

Use the same guided selling placements across Magento 2 Hyvä content, category, and product pages:

License

MIT. See LICENSE.

berrypath / magento2-berrypath-flow-hyva-compat

Maintainers

Package info

Statistics

Security