etechflow / module-vehicle-compat

etechflow/module-vehicle-compat

Universal Product Fitment Finder for Magento 2. Make/Model/Year/Part filtering on any fitment domain — automotive, motorcycle, marine, RV, bicycle, phone accessories, watch straps, appliance parts, or any product where customers ask "will this fit my X?". Admin-configurable labels and field visibility. SEO-friendly URLs, PDP fitment badges, customer garage. Theme-agnostic — Hyvä, Luma, custom themes.

magento2-module Compatibility: Not yet tested Code Quality: Pending Tests: N/A Security: Pending proprietary
Viewing version 1.1.1. Latest version is 1.2.1. Switch to latest

ETechFlow_VehicleCompat — Vehicle Compatibility + Part Finder for Magento 2

A complete vehicle compatibility (Make / Model / Year / Part) system for Magento 2 stores selling automotive products. Theme-agnostic by design — bundles its own Alpine.js loader so it works on Hyvä, Luma, and any custom theme without code changes.

  • Version: 1.0.0
  • Package: etechflow/module-vehicle-compat
  • Magento: 2.4.4 – 2.4.8
  • PHP: 8.1, 8.2, 8.3
  • License: proprietary (see LICENSE.txt)
  • Vendor: ETechFlow — https://etechflow.com

What's in the box

Two halves of one feature, intentionally bundled in one module:

Half 1 — Vehicle compatibility data

  • vehicle_compat_data product attribute (JSON) storing every (Make, Model, Year) combination a product fits.
  • parts_required product attribute (multi-select) tagging which part-types each product covers (key blade, transponder, immobilizer chip, etc.).
  • Admin CRUD for Makes and Models under Catalog → Vehicles → Makes / Models.
  • CSV import for bulk-loading vehicle compatibility data (bin/magento etechflow:vehiclecompat:import-parts).
  • Product edit form modifier — a visual Make/Model/Year picker tab on every product, so the admin doesn't hand-edit JSON.

Half 2 — Part Finder widget

  • /vehiclecompat/options/index — server-side filtered options endpoint. Each dropdown click sends field=make|model|year|part + current selections, server applies bidirectional filter and returns only matching options.
  • /vehiclecompat/tree/index — full vehicle tree (cached, browser-cacheable for 1h).
  • /vehiclecompat/find/index — find-parts results page that filters the catalog by the customer's vehicle.
  • Shareable form fragment (ETechFlow_VehicleCompat::partfinder/form.phtml) that drops into any layout — header modal, hero section, PDP sidebar, all use the same template.
  • Self-contained Alpine.js bootstrap — on Hyvä stores Alpine is already loaded; on Luma / custom themes the bootstrap lazy-loads Alpine from a CDN (URL is overridable for stores that want to self-host).
  • Shared Alpine store so multiple form instances on the same page (desktop hero + mobile hero + header modal) stay in sync.

Theme compatibility

Theme Status What happens
Hyvä (Tailwind + Alpine) ✅ Native Alpine is global. The bootstrap shim becomes a no-op. Module just works.
Luma / Blank ✅ With bootstrap The bootstrap shim detects no Alpine and lazy-loads it from a CDN. Module works.
Custom themes (Luma parent) ✅ With bootstrap Same as Luma.
Custom themes (Hyvä parent) ✅ Native Same as Hyvä.
Air-gapped / no-CDN stores ⚠️ Self-host Alpine Replace the CDN URL in view/frontend/web/js/alpine-bootstrap.js with your self-hosted Alpine URL, or pre-install Alpine in your theme.
Headless / PWA Studio ⚠️ Use API only Use /vehiclecompat/options/index directly from your headless storefront. The PHP-rendered form fragment is skipped in headless.

See COMPATIBILITY.md for the full audit.


Quick start

# 1. Extract into your Magento root
unzip etechflow-module-vehicle-compat-1.0.0.zip -d <magento-root>/

# 2. Enable + migrate (creates DB tables + product attributes)
cd <magento-root>
bin/magento module:enable ETechFlow_VehicleCompat
bin/magento setup:upgrade
bin/magento setup:di:compile      # production-mode only
bin/magento setup:static-content:deploy -f
bin/magento cache:flush

# 3. Visit the admin
open https://your-store.example.com/admin/etechflow_vehicle/make/index
# (Admin sidebar → Catalog → Vehicles → Makes / Models)

