README

A Magento 2 module that creates universal, store-agnostic category links for multi-language and multi-store setups that redirect to the correct localized category URL based on the current store view.

This is useful when you need a single category link that works across all store views, such as in blog posts, email campaigns, or external marketing materials.

Example

• Universal link: /category?id=124 where 124 is the category ID for "Electronics".

You can use this link in any store view, and it will redirect to the appropriate localized category URL.

Problem Solved

When managing a Magento 2 multi-store setup with different languages, category URLs differ across stores:

• English: /electronics.html
• French: /electronique.html
• German: /elektronik.html

Solves problems for blog posts, email campaigns, and any content where you need a single category link to work across all store views.

This module lets you use one universal link that automatically redirects to the correct localized category URL based on the current store.

Features

Store-agnostic category links - One link works across all languages
SEO-friendly 301 redirects - Passes link equity to final category URLs
Active category check - Only redirects to active categories Zero configuration - Works immediately after installation
Magento 2.4.7 compatible - Uses modern HttpGetActionInterface
Lightweight - No database changes, no admin configuration

Requirements

• PHP >= 8.1
• Magento >= 2.4.7
• Composer (optional, for installation via composer)

Installation

Option 1: Composer Installation (Recommended)

composer require matusstafura/magento2-category-redirect
php bin/magento module:enable MatusStafura_CategoryRedirect
php bin/magento setup:upgrade
php bin/magento setup:di:compile
php bin/magento cache:flush

Option 2: Manual Installation

1. Create module directory:

mkdir -p app/code/MatusStafura/CategoryRedirect

1. Copy all module files to app/code/MatusStafura/CategoryRedirect/

2. Enable the module:

php bin/magento module:enable MatusStafura_CategoryRedirect
php bin/magento setup:upgrade
php bin/magento setup:di:compile
php bin/magento cache:flush

Usage

Create links using category ID:

<a href="/category?id=124">View Electronics</a>
<a href="/category?id=8">Shop Women's Clothing</a>
<a href="/category?id=15">Browse Sale Items</a>

Configuration

No configuration needed! The module works out of the box after installation.

Uninstallation

php bin/magento module:disable MatusStafura_CategoryRedirect
php bin/magento setup:upgrade
php bin/magento cache:flush

# Optionally remove module files
rm -rf app/code/MatusStafura/CategoryRedirect

Compatibility

• ✅ Magento 2.4.7
• ✅ Magento 2.4.6
• ✅ Magento 2.4.5
• ✅ PHP 8.1, 8.2, 8.3

License

MIT License - See LICENSE for details.

Support

For issues, questions, or contributions:

• Create an issue on GitHub
• Submit a pull request
• Contact the author

Contributing

Contributions are welcome! Please fork the repository and submit a pull request.