Tiers verwenden

Dieser Leitfaden führt von einer neuen Installation zu einer sichtbaren Preistabelle und einem geprüften Warenkorbrabatt.

1. Staffel aufbauen

Öffne WooCommerce → Tiers und ergänze Zeilen im Editor Preisstaffeln. Mindestens eine gültige gespeicherte Staffel aktiviert den Rabatt. Ein einfacher Start:

• 5 Stück → 5 Prozent Rabatt
• 10 Stück → 10 Prozent Rabatt
• 25 Stück → 15 Prozent Rabatt

Die Live-Vorschau zeigt jede Staffel aus Kundensicht. Beim Speichern werden ungültige Zeilen entfernt und die übrigen nach Mindestmenge sortiert. Im Warenkorb gilt immer die höchste erreichte Staffel.

2. Preistabelle platzieren

Wähle unter Tabellenposition die Produktzusammenfassung, eine Position vor oder nach dem Warenkorbformular, den Bereich der Produktmetadaten oder Nur manuell. Optional kannst du eine Überschrift festlegen und die Ersparnisspalte aktivieren.

3. Produktseite prüfen

Öffne ein einfaches Produkt mit regulärem Preis. Die Tabelle sollte an der gewählten Stelle jeden Mengenbereich, den Rabatt und den resultierenden Einzelpreis anzeigen. Sie ist serverseitig gerendertes HTML mit <caption> und <th scope>. Es gibt weder AJAX noch nachträgliche Layout-Verschiebungen.

4. Warenkorb prüfen

1. Füge eine Menge unterhalb der ersten Staffel hinzu. Es gilt der reguläre Preis.
2. Erhöhe die Menge bis zu einer Staffel. Die Zwischensumme berücksichtigt deren Rabatt.
3. Erhöhe die Menge bis zur nächsten Staffel. Der höhere Rabatt ersetzt den vorherigen und wird nicht addiert.

Ist der Ersparnishinweis im Warenkorb aktiv, zeigt jede rabattierte Position die Ersparnis für ihre aktuelle Menge. Bei abweichenden Summen sollten der reguläre Preis und andere preisverändernde Erweiterungen geprüft werden.

Manuelle Platzierung mit Shortcode oder Block

Setze die Tabellenposition auf Nur manuell und verwende:

[tiers_table]
[tiers_table product_id="123"]

Ohne product_id oder mit dem Wert 0 verwendet der Shortcode das aktuelle Produkt. Mit einer ID kann die Tabelle eines bestimmten Produkts in einer Seite, einem Beitrag oder einem Produktinhalt angezeigt werden.

Im Block-Editor steht der Block Mengenpreistabelle in der Kategorie WooCommerce bereit. Sein Feld Produkt-ID (0 = aktuelles Produkt) steuert dasselbe Verhalten. Shortcode und Block nutzen das gleiche Template und laden die Tabellenstile bei Bedarf auch außerhalb einer Produktseite. Ohne gültige Staffeln geben beide nichts aus.

Staffeln für Entwickler anpassen

Der Filter tiers_product_tiers erhält die globalen Staffeln und das aktuelle WC_Product. Er läuft sowohl beim Aufbau der Tabelle als auch bei der Rabattberechnung:

add_filter( 'tiers_product_tiers', function ( array $tiers, WC_Product $product ): array {
    // Example: custom tiers for one product.
    if ( 123 === $product->get_id() ) {
        return array(
            array( 'min_qty' => 3, 'discount_percent' => 10.0, 'label' => '' ),
            array( 'min_qty' => 6, 'discount_percent' => 20.0, 'label' => 'Wholesale' ),
        );
    }
    return $tiers;
}, 10, 2 );

Jede Staffel enthält min_qty, discount_percent und label. Die vollständige Hook-Liste sowie der Template-Pfad stehen unter Konfiguration.

Gutscheine, Steuern und Barrierefreiheit

Tiers verändert den Preis der Warenkorbposition über woocommerce_before_calculate_totals, bevor WooCommerce die Gesamtsummen ermittelt. Standardgutscheine gelten deshalb auf Basis des Staffelpreises, und WooCommerce berechnet die Steuern auf den rabattierten Preis. <th scope> und <caption> sorgen dafür, dass Screenreader Mengen und Preise korrekt zuordnen.