# 4. Embed the Part Finder on your homepage / header
#    Reference: USAGE.md → "Embedding the Part Finder form"

Documentation index

File Purpose
README.md Overview, features, theme matrix (this file)
INSTALL.md Manual + Composer install + verification + troubleshooting
USAGE.md Admin walk-through (Make/Model CRUD, product editor, CSV import) + how to embed the Part Finder widget
CONFIGURATION.md Alpine bootstrap CDN URL, server-side filter behavior, caching
COMPATIBILITY.md Theme + Magento + PHP matrix and the design choices that keep it portable
CHANGELOG.md Version history
UNINSTALL.md Clean removal
LICENSE.txt proprietary license

Support

  • Email: [email protected]
  • Include: Magento version, PHP version, active theme, sample product with vehicle data, screenshot.

License

proprietary — see LICENSE.txt.

Changelog — ETechFlow_VehicleCompat

[1.1.1] — 2026-06-03 — Truly universal frontend copy + close the v1.1.0 garage UX gaps

v1.0.2 made the dropdown LABELS configurable so non-vehicle merchants
could rebrand "Make / Model / Year / Part" to "Brand / Phone /
Generation / Style". v1.1.1 finally makes the surrounding chrome
configurable too — the button text, page title, empty-state messages
were still hardcoded automotive copy in v1.1.0, leaking the vehicle
vibe into phone-case / watch-strap / appliance merchant shops.

Also closes the v1.1.0 Customer Garage UX gaps that left the feature
practically invisible to first-time customers.

Added (universal customer-facing copy)

Five new admin fields under Stores → Configuration → eTechFlow →
Vehicle Compatibility → Customer-Facing Copy (v1.1.1)
:

  1. Find Button Text — default Find Parts. Replaces v1.1.0's
    all-caps FIND PARTS shouting button. Phone-case shops:
    Find Cases. Watch shops: Find Straps. Filter shops: Find Filters.
  2. Find Page Title — default Find Your Parts. The <h1> on the
    search results page. Customisable per merchant domain.
  3. Empty State Message — default
    Pick a {make}, {model}, {year} or {part} to see matching products.
    Supports four placeholders that auto-expand to the merchant's
    configured field labels
    :
    • {make} → expands to whatever Make Label is set
    • {model} → Model Label
    • {year} → Year Label
    • {part} → Part Label
      So if the merchant renamed Make → Brand, the empty state
      automatically reads "Pick a Brand, Model, Year or Part…" with zero
      extra edits.
  4. Save Selection Button Text — default Save Selection. Text on
    the new save-to-garage button.
  5. Garage Empty-State Prompt — default Save a selection here for one-click reload later. Friendly nudge shown in the My Garage
    widget when nothing is saved.

Added (close v1.1.0 garage UX gaps)

  • "💾 Save Selection" button on the Part Finder form, right next
    to the Find button. Visible only when:
    • the Customer Garage is enabled in admin, AND
    • the customer has picked at least a Make (button uses x-show="selectedMake")
      Clicking it calls the existing window.etechflowGarageSave()
      helper, persists to localStorage, and flips a brief "✓ Saved!"
      micro-interaction (~1.5s) so the customer gets feedback.
  • My Garage empty state — instead of rendering nothing when no
    vehicles are saved, the widget now shows a small bookmark icon +
    the configurable prompt. Customers discover the feature on first
    visit instead of never knowing it exists.

Changed

  • view/frontend/templates/partfinder/form.phtml:
    • The Find button now uses $block->getFindButtonText() instead of
      hardcoded __('FIND PARTS'). Mixed-case by default; merchants
      can SHOUT_CASE if they want to.
    • Wrapped Find button + new Save button in a .vc-actions flex
      container so they sit side-by-side.
  • view/frontend/templates/find/results.phtml:
    • <h1> now reads $block->getFindPageTitle().
    • Empty-state copy now uses $block->getEmptyStateMessage() with
      label substitution.
  • view/frontend/templates/find/chips.phtml: same empty-state
    treatment.
  • view/frontend/templates/garage/widget.phtml: empty-state UI
    block + supporting CSS.
  • view/frontend/web/js/part-finder.js: new transient
    savedFeedback Alpine state for the Save button confirmation.
  • Model/Config.php: 5 new getters
    (getFindButtonText, getFindPageTitle, getEmptyStateMessage,
    getSaveButtonText, getGarageEmptyPrompt). The empty-state
    getter applies placeholder substitution from the label getters.
  • Block/PartFinderData.php: exposes the new getters to templates.
  • Block/Garage.php: same.
  • Block/FindResults.php: now injects Model\Config to expose
    getFindPageTitle() and getEmptyStateMessage().

