Skip to content

Overview

The Hyvä Checkout is a stand-alone commercial product, currently only available to participants of the Checkout Beta.

Can I join the Hyvä Checkout Beta?

Would you like to join the list of Beta participants?
Existing Hyvä customers and service integrators can contact us via email checkout@hyva.io.

Hyvä Checkout is the prime checkout for Hyvä Themes. It features the best integration and customizability.
To get started, it can be used with selected store views only, while keeping other checkout solutions in place for other store views.

Beta documentation

The Hyvä Checkout documentation is still being completed. Please check back frequently.
If you have any questions, please reach out on in Slack.

System requirements

  • Magento Open Source or Adobe Commerce 2.4.0 or higher
  • PHP 7.4 or newer
  • Hyvä Themes 1.1.16 or newer

Installation

Follow these steps to install Hyvä Checkout during the Beta:

  1. Ensure your public SSH key is added to your account on gitlab.hyva.io.
  2. Add the checkout beta repositories to the Magento composer.json
    composer config repositories.hyva-themes/checkout-core git git@gitlab.hyva.io:hyva-beta/checkout/checkout-core.git
    composer config repositories.hyva-themes/checkout-default git git@gitlab.hyva.io:hyva-beta/checkout/checkout-default.git
    
  3. Require the checkout-core and checkout-default packages specifying the minimum package stability of beta:
    composer require --prefer-source 'hyva-themes/checkout-core:*@beta' 'hyva-themes/checkout-default:*@beta' 'magewirephp/magewire:1.7'
    
  4. Run bin/magento setup:upgrade

  5. Run tailwind to generate the styles for the checkout, 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
    

Admin configuration

The admin configuration can be found at
Stores > Configuration > Hyvä Themes > Checkout.

Opt-in checkout

In the General section, the setting for "Checkout" defaults to "Magento Luma (original)".
To use the Hyvä Checkout, you need to change the selection to "Hyvä Default" and save the configuration.

If you create custom checkouts based on Hyvä Checkout, they will also be listed in the select.

Mobile Checkout configuration

If the optional "Mobile" checkout is enabled in the system configuration, it will be used when a visitor's user agent matches a known mobile device.

This allows presenting a different checkout experience that is optimized for mobile use.
For example, using multiple steps, rather than a one-step checkout that works better for visitors using a desktop browser.

The regular expression for matching mobile user agents can be customized in the
"Hyvä Themes > Checkout > Developer" section.

After changing any setting, be sure to flush the cache

Further settings

For now, please explore the other Hyvä Checkout configuration options on your own - most will be rather self-explanatory.
All configuration options will be added to the documentation over time.

Getting started with development

  1. Unless you already are familiar with Magewire, we suggest you first read the Magewire Introduction,
  2. and then the Hyvä Checkout Developer Documentation.

Please post any questions to an appropriate channel of the Hyvä Slack.

Measuring success

If Hyvä Checkout is introduced to an existing shop, it can be useful to compare how it performs compared to an existing Luma based checkout.

Elgentos published a small open source module to do A/B testing: elgentos/magento2-hyva-checkout-ab-test.
It is quick to set up, but do consider a large data set is to get meaningful A/B test results.