Installing Admin Theme

This guide covers installing the Hyvä Commerce Admin Theme module with Composer, both with a license key and via the Hyvä Commerce GitLab repositories for agency and technology partners. Once installed, the Admin Theme gives the Magento admin panel a modern, refreshed look and feel.

Installation

For prerequisites, see Hyvä Commerce Installation Page.

Installation via Hyvä Commerce Metapackage Recommended

The below steps are for installing Admin Theme only. While this is supported to provide greater flexibility and control over installed features, in most cases, we recommend installing all Hyvä Commerce features using our metapackage.

1. Require the hyva-themes/commerce-theme-adminhtml package:

   composer require hyva-themes/commerce-theme-adminhtml
   

2. Run a setup upgrade:

   bin/magento setup:upgrade
   

3. Clear your browser cache.

Installing as an Agency or Technology Partner

If you have access to the Hyvä Commerce GitLab repositories as a Gold/Platinum Agency Partner or a Technology Partner, you can install Hyvä Commerce in development environments using SSH key authentication.

You can configure the Git repositories in your root composer.json and use them directly as Git repos beneath your vendor directory. This lets you check out tags and branches, make commits, and push contributions.

Development Environments Only

This installation method is not suited for deployments, because GitLab requires SSH key authorization and project changes can break production deployments.

1. Make sure your public SSH key is added to your account on gitlab.hyva.io.

2. Set minimum-stability to dev in the Magento composer.json:

   composer config minimum-stability dev
   

3. Add the Admin Theme and base Hyvä Commerce module repositories to the Magento composer.json:

   composer config repositories.hyva-themes/commerce-module-commerce git git@gitlab.hyva.io:hyva-commerce/module-commerce.git
   composer config repositories.hyva-themes/commerce-theme-adminhtml git git@gitlab.hyva.io:hyva-commerce/theme-adminhtml.git
   

4. Require the hyva-themes/commerce-theme-adminhtml package using the dev-main branch:

   composer require --prefer-source 'hyva-themes/commerce-theme-adminhtml:dev-main'
   

5. Run a setup upgrade:

   bin/magento setup:upgrade
   

6. Clear your browser cache.

Additional Setup

No further steps are required. After installation, the Hyvä Commerce Admin Theme is enabled by default, unless the Mage-OS M137 Admin Theme was previously installed and its configuration was saved manually for the active theme.

For details on configuring the theme, see the configuration guide.