Hardening

  • Setup/Patch/Data/V111ReleaseMarker.php — always-a-patch discipline.

Not changed

  • No schema changes — drop-in upgrade from 1.1.0.
  • No URL changes.
  • No API changes.
  • Default behaviour for installs that don't touch the new copy fields
    is functionally equivalent to v1.1.0 (with cosmetic improvements:
    mixed-case button, garage empty state visible).

Migration

composer require etechflow/module-vehicle-compat:^1.1.1
bin/magento setup:upgrade
bin/magento setup:di:compile
bin/magento setup:static-content:deploy -f
bin/magento cache:flush

Pre-flight check:

SELECT module, schema_version, data_version FROM setup_module
WHERE module='ETechFlow_VehicleCompat';

Both should read 1.1.1. If data_version is stale, re-run
setup:upgrade — do NOT flush cache yet.

To opt in to universal copy:

  • Visit Stores → Configuration → eTechFlow → Vehicle Compatibility →
    Customer-Facing Copy
  • Set merchant-specific button/title/empty-state text
  • For non-vehicle stores, also set the field labels under General
    Settings (Make → Brand, etc.) and the placeholders in your empty-
    state message will auto-expand to match

Verified

  • PHP lint: 59/59 clean
  • XML: 25/25 clean
  • Local Docker: setup:upgrade advanced 1.1.0 → 1.1.1, V111ReleaseMarker
    landed in patch_list (id 215), all 5 new Config getters return
    correct defaults, empty-state placeholder substitution confirmed
    ("Make → Brand" relabel → "Pick a Brand, Model, Year or Style…").

[1.1.0] — 2026-06-03 — Amasty-competitor feature set: PDP fitment badge, SEO URLs, customer garage, universal positioning

Four major additions that turn this from "Vehicle Compatibility v1.0"
into a credible competitor to Amasty Product Parts Finder (~$399).
All features are opt-in via admin config — defaults preserve v1.0.x
behaviour exactly, so existing installs see no change unless they
intentionally enable one.

Added

1. PDP fitment badge

Renders a coloured "Fits: BMW 3 Series 2018-2023" block under the price
on every product detail page where the product has vehicle compatibility
data assigned. The most-requested Amasty-parity feature — signals
"yes this fits your car" right at the purchase-decision moment.

  • New block: Block/Product/FitmentBadge — resolves the product's
    vehicle_compat_data JSON attribute against the Make/Model tables,
    formats human-readable strings ("BMW 3 Series 2018-2023" — year
    ranges collapsed when contiguous, listed individually otherwise),
    and de-dupes across parts_required entries.
  • New template: view/frontend/templates/product/fitment-badge.phtml
    — inline-styled HTML that survives email clients and theme overrides.
  • New layout: view/frontend/layout/catalog_product_view.xml
    injects the badge into product.info.main after product.info.price.
  • Admin config under Stores → Configuration → eTechFlow → Vehicle
    Compatibility → PDP Fitment Badge
    :
    • Show Fitment Badge on Product Page (Yes/No, default No)
    • Badge Prefix Text (default "Fits:" — set to "Compatible with:" or
      "Made for:" for different tones)
    • Badge Style (success/info/warning/neutral — colour treatment)
  • Inline limit: max 3 vehicles per badge; surplus shown as
    "and N more". Keeps PDP layouts clean for parts that fit dozens of
    vehicles.

2. SEO-friendly URLs

