Installation

• Requirements
• Prerequisites
• Installation Guide

Requirements

ConvertixCheckout for Hyvä Theme

This module is compatible only with Hyvä Theme. Luma-based storefronts are not supported.

• Magento Community edition 2.4.4-p9, 2.4.5-p8, 2.4.6-p7, 2.4.7-p1 or higher
• PHP 8.1, 8.2, 8.3 or 8.4
• Hyvä Themes installed and activated
• Composer 2.x
• OpenSearch configured
• SSH/CLI access to the Magento server

Prerequisites

ConvertixCheckout for Hyvä Theme

This module is compatible only with Hyvä Theme. Luma-based storefronts are not supported.

Before Installation

Before installing the module, it is strongly recommended to create a full backup of your Magento instance.

Backup your Magento 2 instance

The backup feature is disabled by default. To enable, enter the following CLI command:

php bin/magento config:set system/backup/functionality_enabled 1

Then:

php bin/magento setup:backup --code --db

Restoring Magento 2 instance

First run:

php bin/magento info:backups:list

To check your backups saved into filesystem.

Then run:

php bin/magento setup:rollback -f 1434133011_filesystem.tgz -d 1434133011_db.sql

Replace 14134133011_ with your backup file name.

Composer repository file backup

cp composer.json composer.json.bak
cp composer.lock composer.lock.bak

Recommended Testing Environment

Before deploying the module to a production store, it is strongly recommended to test the installation in a development or staging environment first.

Recommended environments:

• Development domain
• Staging server
• Local Magento instance

This helps validate:

• Theme compatibility
• Third-party module compatibility
• Checkout behavior
• JavaScript functionality
• Customizations specific to the store

Example:

dev.yourstore.com
staging.yourstore.com

Installation Guide

ConvertixCheckout for Hyvä Theme

This module is compatible only with Hyvä Theme. Luma-based storefronts are not supported.

Maintenance Mode (Optional)

php bin/magento maintenance:enable

Installation Methods

Method 1 - Composer Installation (Recommended)

composer require tmgcode/module-convertixcheckout
php bin/magento module:enable TmgCode_ConvertixCheckout
php bin/magento setup:upgrade
php bin/magento setup:di:compile
php bin/magento setup:static-content:deploy -f
php bin/magento cache:flush
php bin/magento maintenance:disable

Method 2 - Manual Installation

Extract the module archive into:

app/code/TmgCode/ConvertixCheckout

Then run:

php bin/magento module:enable TmgCode_ConvertixCheckout
php bin/magento setup:upgrade
php bin/magento setup:di:compile
php bin/magento setup:static-content:deploy -f
php bin/magento cache:flush
php bin/magento maintenance:disable