Integration

Der WebKatalog kann in bestehende Websites und Shopsysteme integriert werden. Es gibt zwei Haupt-Szenarien:

iFrame-Integration

Der WebKatalog wird als <iframe> in eine bestehende Website eingebettet. Dies ermöglicht:

• Einbettung in jede beliebige Website
• Eigenes Design und Layout der umgebenden Seite
• Kommunikation über postMessage API

→ Mehr zur iFrame-Integration

postMessage-Kommunikation

Die bidirektionale Kommunikation zwischen WebKatalog und Elternseite ermöglicht:

• Dynamische Konfiguration: Preise, Rabatt, Theme und Artikel live setzen (SET_CONFIG, SET_THEME, SET_ARTICLE)
• Warenkorb-Ereignisse: Meldung, wenn ein Artikel in den Warenkorb gelegt wird (BASKET_UPDATED)
• Benutzer-Tracking: Artikelauswahl, Warenkorb, Merkzettel (weitere Ereignisse geplant)
• Fehlerbehandlung: Meldung, wenn beim Verarbeiten einer Nachricht ein Fehler auftritt
• Lead-Generierung: Kontaktanfragen mit Artikeldaten (geplant)

→ Mehr zur postMessage-Kommunikation

Architektur

graph TB
    subgraph "Kunden-Website"
        FE[Frontend / Shop]
    end
    
    subgraph "WebKatalog (iFrame)"
        WK[WebKatalog Frontend]
        PM[postMessage Service]
    end
    
    subgraph "3D office APIs"
        XCF[XCF - Katalog]
        OFML[OFML - Artikel]
        ODB[ODB - Grafik]
    end
    
    FE <-->|"postMessage"| WK
    WK --> XCF
    WK --> OFML
    WK --> ODB

Voraussetzungen

Für die Integration wird benötigt:

• Gültiges Session-Token für die Authentifizierung
• Optional: postMessage-Handler für erweiterte Integration

Gut zu wissen

Die einfachste Art der Integration ist die direkte iFrame-Einbettung ohne postMessage. Für Warenkorb-Ereignisse, Tracking und Live-Einstellungen nutzen Sie postMessage.