etechflow / module-seo-layered-nav
etechflow/module-seo-layered-nav
SEO-friendly layered navigation: human-readable filter URLs (slug<->option-id) for Magento Open Source / Adobe Commerce, theme-agnostic (Hyva/Luma).
ETechFlow_SeoLayeredNav
SEO-friendly layered navigation for Magento 2 — turns ugly filter URLs into human-readable slugs and manages canonical/robots/sitemap for filter pages. Theme-agnostic (Hyvä + Luma). Part of the Etechflow SEO Suite.
The problem
Magento's layered navigation produces ?manufacturer=2069&blade=2071 — opaque, unindexable, and a duplicate-content minefield. This module makes those URLs readable, then controls exactly which filter combinations Google indexes.
Features
Phase 1 — Readable filter URLs (toggle: general/enabled)
?manufacturer=yaleinstead of?manufacturer=2069, fully two-way (slug ↔ option-id).- Works on dropdown filters, swatches, and inbound requests; outbound links in the layer are rewritten automatically.
- Optional multi-select (disjunctive facets — click to add a value).
- Deterministic slugs (
SlugGenerator):"Premier 2000+"→premier-2000, stable across stores and re-runs. - Aliases stored in
etechflow_seo_filter_alias. Rebuild from the admin — Marketing → SEO Filter URLs → "Rebuild SEO URLs" (one click, with an optional store-scope picker) — or viabin/magento etechflow:seo-nav:generate-aliases. Both share one code path (Model\AliasRebuilder). Run it after imports or attribute-option changes.
Phase 2 — Canonical & robots for filter pages (toggle: seo/manage_meta, gated separately)
- Single indexable filter → self-canonical +
INDEX,FOLLOW. - Multiple filters / price / non-whitelisted → base-category canonical +
NOINDEX,FOLLOW. - Configurable indexable-attribute whitelist; optional
NOINDEXon pagination. - Head-block based — renders in any theme.
Phase 2.5 — Sitemap discovery (toggle: seo/sitemap_filter_pages)
- Emits indexable single-filter landing pages into the XML sitemap (whitelist-gated, products-only, capped).
Everything is OFF by default — storefront URLs are untouched until a merchant opts in and aliases have been generated.
Install
composer require etechflow/module-seo-layered-nav
bin/magento module:enable ETechFlow_SeoLayeredNav
bin/magento setup:upgrade
bin/magento setup:di:compile # production
bin/magento etechflow:seo-nav:generate-aliases
Configure
Stores → Configuration → eTechFlow → SEO Layered Navigation: enable, choose URL format, multi-select, and (separately) the Phase 2 canonical/robots + sitemap options.
On a store already running another SEO-filter/canonical extension (e.g. Mirasvit_SeoFilter), enable Phase 1 only and leave Phase 2/2.5 off to avoid duplicate canonicals.
Compatibility
Magento Open Source / Adobe Commerce 2.4.x · PHP ≥ 8.1 · Hyvä + Luma · query-style URLs (?manufacturer=yale). Path-style (/category/manufacturer/yale) is planned for a future major version.
License
Proprietary — © eTechFlow.
Changelog
All notable changes to this module are documented here.
v1.0.0 — 2026-06-05
Initial public release.
SEO-friendly layered navigation. Readable filter URLs (slug<->option-id) + canonical/robots/sitemap control for filter pages. Hyva/Luma.
| Version | Stability | QA Status | Compatibility | Released |
|---|---|---|---|---|
| 1.2.1 | stable | Fail | Magento 2.4.7-2.4.8 Details | 2026-06-22 15:12:56 |
| 1.1.4 | stable | Not tested | Not yet tested Details | 2026-06-15 11:02:40 |
| 1.1.3 | stable | Not tested | Not yet tested Details | 2026-06-15 10:57:48 |
| 1.1.2 | stable | Not tested | Not yet tested Details | 2026-06-15 10:46:58 |
| 1.1.1 | stable | Not tested | Not yet tested Details | 2026-06-15 09:17:35 |
| 1.1.0 | stable | Not tested | Not yet tested Details | 2026-06-12 17:17:06 |
| 1.0.0 | stable | Not tested | Not yet tested Details | 2026-06-05 10:27:55 |
Requires 7
| Package | Constraint |
|---|---|
| magento/framework | >=103.0 |
| magento/module-backend | >=102.0 |
| magento/module-catalog | >=104.0 |
| magento/module-catalog-search | >=102.0 |
| magento/module-eav | >=102.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 | 156 | 4 errors, 152 warnings (ruleset: Magento2) — 77 auto-fixable with phpcbf |
| PHPMD | Warning | 39 | 39 rule violations (CyclomaticComplexity:9, NPathComplexity:9, UnusedFormalParameter:6, EmptyCatchBlock:6, MissingImport:4) |
| Cpd | Warning | 1 | 1 duplicated chunk spanning 42 total lines (min-lines=5, min-tokens=70) |
| Composer validate | Info | 7 | valid; 7 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.