CartDiscountPercentage — Rabattanzeige im Warenkorb¶

Extension for Magento 2¶

Bedienungsanleitung¶

CopeX GmbH
Web: https://copex.io
Email: office@copex.io

Inhaltsverzeichnis¶

Abschnitt	Seite
1 Voraussetzungen	2
2 Installation	2
3 Konfiguration	2
4 Funktionsweise	4
5 Fehlerbehandlung	5

1 Voraussetzungen¶

Magento 2.4 oder höher
PHP 8.1 oder höher
Kompatibel mit Luma-, Hyvä- und CopeX-Green-Themes

2 Installation¶

Via Composer¶

composer require copex/module-cartdiscountpercentage
php bin/magento module:enable CopeX_CartDiscountPercentage
php bin/magento setup:upgrade
php bin/magento cache:flush

3 Konfiguration¶

Die Konfiguration des Moduls finden Sie im Magento 2 Backend unter Shops > Konfiguration > Umsatz > Umsatz > Zusätzliche Warenkorb-Rabattinformation.

3.1 Allgemeine Einstellungen¶

Modul aktivieren — Aktiviert oder deaktiviert die gesamte Erweiterung. Wenn deaktiviert, werden keine Rabattinformationen auf der Storefront angezeigt.

3.2 Anzeigeoptionen¶

Alle folgenden Felder unterstützen dieselben Anzeigemodi:

Anzeigemodus	Beschreibung
Deaktiviert	Rabattinformation wird an diesem Ort nicht angezeigt
Nur Prozent	Zeigt den Rabatt als Prozentwert an (z. B. "−15 %")
Nur Betrag	Zeigt den Rabatt als absoluten Betrag an (z. B. "−€12,00")
Prozent und Betrag	Zeigt sowohl Prozentsatz als auch Betrag an

Rabatt auf Produktdetailseite anzeigen — Steuert die Rabattanzeige auf Produktdetailseiten. Bei Aktivierung wird unterhalb des Preises der berechnete Rabatt gegenüber dem Originalpreis eingeblendet.
Rabatt in Produktliste anzeigen — Steuert die Rabattanzeige in Produktlistings (Kategorienseiten, Suchergebnisse). Der Rabatt wird neben dem jeweiligen Produktpreis angezeigt.
Gesamtrabatt im Minicart anzeigen — Steuert die Rabattanzeige im Mini-Warenkorb (Warenkorb-Dropdown). Die Gesamtersparnis über alle Warenkorbpositionen hinweg wird angezeigt.
Gesamtrabatt im Warenkorb anzeigen — Steuert die Rabattanzeige auf der vollständigen Warenkorb-Seite. Die kumulierte Ersparnis aller rabattierten Artikel wird dargestellt.

4 Funktionsweise¶

4.1 Rabattberechnung¶

Die Rabattberechnung wird vom Helper CopeX\CartDiscountPercentage\Helper\SpecialPrice durchgeführt:

Prozentualer Rabatt: Berechnet als (Originalpreis - Endpreis) / Originalpreis * 100
Absoluter Rabatt: Differenz zwischen Originalpreis und Endpreis
Aktionszeitraum: Nur innerhalb des konfigurierten Sonderpreiszeitraums wird ein Rabatt angezeigt
Stückliste: Bei Warenkorbpositionen wird der Gesamtrabatt über alle Artikel aggregiert

4.2 Anzeigeorte¶

Das Modul zeigt Rabattinformationen an folgenden Stellen:

Produktdetailseite: Unterhalb des Produktpreises wird der errechnete Rabatt angezeigt (konfigurierbar: neben dem Preis oder im Bereich product.media.after).

Produktliste: In Produktlistings (Kategorien, Suchergebnisse) wird der Rabatt pro Produkt eingeblendet.

Minicart: Im Warenkorb-Dropdown wird die Gesamtersparnis aller rabattierten Positionen angezeigt. Für Hyvä-Themes wird die Anzeige über Alpine.js-Events gesteuert.

Warenkorb-Seite: Auf der vollständigen Warenkorb-Seite erscheint die summierte Ersparnis unterhalb der Subtotals.

In der Frontend-Ansicht ist die Rabattinformation direkt im Warenkorb-Kontext sichtbar. Kundinnen und Kunden sehen den prozentualen bzw. absoluten Nachlass unmittelbar neben den Preis-/Summeninformationen. Falls im Shop keine rabattierten Artikel im Warenkorb liegen oder die Anzeigeoption in der Konfiguration deaktiviert ist, bleibt dieser Bereich leer.

4.3 Theme-Kompatibilität¶

Das Modul unterstützt folgende Themes:

Luma und Luma-basierte Themes: Vollständige Unterstützung für alle Anzeigeorte
Hyvä Theme: Unterstützung mit Hyvä-spezifischen Templates und Alpine.js-Integration
CopeX Green Theme: Vollständige Unterstützung

4.4 Sonderfall: Stufenpreise¶

Das Modul behandelt Stufenpreise korrekt. Der Rabatt wird immer relativ zum jeweils gültigen Originalpreis berechnet, nicht zum Standard-Einzelpreis.

5 Fehlerbehandlung¶

Rabatt wird nicht angezeigt — Stellen Sie sicher, dass das Modul aktiviert ist und der entsprechende Anzeigeort auf einen anderen Wert als "Deaktiviert" gestellt wurde.
Falscher Prozentwert — Prüfen Sie, ob der Sonderpreis korrekt mit einem gültigen Aktionszeitraum konfiguriert ist. Das Modul zeigt nur Rabatte an, wenn ein aktiver Sonderpreis vorhanden ist.
Anzeige fehlt im Hyvä-Theme — Stellen Sie sicher, dass die Hyvä-Config-Generierung korrekt ausgeführt wurde (bin/magento hyva:config:generate). Das Modul registriert sich über den Observer hyva_config_generate_before.
Preis 0 wird nicht rabattiert — Wenn der Originalpreis 0 ist, wird kein Rabatt berechnet (Division durch 0 wird verhindert).

Lizenz¶

Proprietär — CopeX GmbH. Eine Lizenz pro produktiver Magento-Instanz.