WooCommerce Lagerbestand Balken - koweb

Ein schlankes WooCommerce-Plugin, das den Lagerstatus auf Produktseiten als Statustext und optional als kompakten Balken darstellt – ohne die konkrete Stückzahl im Frontend auszugeben.

Das Plugin ist als Referenzprojekt von Sebastian Koch / Ko-Webdesign entstanden und wird kostenlos unter der GPL-2.0-or-later veröffentlicht.

Funktionen

• Globale Einstellungen unter WooCommerce → Einstellungen → Produkte → Lagerbalken
• Schwellenwerte wahlweise nach Prozent oder Stückzahl
• Globaler 100 % Bestand als Standard für alle Produkte
• Abweichender 100 % Bestand pro Produkt und Variante möglich
• Optionale individuelle Warnschwellen pro Produkt
• Eigene Texte und Farben für vier Lagerstatus
• Unterstützung für einfache und variable WooCommerce-Produkte
• Automatische Ausgabe direkt vor dem Warenkorbformular
• Freie Platzierung über den Shortcode [koweb_lagerbalken]
• Keine Ausgabe der konkreten Lagerstückzahl im Frontend

Globale Einstellungen

Die zentrale Konfiguration befindet sich unter WooCommerce → Einstellungen → Produkte → Lagerbalken. Dort werden Berechnungsart, globaler Bezugsbestand, Warnschwellen, Texte, Farben und die Ausgabeposition festgelegt.

Lagerstatus

Im Prozent-Modus sind standardmäßig folgende Schwellen vorgesehen:

Die Werte können global geändert werden. Optional können für einzelne Produkte eigene Schwellen hinterlegt werden. Solange dort nicht beide Produktgrenzen gültig eingetragen sind, gelten die globalen Einstellungen.

Globaler 100 % Bestand

Für die Prozentberechnung kann ein globaler Bezugsbestand definiert werden. Beispiel: 200 Stück = 100 %. Dieser Wert gilt automatisch für alle Produkte, sofern beim Produkt oder bei einer Variante kein eigener Wert hinterlegt wurde.

Die Reihenfolge lautet:

Variante → Produkt → globaler Wert

Dadurch muss bei einem Shop mit überwiegend gleichem Bezugsbestand nur der globale Wert gepflegt werden.

Individuelle Produktwerte

Wenn individuelle Produktgrenzen in den globalen Einstellungen aktiviert sind, erscheinen im Bereich Produktdaten → Lagerbestand / Inventar zusätzliche Felder. Dort können der 100 % Bestand und die beiden Warnschwellen für einzelne Produkte überschrieben werden.

Darstellung des Balkens

Der Balken bildet den mathematischen Lagerprozentsatz bewusst nicht 1:1 ab. Stattdessen wird die Füllung passend zum ermittelten Lagerstatus dargestellt:

• Verfügbar: ca. 70–100 %
• Nur noch wenige verfügbar: ca. 30–50 %
• Fast ausverkauft: ca. 5–15 %
• Nicht vorrätig: 0 %

Innerhalb des jeweiligen Bereichs reagiert die Füllung weiterhin auf den tatsächlichen Bestand. Dadurch bleibt die visuelle Anzeige konsistent mit dem Statustext.

Position und Shortcode

Im automatischen Modus wird der Lagerbalken über den WooCommerce-Hook woocommerce_before_add_to_cart_form direkt vor dem Warenkorbformular ausgegeben.

Für individuell aufgebaute Produktseiten kann stattdessen die Ausgabe Nur per Shortcode gewählt werden:

[koweb_lagerbalken]

Der Shortcode verwendet das aktuell aufgerufene WooCommerce-Produkt. Bei stark angepassten Theme- oder Builder-Layouts kann die manuelle Platzierung die passendere Variante sein.

Installation

1. Die ZIP-Datei aus dem aktuellen GitHub Release herunterladen.
2. In WordPress Plugins → Installieren → Plugin hochladen öffnen.
3. ZIP-Datei auswählen, installieren und das Plugin aktivieren.
4. Unter WooCommerce → Einstellungen → Produkte → Lagerbalken konfigurieren.

Voraussetzungen

• WordPress 6.2 oder neuer
• PHP 7.4 oder neuer
• WooCommerce 7.6 oder neuer

Das Plugin verwendet klassische WooCommerce-PHP-Hooks. Bei vollständig blockbasierten Produktlayouts, Quick Views oder stark angepassten Produktformularen kann eine zusätzliche Integration notwendig sein.

Version

Aktuelle öffentliche Version: 1.0.0

Änderungen stehen in CHANGELOG.md.

Lizenz

Dieses Projekt steht unter GPL-2.0-or-later. Siehe LICENSE.

Hinweis

Das Repository dient als öffentliches Referenzprojekt. Vor dem produktiven Einsatz sollte das Plugin in der jeweiligen WordPress-, WooCommerce- und Theme-Konfiguration getestet werden.