Bundles, add-ons and "frequently bought together"

Drei Verkaufsmodule: Bundles, Produkt-Add-ons und “Häufig zusammen gekauft” (FBT). Jedes funktioniert unabhängig.

Anforderungen

Polski PRO erfordert: Polski (kostenlos) v1.3.0+, WordPress 6.4+, WooCommerce 8.0+, PHP 8.1+

Produkt-Bundles

Das Bundle-Modul ermöglicht das Erstellen konfigurierbarer Produktsets mit einem gemeinsamen Rabatt. Der Kunde kauft ein Bundle als ein einzelnes Produkt, und die einzelnen Komponenten sind in den Bestelldetails sichtbar.

Konfiguration

Gehen Sie zu WooCommerce > Einstellungen > Polski PRO > Bundles und aktivieren Sie das Modul (Option polski_bundles).

Einstellung	Standardwert	Beschreibung
Bundles aktivieren	Nein	Aktiviert die Bundle-Funktionalität
Rabattart	Prozent	percent (prozentual) oder fixed (fester Betrag)
Standardrabatt	10%	Rabatt, der auf neue Bundles angewendet wird
Ersparnis anzeigen	Ja	Zeigt dem Kunden den Ersparnisbetrag an

Ein Bundle erstellen

1. Gehen Sie zu Produkte > Erstellen
2. Wählen Sie im Bereich Produktdaten den Typ “Polski PRO Bundle”
3. Fügen Sie im Tab Bundle-Komponenten Produkte hinzu
4. Legen Sie die Menge für jede Komponente fest
5. Konfigurieren Sie den Rabatt (überschreibt den Standardwert)

Rabattberechnung

Der Bundle-Preis wird automatisch berechnet:

Cena pakietu = Suma cen składników - Rabat

Przykład (rabat 15%):
Produkt A: 100 zł x 1 = 100 zł
Produkt B:  50 zł x 2 = 100 zł
Suma:                    200 zł
Rabat (15%):              30 zł
Cena pakietu:            170 zł

Wenn eine Bundle-Komponente im Angebot ist, wird der Angebotspreis in den Berechnungen verwendet.

Bundle-Shortcode

[polski_bundle product_id="456" show_savings="yes" layout="grid"]

Parameter	Erforderlich	Beschreibung
product_id	Ja	ID des Bundle-Produkts
show_savings	Nein	Ersparnisbetrag anzeigen (yes/no)
layout	Nein	Layout: grid, list, compact

Bundle-Hooks

/**
 * Filtruje obliczoną cenę pakietu.
 *
 * @param float $bundle_price Obliczona cena pakietu
 * @param array $items        Składniki pakietu z cenami
 * @param float $discount     Wartość rabatu
 */
apply_filters('polski_pro/bundles/price', float $bundle_price, array $items, float $discount): float;

Beispiel - Mindestpreis für ein Bundle:

add_filter('polski_pro/bundles/price', function (float $bundle_price, array $items, float $discount): float {
    $minimum_price = 49.99;
    return max($bundle_price, $minimum_price);
}, 10, 3);

/**
 * Akcja wywoływana po dodaniu pakietu do koszyka.
 *
 * @param string $cart_item_key Klucz pozycji w koszyku
 * @param int    $bundle_id    ID produktu-pakietu
 * @param array  $items        Składniki pakietu
 */
do_action('polski_pro/bundles/added_to_cart', string $cart_item_key, int $bundle_id, array $items);

Produkt-Add-ons

Das Add-on-Modul ermöglicht die Anzeige optionaler Upsell-Produkte direkt auf der Produktseite. Der Kunde kann zusätzliche Produkte auswählen und sie mit einem einzigen Klick zusammen mit dem Hauptprodukt kaufen.

Konfiguration

Gehen Sie zu WooCommerce > Einstellungen > Polski PRO > Add-ons und aktivieren Sie das Modul (Option polski_addons).

Einstellung	Standardwert	Beschreibung
Add-ons aktivieren	Nein	Aktiviert die Add-on-Funktionalität
Anzeigeposition	Nach dem Warenkorb-Button	Wo der Add-on-Bereich angezeigt wird
Bereichsüberschrift	”Dodaj do zamówienia”	Überschriftstext über der Add-on-Liste
Maximale Anzahl	5	Limit der pro Produkt angezeigten Add-ons

Add-ons zuweisen

Add-ons werden im Produkteditor im Tab Polski PRO Add-ons konfiguriert:

1. Klicken Sie auf “Add-on hinzufügen”
2. Wählen Sie ein Produkt aus dem Katalog
3. Legen Sie den Add-on-Preis fest (standardmäßig der Produktpreis)
4. Legen Sie optional einen Aktionspreis für das Add-on fest
5. Legen Sie die Anzeigereihenfolge fest

Add-ons können einen anderen Preis als das Quellprodukt haben - dies ermöglicht spezielle “mit-Produkt”-Preise.

Auswahlvalidierung

Das Modul validiert:

• Lagerverfügbarkeit jedes ausgewählten Add-ons
• Preiskorrektheit (ob sie nicht clientseitig verändert wurden)
• Mengenbegrenzungen

Add-on-Hooks