Maps /parts/bmw/3-series/2020/brake-pads to the Part Finder Find
action. Massive SEO improvement over query-string URLs — Google ranks
slug-based URLs significantly better, social-share previews look
clean, link sharing is human-readable.

  • New router: Controller/Router/FitmentRouter — implements
    Magento\Framework\App\RouterInterface. Matches the configured
    prefix + Make/Model/Year/Part slugs, resolves slugs back to IDs via
    case-insensitive name lookup, forwards to vehiclecompat/find/index
    with proper params.
  • New DI: etc/frontend/di.xml — registers the router with
    sortOrder 30 (before CMS router but after standard).
  • Backward-compatible: when enabled, BOTH old query-string URLs
    AND new path-based URLs work — old shared links don't break.
  • Slug-tolerant: "3-series" matches "3 Series", "land-rover"
    matches "Land Rover" (case-insensitive, space → dash normalisation).
  • Admin config under Stores → Configuration → eTechFlow → Vehicle
    Compatibility → SEO-Friendly URLs
    :
    • Enable SEO URLs (Yes/No, default No)
    • URL Prefix (default "parts" — use "fitment" / "for" / "compatibility"
      for different vibes; lowercase alphanumeric + dash only, anything
      else stripped, invalid values fall back to "parts")

3. Customer "My Garage" widget

Customers save their vehicle for one-click reload across sessions.
Top-3 conversion driver in parts e-commerce per Amasty's own marketing.

  • New block: Block/Garage — renders the widget when enabled.
  • New template: view/frontend/templates/garage/widget.phtml
    Alpine.js-driven, reads from localStorage, shows saved vehicles
    with one-click reload + individual remove + clear-all.
  • v1.1.0 MVP: localStorage-based. Guest + logged-in customer get
    the same experience. v1.2.0+ will add customer attribute storage
    for logged-in users so the garage syncs across devices.
  • Merchant placement: any layout XML reference or CMS block — the
    README documents the standard placement patterns (header, sidebar,
    hero, account page).
  • Auto-saves on Part Finder use: the existing Alpine store
    vehicleCompatSel integrates with the garage automatically — no
    extra clicks for the customer.
  • Per-store-view scoped: storage key includes the store ID so
    different stores don't share garages (different catalogs, different
    vehicle IDs).
  • Admin config under Stores → Configuration → eTechFlow → Vehicle
    Compatibility → Customer Garage
    :
    • Enable Customer Garage (Yes/No, default No)
    • Maximum Vehicles per Customer (default 3 — clamped 1-10;
      sweet spot for "my car, my wife's car, my work van")

4. Universal positioning

