How to install our Magento 2 themes and extensions
Installing our Magento 2 themes and modules is available via the Swissuplabs Marketplace module or through the composer.
We recommend installing via the Swissuplabs Marketplace plugin. This way has advantages:
- The Marketplace module makes the installation process much easier and faster.
- It registers our packages repository in composer.json file and saves its credentials to the auth.json file.
- The module automates a bunch of complex commands to run via CLI and backend interface. It allows for installing and updating modules directly from the backend.
- The module provides an extendable on-click installer to simplify after-installation tasks such as the creation of CMS pages, Blocks, and Widgets, preparing category data, or even assigning product attributes to the products.
How to install extensions using Marketplace module
First, you have to install your Marketplace module. The following steps will be done for the only one time:
- Please copy the next commands and run them in console:
composer require swissup/module-marketplace &&\
bin/magento setup:upgrade &&\
bin/magento marketplace:channel:enable swissuplabs
- The last command will ask you to activate your domain in the “User name” field, and enter your key in the “Password” field. You will have to get identity key(s) and activate the domain on the site where you bought the product:
Once the Marketplace module is installed, you will be able to install all our extensions or themes you need.
There are 2 possible ways:
1/ Run the command in the terminal.
bin/magento marketplace:package:require swissup/gdpr
2/ Install the module from admin. Using graphical interface is available under System > Marketplace menu entry.
In the end, please navigate to Stores > Configuration and enable the module you need.
Possible issues and steps to troubleshooting them
Authentication error
ci.swissuplabs.com packages required authentication
composer config -a --file="var/composer_home/auth.json" http-basic.ci.swissuplabs.com "DOMAIN" "IDENTITY_KEY"
repo.magento.com packages required authentication
Admin > System > Web Setup Wizard > System Config - put Your Magento keys "Public Access Key" & "Private Access Key"
You can get keys from your Magento account page.
Problem with allocated memory
PHP Fatal error: Allowed memory size of 134217728 bytes exhausted (tried to allocate 20016669 bytes) in :
In that case, you have to run the command with next line, in the end:
php -d memory_limit=-1 bin/magento
See more about the Magento requirements 2 GB of memory for CLI commands. In order to check for free memory by server please run command: free. You will see the all memory information in the table like this:
Requirements error
How to install extensions using composer
#1 Register packages repository for the only one time. Run the commands:
composer config repositories.ci.swissuplabs.com composer https://ci.swissuplabs.com/api/packages.json
composer config -a -g http-basic.ci.swissuplabs.com "DOMAIN" "IDENTITY_KEY1 IDENTITY_KEY2 ..."
Note 1: before specifying the domain in the command line, it should be activated first on the site where you've purchased the product.
Note 2: the command supports multiple keys. You can get the identity key from one of our sites:
Note 3: In case of you’ ve just purchased a license or activated a new domain, please wait up to 5 minutes till we rebuild the packages for you.
#2 Install the module or theme package you need. Please follow the next steps:
Get the sources
composer require {{ include.package }}
Note: you have to know the package name before installation. You can find our module name at the documentation site. For example, check the name for our Firecheckout extension. There you'll find out that package name is swissup/firecheckout.
Run magento upgrade scripts
php bin/magento setup:upgrade
Remove outdated files
rm -rf pub/static/_requirejs var/view_preprocessed pub/static/frontend/ pub/static/adminhtml/ generated/code/
If you use Production Mode you need to deploy static content and run di: compile command
php bin/magento setup:static-content:deploy en_US en_GB
php bin/magento setup:di:compile