etechflow / module-canonical-hreflang
etechflow/module-canonical-hreflang
Canonical URLs + hreflang tags for Magento 2: de-duplicates filtered/paginated/multi-category URLs and serves the right store view per locale. Part of the Etechflow SEO Suite.
Etechflow_CanonicalHreflang
Canonical URLs + hreflang tags for Magento 2 — de-duplicates the URL variants that leak SEO equity and serves the right store view per locale. Part of the Etechflow SEO Suite.
Why
Magento generates the same content under many URLs — a product reachable under several category paths, category pages with ?colour=red&price=10-20, ?p=2 pagination, and tracking-param variants. Without a clean canonical, Google splits ranking signals across all of them. This module emits one authoritative canonical per page, and for multi-store catalogues, hreflang links so each locale's customers land on the right store view.
Features
Canonical
- Product / category / CMS pages (each toggleable).
- Category-free product canonical — a product in 5 categories still has one canonical.
- Strips query parameters —
?filter,?sort,?utm_*all canonicalise to the clean URL. - Pagination control — self-referencing (
?p=2canonicalises to itself, Google-recommended) or consolidate-to-page-1. - De-dupes — removes any existing canonical (e.g. Magento core's) so you never emit two.
Hreflang
rel="alternate"links across every active store view.- Each store's code auto-derived from its Locale (
en_GB→en-gb), or overridden per store (1:en-gb). - Optional
x-default.
How it works
A single plugin on Magento\Framework\View\Result\Page::renderResult resolves the current entity and adds the <link> tags via PageConfig remote assets — so they render in any theme, including Hyvä, with no template changes. Service\CanonicalResolver and Service\HreflangResolver compute the URLs.
Install
composer require etechflow/module-canonical-hreflang
bin/magento module:enable Etechflow_CanonicalHreflang
bin/magento setup:upgrade
bin/magento setup:di:compile # production
Configure
Stores → Configuration → Etechflow → Canonical & Hreflang: master Enable, then the canonical toggles (product/category/CMS, strip-query, pagination mode) and hreflang (enable, x-default store, per-store overrides).
Tip: turn off Magento's own canonical (Catalog → Catalog → Search Engine Optimization) — this module dedupes it anyway, but disabling avoids the wasted work.
License
Proprietary — © eTechFlow.
Changelog
All notable changes to this module are documented here.
v1.0.0 — 2026-06-05
Initial public release.
Canonical URLs + hreflang tags. Dedupes filtered/paginated/multi-category URL variants and serves the right store view per locale. Theme-agnostic.
Requires 5
| Package | Constraint |
|---|---|
| magento/framework | >=103.0 |
| magento/module-catalog | >=104.0 |
| magento/module-cms | >=104.0 |
| magento/module-store | >=101.0 |
| php | ~8.1.0||~8.2.0||~8.3.0||~8.4.0 |
Compatibility
Each Magento release line is installed on its supported PHP versions, then the module is built (DI compilation + static-content deploy) and its unit and integration suites are run. The matrix shows the lines and PHP versions the module is confirmed to install and run on. Code-quality results further down (phpstan, phpcs, …) are reported separately and never affect compatibility.
Code Quality
Advisory checks against the module's source. Static analysis runs once across the whole module; PHPStan re-runs per Magento + PHP version because resolvable symbols differ between releases. These NEVER affect the Compatibility badge — a phpcs finding can't make a module incompatible.
Static analysis
Coding standards (phpcs), mess detection (phpmd), copy-pasted code (cpd), PHP cross-version compatibility, composer.json validity. Each runs once for the whole module.
| Tool | Status | Findings | Summary |
|---|---|---|---|
| PHPCS | Fail | 56 | 4 errors, 52 warnings (ruleset: Magento2) — 3 auto-fixable with phpcbf |
| PHPMD | Warning | 11 | 11 rule violations (CyclomaticComplexity:4, NPathComplexity:4, UnusedFormalParameter:2, ExcessiveClassComplexity:1) |
| Cpd | Pass | 0 | |
| Composer validate | Info | 5 | valid; 5 advisory notes (composer validate --strict) |
PHPStan
Type-checks the module's PHP against a real Magento install at the configured gate level. Re-runs per Magento and PHP version because resolvable symbols differ between releases. Cell → details modal.
Tests
Unit and integration suites, run for each applicable Magento and PHP version. A test failure speaks to the module's behaviour, not its compatibility with a Magento line, so it is reported here separately and never reddens the compatibility matrix.
Unit tests
Integration tests
| Magento | PHP 8.2 | PHP 8.3 | PHP 8.4 | PHP 8.5 |
|---|---|---|---|---|
| 2.4.7 | N/A | N/A | ||
| 2.4.8 | N/A | N/A | ||
| 2.4.9 | N/A | N/A |
Security
Security checks run directly against the module: an audit of its declared dependencies for known vulnerabilities (composer audit) and a scan of its source for malware and web-shell signatures. Each runs once. A malware detection fails the version outright.
More from etechflow
View vendorDynamic 'View Other Options/Finishes/Sizes' PDP buttons driven by per-product link attributes; replaces hardcoded in-description buttons and strips the old ones at render time.
Theme-agnostic mega menu for Magento 2. Renders on Hyvä, Luma, Adobe Commerce default and custom themes via automatic runtime detection. Provides a JSON endpoint for lazy-loaded subcategory + featured-product data.
EtechFlow Store Locator — admin-managed store/branch finder for Magento 2 with a Leaflet + OpenStreetMap map and postcode proximity search (postcodes.io). Hyva and Luma compatible. No paid map API key required.
Universal Product Fitment Finder for Magento 2 — Make/Model/Year/Part filtering on any fitment domain (automotive, motorcycle, marine, RV, phone cases, watches, appliance parts, anywhere a customer asks "will this fit my X?"). Admin-configurable labels + URL prefix so the same module rebrands to any merchant domain. Includes PDP fitment badge, SEO URLs, customer garage with cross-device sync, OEM/part-number search, and admin tooltips throughout. Theme-agnostic — Hyvä, Luma, custom themes. Renamed from "module-vehicle-compat" in v2.0.0.
Turn an existing module into recurring revenue.
If you already maintain a Magento 2 module on GitHub or GitLab, listing it on Packagento takes about five minutes. We mirror your tags, handle distribution signing, and route paid licenses through Stripe Connect, so you can keep shipping the way you already do.