Unit price

Das polnische Recht verpflichtet Online-Shops, den Grundpreis eines Produkts anzuzeigen - z. B. den Preis pro Kilogramm, Liter oder Meter. Polski for WooCommerce fügt diese Angabe automatisch auf der Produktseite, in Listen und im Warenkorb hinzu.

Wann ist ein Grundpreis erforderlich

Die Pflicht zur Angabe von Grundpreisen gilt für Produkte, die nach Gewicht, Volumen oder Länge verkauft werden. In der Praxis umfasst dies:

• Lebensmittel (Preis pro kg oder Liter)
• Kosmetik- und Reinigungsprodukte (Preis pro 100 ml oder Liter)
• Baumaterialien (Preis pro laufenden Meter oder Quadratmeter)
• Schüttgüter (Preis pro kg)

Der Grundpreis muss überall dort sichtbar sein, wo der Produktpreis dargestellt wird - auf der Produktseite, in Suchergebnissen, in Preisvergleichen und im Warenkorb.

Konfiguration

Gehen Sie zu WooCommerce > Einstellungen > Polski > Preise und aktivieren Sie das Grundpreis-Modul. Nach der Aktivierung erscheint im Produkteditor unter dem Reiter “Allgemein” ein neuer Abschnitt.

Felder im Produkteditor

Feld	Beschreibung	Beispiel
Basismenge	Produktmenge in der Verpackung	500
Basiseinheit	Maßeinheit des Produkts	g
Referenzmenge	Referenzmenge für den Grundpreis	1
Referenzeinheit	Einheit, für die der Preis angegeben wird	kg

Für ein Produkt mit einem Gewicht von 500 g und einem Preis von 12,99 PLN berechnet das Plugin den Grundpreis automatisch als 25,98 PLN/kg.

Unterstützte Einheiten

Das Plugin unterstützt die folgenden Maßeinheiten:

• Gewicht: g, kg, mg
• Volumen: ml, l, cl
• Länge: mm, cm, m
• Stücke: pcs (Stück)

Die Umrechnung zwischen Einheiten erfolgt automatisch. Wenn ein Produkt das Gewicht in Gramm hat und die Referenzeinheit Kilogramm ist, berechnet das Plugin den Wert automatisch.

Produktvarianten

Bei variablen Produkten kann der Grundpreis auf zwei Ebenen festgelegt werden:

1. Auf Ebene des übergeordneten Produkts - der Wert wird von allen Varianten geerbt
2. Auf Ebene der Variante - überschreibt die Einstellungen des übergeordneten Produkts

Bei Varianten mit unterschiedlichem Gewicht (z. B. Packungen zu 250 g und 500 g) legen Sie den Grundpreis für jede Variante separat fest. Das Plugin aktualisiert den angezeigten Preis automatisch, wenn der Kunde die Variante wechselt (AJAX).

Shortcode

Verwenden Sie den Shortcode [polski_unit_price], um den Grundpreis an beliebiger Stelle anzuzeigen.

Parameter

Parameter	Typ	Standard	Beschreibung
product_id	int	aktuell	Produkt-ID
before	string	""	Text vor dem Preis
after	string	""	Text nach dem Preis
wrapper	string	span	Umschließendes HTML-Element

Anwendungsbeispiele

Grundlegende Verwendung auf der Produktseite:

[polski_unit_price]

Mit benutzerdefinierter Produkt-ID und Text:

[polski_unit_price product_id="123" before="Preis pro kg: " after=" brutto"]

In einem PHP-Template:

echo do_shortcode('[polski_unit_price product_id="' . $product->get_id() . '"]');

Hook: polski/price/unit_price_html

Mit diesem Filter können Sie das HTML des Grundpreises vor der Anzeige ändern.

Signatur

apply_filters('polski/price/unit_price_html', string $html, float $unit_price, WC_Product $product, array $args): string

Parameter

Parameter	Typ	Beschreibung
$html	string	Generiertes HTML des Grundpreises
$unit_price	float	Berechneter Grundpreis
$product	WC_Product	WooCommerce-Produktobjekt
$args	array	Array mit den Schlüsseln: base_qty, base_unit, ref_qty, ref_unit

Beispiel: Hinzufügen einer CSS-Klasse

add_filter('polski/price/unit_price_html', function (string $html, float $unit_price, WC_Product $product, array $args): string {
    $category_class = '';
    if (has_term('napoje', 'product_cat', $product->get_id())) {
        $category_class = ' polski-unit-price--beverage';
    }

    return sprintf(
        '<span class="polski-unit-price%s">%s/%s</span>',
        esc_attr($category_class),
        wc_price($unit_price),
        esc_html($args['ref_unit'])
    );
}, 10, 4);

Beispiel: Ausblenden des Grundpreises für ausgewählte Kategorien

add_filter('polski/price/unit_price_html', function (string $html, float $unit_price, WC_Product $product): string {
    if (has_term('uslugi', 'product_cat', $product->get_id())) {
        return '';
    }

    return $html;
}, 10, 3);

CSV-Import

Grundpreise können mit dem Standard-WooCommerce-Importer importiert werden. Fügen Sie der CSV-Datei die folgenden Spalten hinzu:

CSV-Spalte	Beschreibung
polski_unit_base_qty	Basismenge
polski_unit_base_unit	Basiseinheit
polski_unit_ref_qty	Referenzmenge
polski_unit_ref_unit	Referenzeinheit

Beispiel für eine CSV-Zeile:

"Ground coffee 500g",29.99,500,g,1,kg

Häufige Probleme

Grundpreis wird nicht angezeigt

Prüfen Sie, ob:

1. Das Grundpreis-Modul in den Einstellungen aktiviert ist
2. Beim Produkt die Felder Basismenge und Einheit ausgefüllt sind
3. Das Theme den Hook woocommerce_after_shop_loop_item_title (Liste) und den Hook woocommerce_single_product_summary (Produktseite) unterstützt

Fehlerhafte Umrechnung

Stellen Sie sicher, dass die Basiseinheit und die Referenzeinheit zur selben Kategorie gehören (z. B. beide Gewicht oder beide Volumen). Das Plugin rechnet nicht zwischen Kategorien um - Sie können Gramm nicht in Liter umrechnen.

Verwandte Ressourcen

• Ein Problem melden

Diese Seite dient ausschließlich 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.