Product badges

Badges sind farbige Labels auf Produktbildern. Sie helfen Kunden, Angebote, Neuheiten, Bestseller und Produkte mit niedrigem Bestand schnell zu erkennen.

Modul aktivieren

Gehen Sie zu WooCommerce > Polski > Storefront-Module und aktivieren Sie die Option Product Badges. Das Modul ersetzt das Standard-Badge “Sale!” von WooCommerce durch individuelle, konfigurierbare Badges.

Automatische Badges

Automatische Badges werden auf Basis der Produktdaten erzeugt. Sie erfordern keine manuelle Konfiguration - nach der Aktivierung funktionieren sie sofort auf allen Produkten.

Sale

Wird angezeigt, wenn für das Produkt ein Angebotspreis festgelegt ist. Standardmäßig wird der Rabattprozentsatz (z. B. -25%) anstelle des Standardtextes “Sale!” angezeigt.

Formatkonfiguration:

Option	Beschreibung	Beispiel
Prozent	Rabattprozentsatz	-25%
Betrag	Ersparnisbetrag	-50 PLN
Text	Eigener Text	Aktion
Prozent + Betrag	Beide Werte	-25% (-50 PLN)

// Format des Sale-Badges ändern
add_filter('polski/badges/sale_format', function (): string {
    return 'percentage'; // 'percentage', 'amount', 'text', 'both'
});

Bei variablen Produkten wird der Prozentsatz auf Basis der Variante mit dem größten Rabatt berechnet.

Neu

Wird auf Produkten angezeigt, die innerhalb der letzten X Tage hinzugefügt wurden. Standard 14 Tage.

// Zeitraum für "Neu" ändern
add_filter('polski/badges/new_days', function (): int {
    return 30; // in den letzten 30 Tagen hinzugefügte Produkte
});

Niedriger Bestand

Wird angezeigt, wenn die Bestandsmenge des Produkts unter den festgelegten Schwellenwert fällt. Der Standardschwellenwert ist der in WooCommerce festgelegte Wert (WooCommerce > Einstellungen > Produkte > Lagerbestand > Schwellenwert für niedrigen Bestand).

Badge-Inhalt: Nur noch X Stück! (wobei X die aktuelle Menge ist).

// Eigener Text für das Badge bei niedrigem Bestand
add_filter('polski/badges/low_stock_text', function (string $text, int $stock): string {
    if ($stock <= 3) {
        return 'Letzte Stück!';
    }
    return sprintf('%d übrig', $stock);
}, 10, 2);

Bestseller

Wird auf Produkten mit den höchsten Verkaufszahlen angezeigt. Standard sind die Top 10 Produkte im Shop.

// Bestseller-Limit ändern
add_filter('polski/badges/bestseller_limit', function (): int {
    return 20;
});

Die Bestseller-Berechnung wird in der Transient-API zwischengespeichert (Standard 24 Stunden).

Manuelle Badges (pro Produkt)

Zusätzlich zu den automatischen Badges können Sie einzelnen Produkten eigene Badges hinzufügen. Im Produkteditor finden Sie unter Produktdaten die Registerkarte Badges.

Optionen für manuelle Badges:

• Text - der auf dem Badge angezeigte Inhalt (z. B. “Empfohlen”, “Öko”, “Kostenloser Versand”)
• Hintergrundfarbe - Farbe des Badges (Farbwähler)
• Textfarbe - Farbe des Texts auf dem Badge
• Position - oben links, oben rechts, unten links, unten rechts
• Priorität - Anzeigereihenfolge, wenn ein Produkt mehrere Badges hat

Die maximale Anzahl der Badges auf einem einzelnen Produkt beträgt 4 (automatische + manuelle zusammen). Dieses Limit verhindert eine Überladung des Vorschaubilds.

// Badge-Limit pro Produkt ändern
add_filter('polski/badges/max_per_product', function (): int {
    return 3;
});

Badge-Positionierung

Automatische Badges haben Standardpositionen:

Badge	Standardposition
Sale	Oben links
Neu	Oben rechts
Niedriger Bestand	Unten links
Bestseller	Oben rechts

Die Positionen werden in den Moduleinstellungen konfiguriert. Wenn zwei Badges dieselbe Position haben, werden sie vertikal gestapelt.

Badge-Formen

Verfügbare Formen:

• Rechteck - Standard
• Abgerundetes Rechteck - border-radius
• Kreis - für kurze Texte (z. B. “-25%”)
• Band - dekorative Form mit einer Schräge

Konfiguration in den Einstellungen: WooCommerce > Polski > Storefront-Module > Badges > Form.

Sichtbarkeit von Badges

Badges werden angezeigt auf:

• Kategorie- und Archivseiten (Produktkarten)
• Einzelproduktseite (Hauptbild)
• Produkt-Slider (Slider-Modul)
• Schnellansicht (Quick-View-Modul)
• Suchergebnissen

Sie können Badges für ausgewählte Positionen deaktivieren:

// Badges auf der Einzelproduktseite deaktivieren
add_filter('polski/badges/show_on_single', '__return_false');

Badges für variable Produkte

Bei variablen Produkten:

• Sale - zeigt den größten Rabattprozentsatz unter allen Varianten
• Niedriger Bestand - wird angezeigt, wenn mindestens eine Variante einen niedrigen Bestand hat
• Neu - basierend auf dem Hinzufügedatum des Produkts (nicht der Variante)

CSS-Styling

CSS-Klassen:

• .polski-badge - Basisklasse des Badges
• .polski-badge--sale - Sale
• .polski-badge--new - Neu
• .polski-badge--low-stock - niedriger Bestand
• .polski-badge--bestseller - Bestseller
• .polski-badge--custom - manuelles Badge
• .polski-badge--top-left - Position oben links
• .polski-badge--top-right - Position oben rechts
• .polski-badge--bottom-left - Position unten links
• .polski-badge--bottom-right - Position unten rechts
• .polski-badge--rectangle - rechteckige Form
• .polski-badge--circle - Kreisform
• .polski-badge--ribbon - Bandform

Styling-Beispiel:

.polski-badge--sale {
    background-color: #dc2626;
    color: #ffffff;
    font-weight: 700;
    font-size: 0.75rem;
    padding: 4px 8px;
}

Leistung

Automatische Badges werden im Produkt-Meta (_polski_badges_cache) zwischengespeichert und bei jedem Speichern des Produkts aktualisiert. Die Bestseller-Berechnung erfolgt einmal alle 24 Stunden über die Transient-API.

Fehlerbehebung

Sale-Badge zeigt keinen Prozentsatz an - prüfen Sie, ob der reguläre Preis des Produkts festgelegt ist. Ohne regulären Preis kann der Prozentsatz nicht berechnet werden.

Manuelles Badge erscheint nicht - prüfen Sie das Badge-Limit pro Produkt. Wenn das Produkt bereits 4 automatische Badges hat, wird das manuelle nicht angezeigt.

Badges verdecken die Schnellansicht-Schaltfläche - ändern Sie die Position der Badges oder der Schnellansicht-Schaltfläche in den Moduleinstellungen.

Probleme melden: github.com/wppoland/polski/issues

Diese Seite dient nur zu Informationszwecken und stellt keine Rechtsberatung dar. Konsultieren Sie vor der Umsetzung einen Anwalt. Polski for WooCommerce ist Open-Source-Software (GPLv2), die ohne Gewährleistung bereitgestellt wird.