Installing Admin Dashboard

Currently available in beta

Admin Dashboard is currently available in beta, which means some of the features, specifications, and details provided herein are subject to change. We recommend checking back regularly for the most up-to-date information and viewing our roadmap in regard to the general availability release.

Prerequisites

See Hyvä Commerce Prerequisites.

Installation

Separate Installation Required

During the beta phase of a new feature, new packages are not included in the main Hyvä Commerce metapackage and must be installed separately. The Hyvä Commerce metapackage can also be installed, but is not required.

With a License Key

Require the hyva-themes/commerce-module-admin-dashboard package

composer require hyva-themes/commerce-module-admin-dashboard

(optional) Require the hyva-themes/commerce-module-admin-dashboard-google-crux-history-widget package
```
composer require hyva-themes/commerce-module-admin-dashboard-google-crux-history-widget
```
(optional)* Require the hyva-themes/commerce-theme-adminhtml package
```
composer require hyva-themes/commerce-theme-adminhtml
```
Run bin/magento setup:upgrade
Make sure to clean your browser cache

*Admin Theme

While the default Magento/Adobe/Mage-OS admin themes are supported, we recommend installing the Hyvä Admin Theme for the best visual experience when using the Admin Dashboard.

For Agency and Technology Partners

If you have access to the Hyvä Commerce GitLab repositories as 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 the repositories directly as git repo's beneath your vendor directory. You can check out tags and branches, make commits and push contributions.

This installation method is not suited for deployments, because GitLab requires SSH key authorization.

Ensure your public SSH key is added to your account on gitlab.hyva.io.
Set minimum-stability to dev in the Magento composer.json
```
composer config minimum-stability dev
```

Add the Admin Dashboard 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-module-admin-dashboard git git@gitlab.hyva.io:hyva-commerce/module-admin-dashboard.git
composer config repositories.hyva-themes/commerce-theme-adminhtml git git@gitlab.hyva.io:hyva-commerce/theme-adminhtml.git

(optional) Add the Admin Dashboard CrUX Widget and Admin Theme repositories to the Magento composer.json

composer config repositories.hyva-themes/commerce-module-admin-dashboard-google-crux-history-widget git git@gitlab.hyva.io:hyva-commerce/module-admin-dashboard-google-crux-history-widget.git
composer config repositories.hyva-themes/commerce-module-admin-theme git git@gitlab.hyva.io:hyva-commerce/module-admin-theme.git
composer config repositories.hyva-themes/commerce-theme-adminhtml git git@gitlab.hyva.io:hyva-commerce/theme-adminhtml.git

Require the hyva-themes/commerce-module-admin-dashboard package

composer require hyva-themes/commerce-module-admin-dashboard:dev-main

(optional) Require the hyva-themes/commerce-module-admin-dashboard-google-crux-history-widget package

composer require hyva-themes/commerce-module-admin-dashboard-google-crux-history-widget:dev-main

(optional) Require the hyva-themes/commerce-theme-adminhtml package

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

Run bin/magento setup:upgrade
Make sure to clean your browser cache

Additional Setup

No further steps are required. For more details on how to configure Admin Dashboard settings, see the configuration guide.