How to install Hyva compatibility modules

Hyvä Theme is a popular frontend solution for Magento 2, designed to enhance the performance and user experience of Magento stores. It relies on compatibility modules to integrate seamlessly with existing Magento 2 extensions.

Follow a detailed instruction guide below to ensure the proper integration of Hyvä with Magento modules you want to install in your store.

1. Prerequisites

• Magento 2 Installation: Ensure you have a Magento 2 installation compatible with Hyvä Themes. You should have Magento 2.4.x and above, but it's always recommended to use the latest version for security and performance reasons.
• Access to Server: You should have SSH access to your server and user rights to execute commands.
• Composer: Magento 2 and Hyvä use Composer for dependency management. Ensure Composer is installed and accessible on your Magento installation. Additionally, check if the PHP version is 7.4, 8.1 or 8.2.

Note: Backup your Magento installation

Before making any changes to your Magento 2 installation, it's crucial to create a backup of your system, including the database and files. This ensures you can easily revert to a stable state if anything goes wrong during the installation process.

Read on how to do a Magento backup.

2. Navigate to Magento root directory

Connect to your Magento server via an SSH and change your current directory to the root of your Magento 2 installation with the following :

cd /path/to/your/magento2

Activate Maintenance Mode:

php bin/magento maintenance:enable

This command will put your Magento store into maintenance mode, displaying a maintenance page to visitors.

After completing compatibility module installation verify that everything is working correctly, and disable maintenance mode to allow users back onto the store:

php bin/magento maintenance:disable

3. Check your Hyvä Theme

Before installing compatibility modules, you must have Hyvä Theme installed and have a valid licence. Follow these steps:

• Check the Hyvä licence key is present in the auth.json file in your Magento folder. If necessary, add the licence key to auth.json with the following commands. Replace yourLicenseAuthentificationKey and yourProjectName with the key you have obtained and your project name respectively:

  composer config --auth http-basic.hyva-themes.repo.packagist.com token yourLicenseAuthentificationKey
  composer config repositories.private-packagist composer https://hyva-themes.repo.packagist.com/yourProjectName/
  

  • Add Hyvä repository. Use Composer to add the Hyvä Theme repository to your Magento project:

  composer config repositories.private-packagist composer https://hyva-themes.repo.packagist.com/yourProjectName/
  

3. Identify required compatibility modules

Refer to the documentation of third-party extensions you are using to know which of them require compatibility modules.

Hyvä Themes provide compatibility for various popular extensions, but you need to check for each extension specifically.

Mirasvit modules compatibility with Hyvä

4. Install compatibility module

Once you've identified the required compatibility modules, you can install them. Depending on how the compatibility module is distributed, you can use Composer or manually upload the files.

Using Composer

Most Hyvä compatibility modules can be installed via Composer. For each module, follow these steps:

Use Composer to require the compatibility module. The command might look like this:

composer require hyva-themes/hyva-compatibility-magento2-module-name

Replace hyva-compatibility-magento2-module-name with the actual name of the compatibility module you're installing.

Installing compatibility module manually

If the module is not available via Composer, you may need to download its files manually from the source (for example, a GitHub repository). Upload the module files to the appropriate directories in your Magento installation.

5. Enable the Module

After installation, enable the module and run the setup upgrade process:

bin/magento module:enable VendorName_ModuleName 

bin/magento setup:upgrade

bin/magento cache:clean

Replace VendorName and ModuleName with the actual vendor and module name.

Execute the php bin/magento module:status to get the list of all modules installed in your store. In the Disabled section locate newly installed module with its name formatted as VendorName_ModuleName.

6. Test for problems

After installing the compatibility module, thoroughly test your site, focusing on the functionality related to the compatibility module of the Magento extension. Ensure that there are no conflicts and that performance meets your expectations.

If you encounter issues during installation or after installing a compatibility module, consult the documentation for the module, seek support from module developer or Hyvä Theme developer.