This installation process is only for the technology partners of the Hyvä Themes. If you don’t know what is Hyvä then please read this blog Hyvä Themes – The optimized theme for Magento 2
Requirements
- Magento 2.4.0 CE or higher
- A valid license for Hyvä Themes, please view https://hyva.io/license
- For licensees: A Private Packagist Key
- For partners: Access to Hyvä Gitlab
System Requirements
- The system requirements depend on the versions of Magento and TailwindCSS in use
- A node version 12.13.0 + on development instance to run the tailwind compiler. I recommend creating the bundle on development or staging instance, not on production.
- The system requirements for Magento can be found in the devdocs.
For Licensees
Please refer to the following link
For Technology Partners
You need access to all Hyvä repositories at gitlab.hyva.io . If you don’t have access to the repo then you have to contact the hyvä team to provide the access
Note: – Ensure your SSH key is set in your Hyvä Gitlab account, as well as on github.com. If you use Docker, check that you use the SSH key available in the PHP container running Composer.
Firstly Change the Magento mode to developer mode.
To configure and install Hyvä directly from Gitlab with composer, run these commands:
# hosted on private gitlab: composer config repositories.hyva-themes/magento2-theme-module git [email protected]:hyva-themes/magento2-theme-module.git composer config repositories.hyva-themes/magento2-default-theme git [email protected]:hyva-themes/magento2-default-theme.git composer config repositories.hyva-themes/magento2-reset-theme git [email protected]:hyva-themes/magento2-reset-theme.git composer config repositories.hyva-themes/magento2-theme-fallback git [email protected]:hyva-themes/magento2-theme-fallback.git composer config repositories.hyva-themes/magento2-compat-module-fallback git [email protected]:hyva-themes/magento2-compat-module-fallback.git composer config repositories.hyva-themes/magento2-email-module git [email protected]:hyva-themes/magento2-email-module.git # hosted on public github: composer config repositories.hyva-themes/magento2-graphql-tokens git [email protected]:hyva-themes/magento2-graphql-tokens.git composer require hyva-themes/magento2-default-theme --prefer-source composer require hyva-themes/magento2-compat-module-fallback
Next, run bin/magento setup:upgrade
from your project’s root and navigate to the Content > Design > Configuration
admin section and activate the hyva/default
theme.
Next, you will see the Hyvä theme store view similarly looks like this
Additional Steps:-
Some of the bundled modules are not in use yet. You may want to disable them
To disable (Magento 2.4.0 – 2.4.2): To disable (Magento 2.4.0 – 2.4.2):
bin/magento module:disable Dotdigitalgroup_Email Dotdigitalgroup_Chat Dotdigitalgroup_Sms
To disable (Magento 2.4.3 and above):
bin/magento module:disable Dotdigitalgroup_Email Dotdigitalgroup_Chat Dotdigitalgroup_ChatGraphQl Dotdigitalgroup_EmailGraphQl Dotdigitalgroup_Sms
If you are running Adobe Commerce, also disable the Dotdigitalgroup_Enterprise
module.
Hyvä theme doesn’t support the default captcha. Please disable the captcha otherwise the form will not work:
bin/magento config:set customer/captcha/enable 0
Ensure required GraphQL modules are enabled:
Please refer to this link to see the modules. Additionally, you may also see Hyva Theme Extensions.
Previous Blog Hyvä Themes – The optimized theme for Magento 2
Next blog Working with AlpineJs in Hyvä Themes
Be the first to comment.