So zeigen Sie den Produktzustand (Neu/Gebraucht) in WooCommerce an

StoreLinkr kann den Zustand eines Produkts (Neu oder Gebraucht) mit WooCommerce synchronisieren. Diese Daten werden in einem Metafeld gespeichert und lassen sich mit einem einfachen Code-Snippet auf Ihren Produktseiten anzeigen.

Voraussetzung

Stellen Sie sicher, dass Ihre Datenquelle (z. B. Ihr Kassensystem oder PIM) Daten zum Produktzustand liefert und StoreLinkr so konfiguriert ist, dass es sie ausliest.

Implementierungscode

Fügen Sie das folgende Snippet in die Datei functions.php Ihres Themes oder in ein eigenes Plugin ein, um den Zustand auf der Einzelproduktseite anzuzeigen:

add_action('woocommerce_single_product_summary', function() {
    global $product;

    if (!$product instanceof WC_Product) {
        return;
    }

    // Retrieve the 'used' meta field
    $condition_code = $product->get_meta('used');

    if ($condition_code !== '' && $condition_code !== null) {
        // Mapping:
        // 0 = New
        // 1 = Used
        $label = ($condition_code == 1) ? 'Used' : 'New';
        
        echo '<p class="product-condition"><strong>Condition:</strong> ' . esc_html($label) . '</p>';
    }
}, 15);

So funktioniert es

StoreLinkr speichert den Zustand als numerischen Wert im Metafeld used:

• 0: Neu
• 1: Gebraucht

Mit get_meta('used') greifen Sie auf diesen Wert zu und übersetzen ihn in eine verständliche Bezeichnung für Ihre Kunden. Sie können die CSS-Klasse .product-condition weiter anpassen, damit sie zum Design Ihres Themes passt.

Zustandsgrad und Zustandsbeschreibung

Wenn die Export-Einstellung Produktzustand als Filter hinzufügen aktiviert ist, wird der Zustandsgrad, den Sie im PIM wählen (zum Beispiel "Wie neu" oder "Beschädigt"), als Produktattribut exportiert. Name und Wert stehen in der Shopsprache Ihres StoreLinkr-Projekts, zum Beispiel Conditie mit Zo goed als nieuw bei einer niederländischen Website. Ein neues Produkt erhält den Wert "Neu". WooCommerce zeigt es zusammen mit den anderen Attributen an, und Sie können es in Ihren Shopfiltern verwenden. Ein Zustandsattribut, das Sie dem Produkt selbst hinzugefügt haben, bleibt erhalten.

Der im PIM gewählte Zustand wird außerdem als Produkt-Meta condition gespeichert (StoreLinkr-Plugin ab Version 2.21.0), unabhängig davon, ob die obige Einstellung aktiv ist. Der Wert ist in jeder Sprache gleich, sodass sich ein Theme darauf verlassen kann:

Wert	Im PIM
new	Neu
as new	Wie neu
refurbished	Generalüberholt
good	Gut
used	Gebraucht
reasonable	Akzeptabel
moderate	Mäßig
damaged	Beschädigt

Ein Produkt ohne Zustand im PIM erhält used oder new, je nachdem, ob es als gebraucht markiert ist.

Die Zustandsbeschreibung wird als Produkt-Meta condition_description gespeichert (StoreLinkr-Plugin ab Version 2.20.0). Zeigen Sie beides auf der Produktseite an mit:

add_action('woocommerce_single_product_summary', function() {
    global $product;

    if (!$product instanceof WC_Product) {
        return;
    }

    $labels = [
        'new' => 'New',
        'as new' => 'As new',
        'refurbished' => 'Refurbished',
        'good' => 'Good',
        'used' => 'Used',
        'reasonable' => 'Reasonable',
        'moderate' => 'Moderate',
        'damaged' => 'Damaged',
    ];
    $condition = $product->get_meta('condition');
    $description = $product->get_meta('condition_description');

    if (isset($labels[$condition])) {
        echo '<p class="product-condition"><strong>Condition:</strong> ' . esc_html($labels[$condition]) . '</p>';
    }
    if ($description !== '') {
        echo '<p class="product-condition-description">' . nl2br(esc_html($description)) . '</p>';
    }
}, 16);

Das Meta wird entfernt, wenn die Zustandsbeschreibung geleert wird.