Setup Alternate Hreflang Tags in Magento 2 using Adobe Marketplace

Important Note before Installing

If the plugin was purchased from magmodules.eu, this installation method does not apply. The steps outlined below are only for orders placed via the Adobe Marketplace. Additionally, this is the only supported installation method for Marketplace purchases other installation methods mentioned in our support section do not apply to Marketplace orders.

1. Get Access Keys from Magento Marketplace

1. Go to Magento Marketplace.
2. Log in with your Magento account.
3. Click on your profile (top-right) → My Profile.
4. Navigate to Access Keys (under the Marketplace tab).
5. If you don't have keys, generate a new one:
   • Public Key = Username
   • Private Key = Password

2. Check If Marketplace Credentials Are Set

composer config --global http-basic.repo.magento.com

This will display if credentials are currently configured. If no credentials are set, you will be prompted to enter them during the installation in step 3.

3. Install the Module via Composer

Connect to your server via SSH and navigate to the Magento root directory:

cd /path/to/magento/root

Use the following Composer command to install the module:

composer require magmodules/m2-alternate-hreflang

When prompted, enter your Public Key as the username and Private Key as the password. Composer will store these credentials for future use.

4. Enable the Module

Run the following commands:

php bin/magento module:enable Magmodules_AlternateHreflang
php bin/magento setup:upgrade
php bin/magento cache:flush

If Magento is running in production mode, recompile and deploy static content:

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

Note: The compilation and deployment steps may take several minutes to complete.

5. Verify Installation

Via Admin Panel:

1. Log in to your Magento Admin Panel.
2. Navigate to Stores → Configuration → Magmodules → Alternate Hreflang Tags.
3. Check if the module appears and start the configuration right away!

Via Command Line:

php bin/magento module:status | grep Magmodules_AlternateHreflang

The module should appear in the enabled modules list.

"Could not find a matching version of package magmodules/m2-alternate-hreflang"

Cause: Your Magento Marketplace Access Keys do not have permission to access this module.

Solution:

1. Check which credentials are currently configured:

   composer config --global http-basic.repo.magento.com

2. Verify the module is assigned to your Magento Marketplace account
3. Go to Magento Marketplace → My Profile → My Access Keys
4. Ensure you're using the correct Access Keys (the ones associated with the account that purchased/has access to the module)
5. If needed, update your credentials:

   composer config --global http-basic.repo.magento.com  

6. Try the installation again from step 3

"Authentication required (repo.magento.com)"

Cause: Composer doesn't have valid credentials stored.

Solution:

Enter your Magento Marketplace Access Keys when prompted:

• Username: Your Public Key
• Password: Your Private Key

To manually configure credentials:

composer config --global http-basic.repo.magento.com <public_key> <private_key>

"Your requirements could not be resolved to an installable set of packages"

Cause: Version conflicts or Magento version incompatibility.

Solution:

1. Check if your Magento version is compatible with the module.
2. Try updating Composer dependencies:

composer update --dry-run

3. Contact Magmodules support with your Magento version and error details.

Module Not Appearing in Admin Panel

Cause: Cache not cleared or module not properly enabled.

Solution:

1. Clear all caches:

php bin/magento cache:flush
rm -rf var/cache/* var/page_cache/* var/view_preprocessed/*

2. Verify module is enabled:

php bin/magento module:status

3. If disabled, enable it:

php bin/magento module:enable Magmodules_AlternateHreflang
php bin/magento setup:upgrade

Memory Limit Errors During Compilation

Cause: PHP memory limit too low.

Solution:

Temporarily increase memory limit:

php -d memory_limit=2G bin/magento setup:di:compile

Or permanently update php.ini:

memory_limit = 2G

Still Having Issues?

If you continue to experience problems:

1. Check the Magento error logs: var/log/system.log and var/log/exception.log.
2. Verify all prerequisites are met (PHP version, required extensions, etc.).
3. Contact Magmodules Support with:
   • Your Magento version
   • PHP version
   • Complete error messages
   • Steps you've already tried