How to Install and Update Magefan Extensions?

All Magefan extensions for Magento are provided via Composer or archive packages, which you can download directly from product pages or your account at the Magefan website. 

Extension Installation and Updating Service

Magefan offers a professional Magento installation service that covers installing, updating, configuring and testing the extension on your instance. The installation service is provided in three stages:

  1. Onboarding & preparation — we require access to SSH or FTP (if you can get these) and your admin panel to perform installation or updating in a preferred time and method.
  2. Installation — our expert developers perform installation/update of the extensions.
  3. Configuration & testing — we configure the extension and test it on your instance to make sure there are no inconsistencies or issues with your environment.

Magefan Extensions Installation

Magefan recommends Composer as a preferred installation method since it facilitates further updates and management. However, you can also download the extension archive and paste it into your Magento root folder.

In other words, you can install the Magefan extension the same way you install extensions in Magento 2.

  • Magefan extensions installed via Composer are placed under Magento_root/vendor/magefan/module-name.
  • Magefan extensions installed via archive are organised under Magento_root/app/code/Magefan/ModuleName.

Prequisites

Before you install any Magefan extensions, you have to perform a series of actions for a secure installation. 

  • Verify if you have command-line access to the Magento root directory to run CLI commands.
  • Make sure you have full administrator access to the Magento admin panel required to enable and configure the extension. 
  • Get the product key from your Magefan account required to enable the extension.
  • Optional: create a full backup of your Magento files and database before installation. 
  • Optional: use the Magento Zero Downtime Deployment Extension to avoid downtime while installing or updating Magefan or any other extensions.

Composer installation

To install Magefan extensions via Composer, navigate to your Magefan Account and find installation instructions under Downloads > Install via Composer section of a corresponding extension.

Note: if you're installing a free version of the extension, run the following command: composer require magefan/module-name followed by deployment commands to install it. All free extension names are found on free Magefan GitHub repositories.

Archive installation

If you're installing Magefan extensions via archive, find the Download ZIP archive option under Downloads in your Magefan account and download the archive. 

Then extract the files and copy the app (in some cases app and lib) folder to your Magento root directory.

Magefan Extension Installation

Finally, run the following CLI commands to finish the installation:

php bin/magento setup:upgrade
php bin/magento setup:di:compile
php bin/magento setup:static-content:deploy

Magefan Extensions Updating

The extensions must be updated the same way they are installed.

So before updating any Magefan extensions, check if you have installed them via: archive (Magento_root/app/code/Magefan/ModuleName) or composer (Magento_root/vendor/magefan/module-name).

Note: if you installed an extension via archive and want to switch to a composer installation during the updating stage, delete the app/code/Magefan/ModuleName folder and just install the latest version of the extension via composer (see steps above).

Composer updating

If you installed the extension via composer, run the following command:

composer remove magefan/module-NAME

Then run composer installation commands from your Magefan account (Downloads > Install via Composer).

Archive updating

If you installed the extension via archive, make the backup copy of the app/code/Magefan/ModuleName on your server and remove them. 

Then download the latest version of the extension from Magefan website, extract the files and copy app (in some cases app and lib) folders from the archive to your Magento root directory. 

Don't forget to run the following commands to finish the update:

php bin/magento setup:upgrade
php bin/magento setup:di:compile
php bin/magento setup:static-content:deploy

Upgrade Extension Plan

Some Magefan extensions, like Magento 2 Blog Extension, come in different pricing plans: Basic, Plus, Extra.

If you purchased the Basic plan, but need to upgrade to Plus or Extra, contact our team to get instructions on how to do that.