Skip to content

Getting Started with Hyvä Widgets

Hyvä Widgets are compatible with Magento 2.4.3 and newer.

Requirements

  • Magento 2.4.4 or newer
  • Hyvä Themes version 1.1.10 or higher
  • Access to Hyvä Themes via Private Packagist or gitlab.hyva.io

1. Installation

Install via composer with a valid Hyvä Theme packagist.com key:

composer require hyva-themes/magento2-hyva-widgets

Installation for contributions and technology partner

Gitlab access is required.

Note

Your public SSH key has to be set on your Gitlab profile 

composer config repositories.hyva-themes/magento2-hyva-widgets vcs git@gitlab.hyva.io:hyva-themes/magento2-hyva-widgets.git
composer require hyva-themes/magento2-hyva-widgets:dev-main

2. Enabling the module

bin/magento module:enable Hyva_Widgets
bin/magento setup:upgrade

3. Adjusting the Tailwind Purge settings

In ./app/design/frontend/[Your]/[Theme]/web/tailwind/tailwind.config.js, add the hyva-themes/magento-hyva-widgets module to the purge list configuration.

purge: {
    content: [
        ...
        '../../../../../../../vendor/hyva-themes/magento2-hyva-widgets/**/*.phtml'
    ]
}

4. Build the styles.css file

Then run npm run build-prod from the web/tailwind directory of your theme.

Configuration

Widgets can be inserted either through the Admin at Content > Widgets, or via a WYSYWIG editor / PageBuilder.