mhinspeya / special-promotion

1.0.1 2026-11-13 10:44 UTC

Requires

• php: >=8.1
• hyva-themes/magento2-theme-module: *
• magento/framework: *
• magento/module-backend: *
• magento/module-catalog: *
• magento/module-catalog-inventory: *
• magento/module-quote: *
• magento/module-sales: *
• magento/module-sales-rule: *
• magento/module-store: *
• mhinspeya/backend-mod: ^1.0

Suggests

• mhinspeya/backend-mod: Support Configuration

OSL-3.0

• MHinspeya

• campaign
• magento
• badge
• promotion
• merchandising
• magento 2
• hyva
• MHinspeya
• cart price rule

Published on Packagist.org on 2026-11-13 10:46 UTC

README

Display-only Special Promotion badges for Modehaus (Hyvä / Magento 2.4).

Financial discounts are not calculated here. Use Magento Cart Price Rules
(Marketing → Promotions → Cart Price Rules) for money, coupons, and discount logic.
This module only controls where and how badges appear on PLP, PDP, and cart.

Documentation

Marketing-style guides with admin screenshots, cover pages, and PDF downloads — same pattern as other Inspeya modules.

In admin: Inspeya → Special Promotion → Configuration → Documentation buttons
(View Overview / Installation / User Guide + Download PDF for each).

Document	HTML	PDF
Overview	docs/01-Overview.html	docs/pdf/Special-Promotion-Overview.pdf
Installation Guide	docs/02-Installation-Guide.html	docs/pdf/Special-Promotion-Installation-Guide.pdf
User Guide	docs/03-User-Guide.html	docs/pdf/Special-Promotion-User-Guide.pdf
Complete pack	—	docs/pdf/Special-Promotion-Complete-Documentation.pdf

Screenshots live in docs/images/ (admin be-* and storefront fe-listing / fe-pdp / fe-cart). Index: docs/README.md. Markdown mirrors the same content under docs/*.md.

Quick start

bin/magento module:enable MHinspeya_SpecialPromotion
bin/magento setup:upgrade
bin/magento indexer:reindex mhinspeya_special_promotion_product
bin/magento cache:flush

Admin

• Manage: Inspeya → Special Promotion → Manage Promotions
• Config: Inspeya → Special Promotion → Configuration
  (includes Documentation buttons: Overview / Installation / User Guide — HTML + PDF)

Features at a glance

• Admin CRUD for Special Promotions
• Optional Associated Cart Price Rule with AJAX prefill + summary panel
• Targeting Type: Product (product grid), Category, Brand, Material
• Advanced filters: model, on-sale, visibility, stock, configurable
• Badge content: label / graphic / both (category, PDP, cart)
• Label placeholders: {{discount_amount}}, {{coupon_code}}, {{rule_name}}, {{simple_action}}
• Indexer mhinspeya_special_promotion_product → mhinspeya_sp_product_index
• Auto index refresh + FPC / block_html clean on promotion save

Configuration (store)

Stores → Configuration → Inspeya → Special Promotion (or menu shortcut above)

Setting	Default
Enable Module	Yes
Brand Attribute Code	brand
Material Attribute Code	material
Model Number Attribute Code	(empty)
Product On Sale Attribute Code	sale

Indexer

bin/magento indexer:reindex mhinspeya_special_promotion_product
bin/magento indexer:status mhinspeya_special_promotion_product

Invalidated when products, Special Promotions, or Cart Price Rules change.
After Special Promotion save, Full Page + Block HTML caches are cleaned so storefront badges update without a manual flush.

Module path

app/code/MHinspeya/SpecialPromotion

Out of scope

• Custom percent / fixed cart discounts inside this module
• Replacing Magento’s coupon / cart-rule engine
• Amasty-style cart-rule builders

Use Cart Price Rules for all financial promotion behaviour.