Installation & Configuration

Hyvä Enterprise is a stand-alone commercial product, currently available to Hyvä Themes licensees only.

System requirements

Adobe Commerce 2.4.4 or higher

Current early access implementation is based on 2.4.6. Thorough testing has not yet been undertaken for 2.4.4/2.4.5, and therefore, some issues may arise. At present B2B requires 2.4.6 and above, but earlier version support is being reviewed.
Hyvä Themes 1.2.9, 1.3.5 or higher

Some older versions support earlier 1.3.x versions
Hyvä Checkout 1.1.9 or higher

This is only required if making use of checkout features, and requires a Hyvä Checkout license
PHP 7.4 or newer

See here for Adobe Commerce and the default Hyvä Theme and Hyvä Theme module release notes.

B2B Suite

Note: the below is only required if you are utilising Adobe Commerce's B2B Suite.

magento/extension-b2b 1.4.0 or higher

Support for 1.3.x to allow compatibility with Adobe Commerce 2.4.4 and 2.4.5 is being reviewed.

Please ensure you have followed Adobe's recommended installation and configuration guides.

See here for release notes.

Adobe Sensei

Note: the below are only required if you are utilising Adobe's Sensei services.

Live Search

magento/live-search 3.0.0 or higher

Please ensure you have followed Adobe's recommended installation and configuration guides.

See here for release notes.

Product Recommendations

magento/product-recommendations 5.0.0 or higher
magento/module-page-builder-product-recommendations 2.0.0 or higher
magento/module-visual-product-recommendations 2.0.0 or higher

Please ensure you have followed Adobe's recommended installation and configuration guides.

See here for release notes.

Installation

Enterprise for Hyvä Themes

Hyvä Enterprise for Hyvä Themes consists of 3 metapackages - Adobe Commerce, B2B & Adobe Sensei (Live Search & Product Recommendations) - which can be installed via your Hyvä packagist.com license key.

Install and configure all the relevant prerequisites above, including Hyvä Themes and where being utilised, Adobe's B2B suite, Live Search and Product Recommendations packages.
Run the command

For Adobe Commerce only (no B2B or Adobe Sensei)
```
composer require hyva-themes/magento2-hyva-enterprise-commerce
```
For B2B, run
```
composer require hyva-themes/magento2-hyva-enterprise-b2b
```
For Adobe Sensei (Live Search & Product Recommendations), run
```
composer require hyva-themes/magento2-hyva-enterprise-sensei
```
Both B2B and Adobe Sensei require (depend) on the base Adobe Commerce package

You do not need to specifically require the Adobe Commerce package via composer if either of B2B or Sensei are utilised.
Run the command
```
bin/magento setup:upgrade
```
Execute tailwind to generate the styles for all compatibility modules, replacing
vendor/hyva-themes/magento2-default-theme/web/tailwind/ with the path to your theme's web/tailwind folder:
```
npm --prefix vendor/hyva-themes/magento2-default-theme/web/tailwind/ ci
npm --prefix vendor/hyva-themes/magento2-default-theme/web/tailwind/ run build-prod
```

Enterprise for Hyvä Checkout

Hyvä Enterprise for Hyvä Checkout consists of 2 metapackages - Adobe Commerce & B2B* - which can be installed via your Hyvä packagist.com license key.

* Adobe Sensei in review

Support for Live Search & Product Recommendations is still in the investigatory phase to determine if any code changes are required.

Install and configure all the relevant prerequisites above, including Hyvä Themes, Hyvä Checkout and where being utilised, Adobe's B2B suite.
Run the command

For Adobe Commerce only (no B2B)
```
composer require hyva-themes/magento2-hyva-enterprise-commerce-checkout
```
For B2B, run
```
composer require hyva-themes/magento2-hyva-enterprise-b2b-checkout
```
B2B requires (depends) on the base Adobe Commerce package

You do not need to specifically require the Adobe Commerce package via composer if B2B is utilised.
Run the command
```
bin/magento setup:upgrade
```
Execute tailwind to generate the styles for all compatibility modules, replacing
vendor/hyva-themes/magento2-default-theme/web/tailwind/ with the path to your theme's web/tailwind folder:
```
npm --prefix vendor/hyva-themes/magento2-default-theme/web/tailwind/ ci
npm --prefix vendor/hyva-themes/magento2-default-theme/web/tailwind/ run build-prod
```

Checkout admin configuration

If you are utilising Customer Custom Attributes, it is recommended to configure the attributes you wish to display on the checkout address forms.

The admin configuration for both shipping and billing address forms can be found at 'Stores > Configuration > Hyvä Themes > Checkout > Components' under the respective shipping/billing groups.

Customer Custom Attributes is not yet fully supported at checkout

For more information see our compatibility tracker.