Etechflow_ProductWarning — Product Warning Banners for Magento 2

Per-product and per-category warning banners on the storefront PDP. Admin can create coloured notices ("This item ships from a remote warehouse", "Cutting service unavailable for this key", "Backorder — 7 day lead time", etc.), assign them to specific products or whole categories, and the storefront auto-renders them above the price.

• Version: 1.0.0
• Package: etechflow/module-product-warning
• Magento: 2.4.4 – 2.4.8 (newer versions should work; report incompatibilities)
• PHP: 8.1, 8.2, 8.3
• License: proprietary (LICENSE.txt) — Commercial licenses available at https://etechflow.com
• Vendor: ETechFlow — https://etechflow.com

What you get

• Admin grid + edit form under Catalog → Inventory Warning
  • Warning name (admin-only label)
  • Warning message (customer-facing text)
  • Color (hex picker, used for the banner tint + left border)
  • Active toggle, sort order
  • Assigned categories (multi-tree picker — assigns to every product in those categories)
  • Assigned products (search + multi-select picker)
• Storefront PDP rendering (auto-injected via this module's own layout XML — no theme override required)
  • Stacks multiple warnings if a product matches several
  • Tints background + border using the warning's color
  • Scoped CSS namespace (.epw-*) — won't collide with theme classes
• Resolver model (ETechFlow\ProductWarning\Model\WarningResolver::getForProduct($product)) for stores that want to render warnings in a custom location (e.g., listing pages, cart, emails)
• Demo data installer seeds 3 example warnings on first install (toggle-able by deleting the patch row)
• Theme-agnostic by design — works on Hyvä, Luma, Mage-OS adminhtml, and any custom theme

Theme compatibility

See COMPATIBILITY.md for the design choices that make this portable.

Quick start

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

# 2. Enable + migrate
bin/magento module:enable Etechflow_ProductWarning
bin/magento setup:upgrade
bin/magento setup:di:compile      # production-mode only
bin/magento cache:flush

# 3. Visit the admin
open https://your-store.example.com/admin/etechflow_warning/warning/index
# (or: Admin sidebar → Catalog → Inventory Warning)

Three sample warnings are auto-seeded on first install. Edit one, assign it to a product or category, and reload the PDP — the banner renders above the price.

Documentation index

Support

• Email: [email protected]
• Include: Magento version, PHP version, active theme, steps to reproduce, screenshot of the PDP with browser inspector open.

License

proprietary — free for commercial and non-commercial use. See LICENSE.txt.

Changelog — Etechflow_ProductWarning

1.0.0 — 2026-05-20

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

Added

• Admin module under Catalog → Inventory Warning
  • Grid + edit form (Magento Ui Components)
  • Hex color picker, active toggle, sort order
  • Multi-tree category assignment picker
  • Multi-select product assignment picker (searchable by name / SKU)
  • ACL resource Etechflow_ProductWarning::warnings
• Storefront PDP rendering — auto-injected via this module's own
  view/frontend/layout/catalog_product_view.xml. No theme override required.
• WarningResolver PHP API for stores that want to render warnings
  elsewhere (cart, emails, listing pages, etc.)
• DB schema (etc/db_schema.xml) — 3 tables:
  • etechflow_warning — master record (id, name, message, color, active, sort_order, timestamps)
  • etechflow_warning_category — category assignment pivot
  • etechflow_warning_product — product assignment pivot
• Demo data installer patch — seeds 3 example warnings on first install
• Scoped frontend CSS — .epw-* namespace, inline <style> block
• Zero JavaScript on frontend — pure server-rendered HTML
• Documentation bundle
  • README, INSTALL, USAGE, COMPATIBILITY, CONFIGURATION, UNINSTALL, CHANGELOG, LICENSE

Compatibility

• Magento 2.4.4 – 2.4.8
• PHP 8.1, 8.2, 8.3
• Hyvä Theme + Luma + custom themes
• Adobe Commerce + Magento Open Source + Mage-OS

Migration

If you previously had the original Keystation_ProductWarning module on a
store, follow the data-copy SQL in INSTALL.md → Upgrading from Keystation_ProductWarning to bring the data across.