The composer.json description now leads with "Universal Product
Fitment Finder for Magento 2" instead of "Vehicle Compatibility".
The same code that already works for any fitment domain via the
v1.0.2 configurable labels is now positioned for it. Sells to:

  • Automotive (still the primary)
  • Motorcycle / marine / RV / ATV / bicycle parts (already worked)
  • Phone cases (Make→Brand, hide Year, Earliest Year=2007)
  • Watch straps (Brand/Watch//Strap Size)
  • Printer cartridges, appliance parts, industrial fittings —
    anywhere the customer asks "will this fit my X?"

Added (supporting infrastructure)

  • Model/Source/BadgeStyle.php — source model for the PDP badge
    style dropdown (success / info / warning / neutral).
  • Eight new Config getters: isShowFitmentBadgeOnPdp(),
    getFitmentBadgePrefix(), getFitmentBadgeStyle(),
    isSeoUrlsEnabled(), getSeoUrlPrefix(), isSavedGarageEnabled(),
    getGarageMaxEntries(), and the BADGE_STYLES whitelist for
    clamping.
  • Setup/Patch/Data/V110ReleaseMarker.php — continues the always-a-
    patch discipline.

Not changed

  • No schema changes — drop-in upgrade from 1.0.3.
  • No breaking changes — every new feature is opt-in (default off).
    Existing v1.0.x installs that don't touch the new config groups see
    zero behaviour change.
  • No API changes — public block + service methods unchanged.

Migration

composer require etechflow/module-vehicle-compat:^1.1.0
bin/magento setup:upgrade
bin/magento setup:di:compile
bin/magento setup:static-content:deploy -f
bin/magento cache:flush

Pre-flight check:

SELECT module, schema_version, data_version FROM setup_module
WHERE module='ETechFlow_VehicleCompat';

Both should read 1.1.0. If data_version is stale, re-run
setup:upgrade — do NOT flush cache yet.

To opt in to v1.1.0 features:

  • PDP badge: Stores → Configuration → eTechFlow → Vehicle
    Compatibility → PDP Fitment Badge → Enable
    = Yes
  • SEO URLs: ...SEO-Friendly URLs → Enable = Yes (and decide on
    a prefix — "parts" is a safe default)
  • Garage: ...Customer Garage → Enable = Yes (and place the
    widget in your theme's layout XML or a CMS block)

Competitive positioning

Feature Amasty PPF (~$399) This module (v1.1.0)
Universal fitment ✅ (since v1.0.2)
Configurable labels ✅ (since v1.0.2)
Multi-axis (2-5 levels) ⚠️ Fixed 4 axes (Make/Model/Year/Part)
PDP fitment badge
SEO URLs
Saved garage ✅ (localStorage MVP)
Customer-attribute garage sync v1.2.0
CSV import
OEM/part-number search ✅ Pro v1.3.0
Multiple finders per store v1.3.0

Credible alternative at a fraction of the price.


[1.0.3] — 2026-06-03 — Restore docs accidentally pruned during v1.0.2 publish-repo sync

The v1.0.2 release shipped clean code but the publish-repo rsync
accidentally deleted the top-level documentation files
(INSTALL.md, USAGE.md, CONFIGURATION.md, COMPATIBILITY.md,
UNINSTALL.md) that ship at the repo root alongside README and
CHANGELOG. This release restores them.

No code change. No behaviour change. Pure documentation file
restoration plus V103ReleaseMarker for always-a-patch discipline.

If you installed 1.0.2 you're functionally fine — composer doesn't
care about INSTALL.md vs not. But the GitHub repo page was missing
those docs and 1.0.3 puts them back.

Migration

composer require etechflow/module-vehicle-compat:^1.0.3
bin/magento setup:upgrade
bin/magento cache:flush

[1.0.2] — 2026-06-03 — Universal fitment: admin-configurable labels, Year bounds, optional Year field

Same module, three new admin knobs that make it work for any
product-fitment domain — not just vehicles. Drop-in upgrade from
1.0.1, no schema change, no breaking change. Default behaviour
identical to 1.0.1 (Year field visible, "Make/Model/Year/Parts"
labels, year range 1990 – current).

Added

Three new admin fields under Stores → Configuration → eTechFlow →
Vehicle Compatibility → General Settings
:

  1. Earliest Year — text field, default 1990. The oldest year
    that appears in the Year dropdown. Set to 1950 for vintage car
    parts shops (classic Mustangs, Series Land Rovers). Set to 2007
    for smartphone-fitment shops where there's no point listing
    pre-iPhone years. Anything below 1900 or above the current year
    gets clamped to safe bounds.

  2. Show Year Field — Yes/No, default Yes. When No, the Year
    dropdown disappears from the Part Finder form. The form becomes
    Make → Model → Parts, which is what phone case shops, watch strap
    shops, printer cartridge shops, and appliance parts shops actually
    need.

  3. Field Labels — 4 separate text fields for the customer-facing
    labels:

    • Make Field Label (default "Make") — set to "Brand" for
      phone cases / watches / appliances
    • Model Field Label (default "Model") — set to "Phone" /
      "Watch" / "Appliance Model"
    • Year Field Label (default "Year") — set to "Generation"
      for phones, "Year of Manufacture" for older fitments
    • Parts Field Label (default "Parts Required") — set to
      "Type" / "Style" / "Strap Size" / "Component"

    When the labels are configured, the Part Finder dropdowns render
    the merchant's wording instead of "Select Make / Select Model /
    etc." A blank label falls back to the default.

Changed

  • Model/Source/Year.phpMIN_YEAR constant is now
    @deprecated; the year source reads from Config::getEarliestYear()
    instead. Constant kept on disk so any third-party code referencing
    it doesn't immediately fatal.

  • Block/PartFinderData.php — gains 5 public getters:
    getMakeLabel(), getModelLabel(), getYearLabel(),
    getPartLabel(), isYearFieldEnabled(). Templates and any
    custom integration can read the configured values.

  • view/frontend/templates/partfinder/form.phtml — uses the
    configured labels for placeholder texts; wraps the Year field
    block with if ($block->isYearFieldEnabled()) so it can disappear
    entirely when not relevant.

  • Setup/Patch/Data/V102ReleaseMarker.php — no-op release
    marker patch, depends on V101.

Why this matters

This release transforms the module from "Vehicle Compatibility" into
a "Universal Product Fitment Finder". The same code now sells to:

  • Auto parts (as before — Make/Model/Year/Parts works perfectly)
  • Motorcycle / marine / RV / ATV / bicycle parts (same labels work)
  • Vintage car parts (set Earliest Year to 1950)
  • Phone cases (set labels to Brand/Phone/Generation/Style, hide
    Year, set Earliest Year to 2007)
  • Watch straps (Brand/Watch/<hide year>/Strap Size)
  • Printer cartridges (Brand/Printer/Year/Cartridge Type)
  • Appliance parts (Brand/Appliance Model/Year/Part Type)
  • Any product fitment problem the merchant can map to 2-4 axes

Competing against Amasty Product Parts Finder (~$399) at a fraction
of the price.

Not changed

  • No schema changes — drop-in upgrade from 1.0.1
  • No URL changes — existing /vehiclecompat/find/index URLs keep working
  • No API changes — public block + service methods unchanged
  • Default behaviour identical to 1.0.1 — merchants who don't touch
    the new fields see no change at all

Migration

composer require etechflow/module-vehicle-compat:^1.0.2
bin/magento setup:upgrade
bin/magento setup:di:compile
bin/magento cache:flush

Pre-flight check:

SELECT module, schema_version, data_version FROM setup_module
WHERE module='ETechFlow_VehicleCompat';

Both should read 1.0.2. If data_version is stale, re-run
setup:upgrade — do NOT flush cache yet.

To opt in to the universal-fitment positioning:

  1. Set your merchant's label preferences in
    Stores → Configuration → eTechFlow → Vehicle Compatibility →
    General Settings
    .
  2. If your fitment domain doesn't use year, set Show Year Field to No.
  3. Save → flush cache → reload the Part Finder.

[1.0.1] — 2026-06-03 — Brand de-leak: rename Keystation-derived routes, files, and CSS classes

Cosmetic but important release. Renames every customer-visible and
admin-visible identifier that still carried the original developer's
"Keystation Vehicle Compatibility" (kvc) / "Keystation" branding, so the
module ships as a generic eTechFlow product any merchant can install
without seeing another shop's name in their URLs or DevTools.

Changed (customer-facing)

  • URL prefix renamed: frontName="kvc"frontName="vehiclecompat".
    Part Finder page is now at /vehiclecompat/find/index instead of
    /kvc/find/index. The Options + Tree AJAX endpoints follow:
    /vehiclecompat/options/index, /vehiclecompat/tree.json.
  • Frontend JS file renamed: view/frontend/web/js/kvc-part-finder.js
    part-finder.js. The Alpine.js function inside is now
    vehicleCompatPartFinder() (was kvcPartFinder()), and its store key
    is 'vehicleCompatSel' (was 'kvcSel').
  • CSS class prefix: kvc-*vc-* across all templates (vc-row,
    vc-ico-left, vc-trigger, vc-side, vc-find-page, vc-pager,
    vc-cat-chips, etc.). Keeps the prefix short while removing the
    Keystation branding.
  • Frontend layout file: view/frontend/layout/kvc_find_index.xml
    vehiclecompat_find_index.xml.
  • Block names in layout XML: kvc.sidebar.summary /
    kvc.category.filter.chipsvehiclecompat.sidebar.summary /
    vehiclecompat.category.filter.chips.

Changed (admin-facing)

  • 11 admin layout + UI component files renamed from
    keystation_vehicle_* to etechflow_vehicle_* so they match the
    module's existing admin route id (etechflow_vehicle). Previously
    they were dead-code on disk (route id and file name didn't match;
    Magento auto-loads layout by URL pattern). Renaming gets them back
    on the auto-load path under the canonical eTechFlow naming.

Added

  • Setup/Patch/Data/V101ReleaseMarker.php — no-op release marker
    patch. Continues the always-a-patch discipline. Depends on the three
    v1.0.0 data patches so patches run in version order.

Breaking changes ⚠

Anyone who installed v1.0.0 in the ~1 hour between v1.0.0 and v1.0.1
publication will see the Part Finder URL change. No real customers
were installed at the time of this release. Bookmarks pointing at
/kvc/find/index will 404 — clients should update to
/vehiclecompat/find/index.

If you've embedded the Part Finder form in CMS blocks or themes via
JavaScript, the Alpine.js function call needs renaming:
kvcPartFinder()vehicleCompatPartFinder(). Same for any
Alpine.store('kvcSel') references.

Why this exists

The original developer of this module built it first for the Keystation
brand and then handed the code to eTechFlow. The brand prefixes
(kvc/, keystation_vehicle_*) survived the rebadge. v1.0.0 shipped
with that leak. v1.0.1 cleans it up so the module sells generically.

Migration

composer require etechflow/module-vehicle-compat:^1.0.1
bin/magento setup:upgrade
bin/magento setup:di:compile
bin/magento setup:static-content:deploy -f
bin/magento cache:flush

Pre-flight check after upgrade:

SELECT module, schema_version, data_version FROM setup_module
WHERE module='ETechFlow_VehicleCompat';

Both columns should read 1.0.1. If data_version is stale, re-run
setup:upgrade — do NOT flush cache yet.

After upgrade, the Part Finder page is at /vehiclecompat/find/index.
A merchant who wants to preserve the old /kvc/* URLs can ship a
custom URL rewrite from /kvc/* to /vehiclecompat/* in their web
server config — but a fresh install no longer publishes any /kvc/*
URLs at all.


1.0.0 — 2026-05-20

First public release as a standalone, theme-agnostic Magento 2 module.

Added

  • Vehicle compatibility data
    • vehicle_compat_data product attribute (JSON) — Make / Model / Year tuples per product
    • parts_required multi-select product attribute
    • Admin Makes CRUD under Catalog → Vehicles → Makes
    • Admin Models CRUD under Catalog → Vehicles → Models
    • Product editor tab with visual Make/Model/Year picker (no hand-edited JSON)
    • CSV import command: bin/magento etechflow:vehiclecompat:import-parts
  • Part Finder widget
    • Reusable form fragment (ETechFlow_VehicleCompat::partfinder/form.phtml) — embed anywhere
    • Server-side filtered options endpoint /vehiclecompat/options/index (bidirectional)
    • Full vehicle tree endpoint /vehiclecompat/tree/index (cached, browser-cacheable)
    • Find-parts results page /vehiclecompat/find/index with category chips
    • Shared Alpine store keeps multiple form instances in sync (header modal + hero + sidebar)
  • Theme-agnostic JS bootstrap
    • alpine-bootstrap.js detects Alpine, lazy-loads it from CDN if absent
    • part-finder.js factory function — loaded once via layout XML
    • Both loaded on every storefront page via view/frontend/layout/default.xml
  • Scoped namespaced CSS
    • .vc-* class prefix prevents theme collisions
    • Inline <style> block in partfinder/styles.phtml
  • Catalog filter integration
    • Plugin\Catalog\Layer\FilterByVehicle narrows product collections by ?make_id=&model_id=&year=&part_id= URL params
    • Plugin\Catalog\Block\HideLayeredNav hides the layered nav on /vehiclecompat/find/index pages
  • Documentation bundle
    • README, INSTALL, USAGE, CONFIGURATION, COMPATIBILITY, CHANGELOG, UNINSTALL, LICENSE

Compatibility

  • Magento 2.4.4 – 2.4.8
  • PHP 8.1, 8.2, 8.3
  • Hyvä Theme (native — Alpine global)
  • Luma / Blank / custom themes (Alpine auto-loaded from CDN)
  • Adobe Commerce + Magento Open Source + Mage-OS

Versions
Version Stability QA Status Compatibility Released
1.2.1 stable Fail Magento 2.4.7-2.4.8 Details 2026-06-03 16:12:56
1.2.0 stable Not tested Not yet tested Details 2026-06-03 13:22:54
1.1.1 stable Not tested Not yet tested Details 2026-06-03 13:03:05
1.1.0 stable Not tested Not yet tested Details 2026-06-03 10:56:25
1.0.3 stable Not tested Not yet tested Details 2026-06-03 10:47:01
1.0.2 stable Not tested Not yet tested Details 2026-06-03 10:45:39
1.0.1 stable Not tested Not yet tested Details 2026-06-03 10:29:19
1.0.0 stable Not tested Not yet tested Details 2026-06-03 10:22:30

Requires 6

Package Constraint
magento/framework >=103.0
magento/module-backend >=102.0
magento/module-catalog >=104.0
magento/module-store >=101.0
magento/module-ui >=101.0
php ~8.1.0||~8.2.0||~8.3.0||~8.4.0

No QA results yet

QA pipelines haven't run for this version. Compatibility and quality results appear here once the vendor publishes a tagged release that gets ingested.

License
proprietary
Authors

More from etechflow

View vendor
Make it pay

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.