/**
 * Filtruje listę dodatków dla produktu.
 *
 * @param array       $addons  Tablica dodatków z cenami
 * @param \WC_Product $product Produkt główny
 */
apply_filters('polski_pro/addons/items', array $addons, \WC_Product $product): array;

Beispiel - Add-ons anhand der Benutzerrolle filtern:

add_filter('polski_pro/addons/items', function (array $addons, \WC_Product $product): array {
    if (current_user_can('wholesale_customer')) {
        foreach ($addons as &$addon) {
            $addon['price'] = $addon['price'] * 0.8; // 20% rabatu hurtowego
        }
    }
    return $addons;
}, 10, 2);

Häufig zusammen gekauft

Das Empfehlungsmodul zeigt die Produkte an, die am häufigsten zusammen mit dem angesehenen Produkt gekauft werden, mit der Möglichkeit, mehrere Produkte mit einem einzigen Klick in den Warenkorb zu legen.

Konfiguration

Gehen Sie zu WooCommerce > Einstellungen > Polski PRO > Häufig zusammen gekauft und aktivieren Sie das Modul (Option polski_fbt).

Einstellung	Standardwert	Beschreibung
Modul aktivieren	Nein	Aktiviert die Empfehlungen
Datenquelle	Manuell	manual oder auto (basierend auf dem Bestellverlauf)
Produktlimit	3	Maximale Anzahl empfohlener Produkte
Bereichsüberschrift	”Często kupowane razem”	Text der Bereichsüberschrift
Position	Unter der Kurzbeschreibung	Wo der Bereich angezeigt wird

Manuelle Zuweisung

Im Produkteditor, Tab Häufig zusammen gekauft:

1. Suchen und fügen Sie verwandte Produkte hinzu
2. Legen Sie die Anzeigereihenfolge fest
3. Legen Sie optional einen Rabatt für den gemeinsamen Kauf fest

Automatische Empfehlungen

Wenn die Datenquelle auf auto gesetzt ist, analysiert das Modul den Bestellverlauf und identifiziert die Produkte, die am häufigsten zusammen gekauft werden. Die Analyse läuft einmal täglich über WP-Cron.

In den Warenkorb legen

Der Bereich “Häufig zusammen gekauft” zeigt:

• Checkboxen neben jedem empfohlenen Produkt
• Miniaturansichten und Produktnamen
• Einzelpreise der Produkte
• Gesamtpreis der ausgewählten Produkte
• Button “Alle in den Warenkorb legen”

Der Kunde markiert die gewünschten Produkte und fügt sie mit einem einzigen Klick hinzu. Alle Produkte werden als separate Positionen in den Warenkorb gelegt.

Shortcode

[polski_fbt product_id="789" limit="4" show_prices="yes"]

Parameter	Erforderlich	Beschreibung
product_id	Nein	ID des Hauptprodukts (standardmäßig das aktuelle)
limit	Nein	Maximale Anzahl an Empfehlungen
show_prices	Nein	Preise anzeigen (yes/no)

FBT-Hooks

/**
 * Filtruje listę rekomendowanych produktów.
 *
 * @param array $product_ids Tablica ID rekomendowanych produktów
 * @param int   $product_id  ID produktu głównego
 * @param string $source     Źródło: 'manual' lub 'auto'
 */
apply_filters('polski_pro/fbt/products', array $product_ids, int $product_id, string $source): array;

Beispiel - Produkte einer bestimmten Kategorie ausschließen:

add_filter('polski_pro/fbt/products', function (array $product_ids, int $product_id, string $source): array {
    $excluded_category_id = 42;
    return array_filter($product_ids, function (int $id) use ($excluded_category_id): bool {
        return ! has_term($excluded_category_id, 'product_cat', $id);
    });
}, 10, 3);

Zusammenspiel der Module

Alle drei Module können gleichzeitig am selben Produkt arbeiten:

• Ein Bundle mit zugewiesenen Add-ons und einem Bereich Häufig zusammen gekauft
• Bundle-Komponenten können ihre eigenen Add-ons haben
• FBT-Empfehlungen können auf Bundles verweisen

Die Anzeigereihenfolge auf der Produktseite lässt sich über die Prioritäten der WooCommerce-Hooks konfigurieren.

Fehlerbehebung

Der Bundle-Preis aktualisiert sich nach dem Ändern der Komponentenpreise nicht Der Bundle-Preis wird dynamisch berechnet. Leeren Sie den Object Cache und die WooCommerce-Transients.

Add-ons werden nicht auf der Produktseite angezeigt Prüfen Sie, ob das Theme den Hook woocommerce_after_add_to_cart_button unterstützt. Manche benutzerdefinierten Themes überspringen Standard-Hooks von WooCommerce.

Automatische Empfehlungen sind leer Das Modul benötigt historische Daten - automatische Empfehlungen erscheinen, nachdem eine ausreichende Anzahl an Bestellungen gesammelt wurde. Prüfen Sie, ob die WP-Cron-Aufgabe polski_pro_fbt_analyze geplant ist.

Nächste Schritte

• Probleme melden: GitHub Issues
• Verwandte Module: Vorbestellungen, Katalogmodus

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.