Installing the Magento 2 WebShopApps MatrixRates Extension

Table of Contents

• Overview
• Presumptions
• Installation Process
• Clean Install
• Updating Existing Installation
• Manual Installation
• Post-Installation Steps

Overview

Follow these steps to install your Magento 2 WebShopApps MatrixRates Extension. Proper installation ensures everything works smoothly. Be attentive to the instructions to avoid issues. If a problem arises, revisiting these steps often resolves it. 😊

Presumptions

Assuming you have Magento 2 installed properly, it's crucial to back up your server files and database before proceeding. While we take great care in our instructions, no responsibility can be claimed for any adverse effects. Initially installing on a test server for your evaluations is a wise move. 💡

Installation Process

Clean Install

1. From your root Magento directory, run:
   • composer require webshopapps/module-matrixrate
   • composer update
   • php bin/magento setup:upgrade

2. Flush and re-enable the cache if needed.

3. Remove generated file content by deleting contents of:
   • var/view_processed
   • pub/static/frontend/
   • pub/static/adminhtml/
   • var/generation

Updating Existing Installation

From your root Magento directory:

1. Update the extension using:

   • composer update
   • bin/magento setup:upgrade

2. Flush the cache.

3. Remove generated file content by deleting contents of:
   • var/view_processed
   • pub/static/frontend/
   • pub/static/adminhtml/
   • var/generation

Manual Installation

While we suggest using Composer based on Magento 2 standards, manual installation is possible:

1. Download the latest release from GitHub.

2. Extract the archive. Inside, locate the "ZIP" folder with the .zip archive.

   module-matrixrate
   ├── CHANGELOG.MD
   ├── LICENSE.txt
   ├── LICENSE_AFL.txt
   ├── README.md
   ├── Test
   │ └── Unit
   ├── ZIP
   │ └── Matrixrates M2-20.1.4.zip <-- This file
   ├── composer.json
   └── src
   ├── (etc...)
   

3. Extract the contents of the .zip archive to your Magento directory root. This action will merge into the app directory. Remove any test files or directories if present. ⚠️

4. Enable the modules using: php bin/magento module:enable WebShopApps_MatrixRate
5. Update Magento with: php bin/magento setup:upgrade
6. Clear cache and re-compile.

Post-Installation Steps

Once installed, continue to configure the MatrixRate Magento extension.