Install Extension Using Commerce Marketplace
This guide will help you install the Mage2Plenty extension for Magento 2 using Composer via the Commerce Marketplace (repo.magento.com).
If the extension was purchased directly from our website, please refer to Composer Installation instead.
About Commerce Marketplace
Magento uses Composer to manage components and their dependencies. When you purchase an extension from Commerce Marketplace, the composer packages are automatically made available through repo.magento.com
.
Prerequisites
Before you begin, ensure you have:
- Magento Marketplace Account - Created at marketplace.magento.com
- Access Keys - Generated from your Marketplace account
- Mage2Plenty Purchase - Extension purchased from Commerce Marketplace
- System Requirements - Your environment meets all system requirements
Getting Your Access Keys
If you haven't already created Marketplace access keys:
- Log in to your Magento Marketplace account
- Go to My Profile → Access Keys
- Click Create A New Access Key
- Give it a descriptive name (e.g., "Production Server")
- Copy both the Public Key (username) and Private Key (password)
- Never commit your access keys to version control
- Add
auth.json
to your.gitignore
file - Treat your private key like a password
- Regenerate keys if they are ever compromised
Installation Steps
1. Authenticate with Marketplace
First, configure Composer to authenticate with the Magento Marketplace:
composer config --global --auth http-basic.repo.magento.com <public-key> <private-key>
Replace <public-key>
and <private-key>
with your actual Marketplace access keys.
If you prefer, you can skip this step and Composer will prompt you for credentials when needed. The credentials will then be saved automatically.
2. Verify Marketplace Repository
Ensure your composer.json
includes the Magento Marketplace repository:
{
"repositories": [
{
"type": "composer",
"url": "https://repo.magento.com/"
}
]
}
This repository is typically already configured in Magento installations. You usually don't need to add it manually.
3. Install Extension
Now you can install the Mage2Plenty extension.
For Magento Open Source
composer require softcommerce/mage2plenty-os
For Adobe Commerce
composer require softcommerce/mage2plenty-ac
The above commands will install the extension compatible with the latest Magento release.
Install Specific Version
To install an extension compatible with a specific Magento version, append the appropriate version constraint:
# For Magento 2.4.7
composer require softcommerce/mage2plenty-os ~1.15.0
# For Magento 2.4.6
composer require softcommerce/mage2plenty-os ~1.14.0
# For Magento 2.4.4
composer require softcommerce/mage2plenty-os ~1.13.0
Magento 2.4.4+ requires PHP 8.1 or higher. Ensure your environment meets all system requirements before installation.
- Latest stable version: 1.15.1
- Compatible with: Magento 2.4.7+
- Refer to Magento Version Compatibility for a complete list of compatible versions
4. Post Installation
After installing the extension via Composer, you need to run Magento's setup commands.
For Production Mode
bin/magento maintenance:enable
bin/magento setup:upgrade
bin/magento deploy:mode:set production
bin/magento maintenance:disable
In production mode, Magento will automatically:
- Compile dependency injection
- Deploy static content
- Clear caches
For Development Mode
bin/magento setup:upgrade
bin/magento setup:di:compile
bin/magento cache:flush
Verify Installation
Check that the module is installed and enabled:
bin/magento module:status SoftCommerce_PlentyCore
You should see output confirming the module is enabled.
Marketplace vs Direct Purchase
Key Differences
Aspect | Marketplace | Direct Purchase |
---|---|---|
Repository | repo.magento.com | Private Packagist |
Authentication | Marketplace Access Keys | Custom Access Token |
Updates | Through Marketplace | Through Private Repo |
Support | Via Marketplace | Direct Support |
Licensing | Marketplace Terms | Direct License |
Which Should I Use?
- Use Marketplace Installation if you purchased through Commerce Marketplace
- Use Direct Installation if you purchased directly from SoftCommerce website
Both methods install the same extension with identical functionality.
Troubleshooting
Authentication Fails
If you receive authentication errors with repo.magento.com:
- Verify your Marketplace access keys are correct
- Ensure you've accepted the Marketplace terms for Mage2Plenty
- Check that your Marketplace account is in good standing
- Try regenerating your access keys
Extension Not Found
If Composer can't find the package:
- Ensure you've purchased the extension from Marketplace
- Log in to Marketplace and verify the purchase appears in "My Purchases"
- Wait a few minutes after purchase (sometimes takes time to sync)
- Contact Marketplace support if the issue persists
Version Conflicts
If Composer reports dependency conflicts:
- Update your Magento installation to the latest patch version
- Try specifying a compatible Mage2Plenty version explicitly
- Run
composer update --dry-run
to see what would change - Check Magento Version Compatibility
Memory Limit Errors
If you encounter memory limit errors during installation:
# Increase memory limit temporarily
php -d memory_limit=-1 /usr/bin/composer require softcommerce/mage2plenty-os
Updating from Marketplace
To update the extension to the latest version:
composer update softcommerce/mage2plenty-os # or mage2plenty-ac
bin/magento setup:upgrade
bin/magento setup:di:compile
bin/magento cache:flush
We release updates every two weeks. Check the Changelog regularly or enable notifications in your Marketplace account to stay informed.
Next Steps
Now that you have Mage2Plenty installed, you can proceed to configure your connector:
- 📋 Initial Setup - Complete the initial configuration
- ⚙️ System Configuration - Configure connection settings
- 📊 Profile Setup - Set up synchronization profiles
- ✅ System Check - Verify your setup
Getting Help
If you encounter any issues during installation:
- 📧 Email Support: support@softcommerce.io
- 📞 Phone: +44 2080 587 795 (GMT working hours)
- 🛒 Marketplace Support: Through your Marketplace account
- 📖 Documentation: Browse this site for comprehensive guides
- 🐛 Bug Reports: GitHub Issues