Brand Discount Tool – Dokumentation
MEK7
Brand Discount Tool – Dokumentation
v1.42.9
1 Voraussetzungen
| Komponente | Anforderung |
|---|---|
| WordPress | 5.8 oder neuer |
| WooCommerce | 6.0 oder neuer |
| PHP | 7.4 oder neuer |
| Perfect Brands for WooCommerce | Taxonomy pwb-brand muss aktiv sein |
| JTL-Wawi (optional) | Für automatischen Abgleich + Special Discount |
2 Installation
Plugin hochladen
Im WordPress-Backend: Plugins → Installieren → Plugin hochladen → ZIP-Datei auswählen → Jetzt installieren.
Plugin aktivieren
Nach der Installation auf Plugin aktivieren klicken. Standardwerte werden automatisch angelegt.
Plugin öffnen
Im Menü unter WooCommerce → Brand Discounts zu finden.
Lizenz eintragen
Im Reiter Lizenz den Schlüssel eingeben. Format: MEK7-XXXXX-XXXXX-XXXXX. Ohne gültige Lizenz ist der Start gesperrt.
⚠
Die Lizenz ist domaingebunden. Bei einem Domain-Wechsel wird ein neuer Schlüssel benötigt.
3 Konfiguration
Globaler Rabatt
Gilt für alle Produkte ohne Marken- oder Special Discount. Einheit: Prozent (z.B. 10 = 10% Rabatt).
Marken-Rabatt
Pro Marke kann ein individueller Prozentsatz festgelegt werden. Zusätzlich sind Preis-Stufen möglich: z.B. ab 100 € → 15%, ab 50 € → 10%.
Special Discount (JTL-Attribut)
Für einzelne Produkte kann in JTL ein individueller Rabatt hinterlegt werden. Hat höchste Priorität und überschreibt alle anderen Regeln.
ℹ
In JTL unter Artikel → Attribute/Merkmale das Attribut mek7_special_discount mit dem Prozentwert anlegen (z.B. 25 = 25% Rabatt). Das Attribut wird im Frontend automatisch ausgeblendet.
Preisbereiche
Gelten übergreifend nach Regulärpreis-Spanne, z.B. alle Produkte zwischen 50–200 € bekommen 8% Rabatt.
Rundungsmodus
| Modus | Beschreibung |
|---|---|
| none | Keine Rundung, exakt auf 2 Dezimalstellen |
| m_099 | Auf .99-Cent-Preis runden (z.B. 23,99 €) |
| m_095 | Auf .95-Cent-Preis runden |
| down_005 | Abrunden auf 5-Cent-Schritte |
| acct_2 | Kaufmännisch auf 2 Dezimalstellen |
| acct_010 | Auf 10-Cent-Schritte runden |
ℹ
Bei Brutto-Preisen in WooCommerce rechnet das Plugin automatisch: Brutto → Netto → Rabatt → Runden → zurück zu Brutto.
4 JTL-Integration
JTL bleibt führende Datenquelle für Preise. Nach jedem JTL-Abgleich stellt das Plugin die korrekten Sale-Preise automatisch wieder her.
✓
Prinzip: JTL liefert den Regulärpreis. Das Plugin berechnet und setzt den Sale-Preis sofort neu – per Echtzeit-Hook und zusätzlich per Cron.
Prioritätsreihenfolge
1. mek7_special_discount (JTL-Attribut)Höchste Priorität – gilt nur für dieses eine Produkt
2. Marken-Rabatt (inkl. Preis-Stufen)Gilt für alle Produkte der jeweiligen Marke
3. Preisbereichs-RabattÜbergreifend nach Regulärpreis-Spanne
4. Globaler RabattFallback für alle übrigen Produkte
5 Cron / Plesk HTTP-Trigger
Zusätzlich zum Echtzeit-Hook läuft alle 30 Minuten ein Reparatur-Cron, der Produkte mit fehlendem oder falschem Sale-Preis korrigiert.
Einrichtung in Plesk
Trigger-URL kopieren
Im Plugin unter Cron / JTL → Plesk HTTP-Trigger → curl-Befehl kopieren.
Cron in Plesk anlegen
Websites & Domains → Geplante Aufgaben → Hinzufügen
Befehl + Intervall eintragen
Den curl-Befehl eintragen, Intervall: alle 30 Minuten (*/30 * * * *).
/usr/bin/curl -sS „https://ihr-shop.de/?mek7_bd_cron=DEIN_SECRET“ >/dev/null 2>&1
⚠
Das Secret wird im Plugin generiert. Bei Neugenerierung muss der Plesk-Cron-Befehl aktualisiert werden.
6 Typischer Ablauf
Artikel in JTL anlegen / bearbeitenOptional: Attribut mek7_special_discount = 25 setzen
JTL-Abgleich zu WooCommerceRegulärpreis aktualisiert, Sale-Preis ggf. entfernt
save_post_product Hook feuert sofortPlugin liest Rabatt-Regeln und berechnet neuen Sale-Preis
Sale-Preis korrekt gesetztKunde sieht sofort den richtigen Aktionspreis
Cron läuft alle 30 Min. zur AbsicherungRepariert verbleibende Produkte mit fehlendem / falschem Sale-Preis
✓
Der JTL-Schutz-Cron zeigt unter Cron / JTL immer den letzten Lauf, Anzahl reparierter Produkte und die Gesamtstatistik.