How to use a ZIP file to install an extension

By Liam Ashley
Installing a Magento extension from a zip file is a straightforward process. You will need an unzipped copy of the extension on your computer and access to your Magento install files. Here's a step-by-step guide to help you through the process.

Installing a Magento extension from a zip file is a straightforward process. You will need an unzipped copy of the extension on your computer and access to your Magento install files. Here’s a step-by-step guide to help you through the process.

1. Obtain the Extension Zip Package

From Magento Marketplace

  1. Visit My Profile > My Products > My Purchases.
  2. Select the extension version you wish to download.
  3. Click the Download button.

From Developer Stores

  1. Log into your account on the developer’s store.
  2. Navigate to My Account > My Downloadable Products.
  3. Select the appropriate Magento version and download the file.

2. Examine the Contents of the ZIP File

  1. Extract the package into a new folder on your local computer.
  2. Check for directories like Api, Block, Console. If they are not nested within app/code, you will need to create these folders manually.

Example: Mirasvit Extension

  • Path: /app/code/Mirasvit/BlogMx/

Example: TaxJar Sales Tax Automation

  • If the extension lacks nested folders, create them: /app/code/Taxjar/SalesTax/
  • Copy the contents of the zip package into the SalesTax folder.

3. Upload the Module Files to the Magento Server

  1. Copy the Module to the Magento Installation FolderUse the following command to upload the module files: bashCode kopiërenuser@remotehost:/remote/dir/ scp -r /local/dir/app This command copies the content of the local app folder to the remote path /remote/dir/.
  2. Connect to your Magento host via SSH and navigate to the Magento installation folder followed by the /app/code/ directories.
  3. Verify the successful copying of the files.

4. Complete the Installation

Make Magento Aware of the Copied Files

  1. Check the status of the modules:bashCode kopiërenphp7.3 bin/magento module:status All extensions available in your Magento installation will be listed, with disabled modules at the bottom.

Enable Modules

  1. Enable each module (replace VendorName and ModuleName with the name of your module) and clear static view files: bashCode kopiërenphp7.3 bin/magento module:enable VendorName_ModuleName --clear-static-content
  2. If your extension consists of multiple modules, activate them in the required order: bashCode kopiërenphp7.3 bin/magento module:enable Mirasvit_Core php7.3 bin/magento module:enable Mirasvit_BlogMx --clear-static-content Alternatively, activate both at the same time: bashCode kopiërenphp7.3 bin/magento module:enable Mirasvit_Core Mirasvit_BlogMx

Ensure the Extension is Enabled

  1. Check the status again to confirm the module is enabled: bashCode kopiërenphp7.3 bin/magento module:status

Register Modules and Generate Database Tables

  1. Run the setup upgrade command: bashCode kopiërenphp7.3 bin/magento setup:upgrade

Compile Magento Project

  1. Recompile your Magento project:bashCode kopiërenphp7.3 bin/magento setup:di:compile

Deploy Static View Files

  1. Deploy static view files:bashCode kopiërenphp7.3 bin/magento setup:static-content:deploy -f

Clear Cache

  1. Clear all cache:bashCode kopiërenphp7.3 bin/magento cache:flush

5. Customize the Newly Installed Extension

Return to the Magento admin panel to customize and configure the newly installed extension as necessary.

By following these steps, you will have successfully installed a Magento extension from a zip file and ensured it is fully integrated into your Magento installation.

Information checked and edited by Liam Ashley

Last updated: August 9, 2024....
Liam Ashley is a highly skilled e-commerce specialist with a deep expertise in Magento 2. With over a decade of experience in the industry, Liam has become a prominent figure in the e-commerce landscape, known for his innovative solutions and strategic insights. Currently serving as the lead Magento 2 developer
Read more about Liam
Stay in the loop
Now you can update. Receive product updates, new and successful versions from Magstack customers directly in my mailbox.