1. Home
  2. Docs
  3. Magento 2 User Experience Extensions
  4. Magento 2 Gallery
  5. Installation Guide

Installation Guide

After finishing purchasing process, we will immediately send you an email containing the link to download this extension.

(Please turn off Merge-JS before installing the module. Only Turn on Merge-JS when finishing the installation).

1. Install the extension

Step 1:

Unzip the file.

Step 2:

Create another directory called app/code/Bss/Gallery/. Gallery is the module's internal identifier. You can find it in the "composer.json" file in the extension ZIP file you downloaded, look at the node "psr-4".

This is what you call the directory, and then you put the contents of the extension ZIP file in there.

Step 3:

Upload the directory app/code/Bss/Gallery/ into the root directory of your Magento installation. The root directory of Magento is the directory that contains the directories "app", "bin", "lib" and more. All directories should match the existing directory structure.

Step 4:

Go to Magento 2 root directory.

Run: php bin/magentosetup:upgrade.

Step5:

Run: php bin/magentosetup:static-content:deploy.

Step 6:

Clear all Caches.

2. Install/Uninstall/Disable the Hyva Theme Compatibility package

The following instruction is used for the Hyva theme compatibility package ONLY.

  • To install the Hyva compatibility package:

1. Install via composer, run commands:

- composer require hyva-themes/magento2-bsscommerce-gallery

*Note: When install the Hyva compatibility package via composer, you also need to install 2 other modules bsscommerce/gallery and hyva-themes/magento2-compat-module-fallback via composer

2. Install via gitlab, run commands:

- composer config repositories.hyva-themes/magento2-compat-module-fallback git git@gitlab.hyva.io:hyva-themes/magento2-compat-module-fallback.git

- composer config repositories.hyva-themes/magento2-bsscommerce-gallery git git@gitlab.hyva.io:hyva-themes/hyva-compat/magento2-bsscommerce-gallery.git

- composer require hyva-themes/magento2-bsscommerce-gallery:dev-main

- Finally, run command: php bin/magento s:up

  • To disable the Hyva compatibility package, run commands: 

- php bin/magento module:disable Hyva_BssGallery

  • To uninstall the Hyva compatibility package, run commands:

- composer remove hyva-themes/magento2-bsscommerce-gallery

*Note:

  • This module needs to install the Hyva compat base module.
  • Because Hyva theme doesn't use Fancybox library, thus the Popup Auto Play config in the module configuration can't use it
  • All images is set with max-height (image's maximum height) is 300px

After purchasing this module, just add our Skype account at support.bsscommerce, BSS Support Team will help you to install this extension immediately. Further assistance is available via Email and Skype.

In case you have followed all above steps but the extension still doesn’t work properly, you can delete the file or change the module’s filename to keep your website function as normal. Then please contact us via sales@bsscommerce.com or Skype: support.bsscommerce, our supporters will assist you in resolving any issues within 24 hours.

Was this article helpful to you? Yes No

How can we help?