> ## Documentation Index
> Fetch the complete documentation index at: https://docs.dreizack-medien.de/llms.txt
> Use this file to discover all available pages before exploring further.

# Einführung

> Luigi's Box für JTL Shop 5: KI-gestützte Suche, Autocomplete und Produktempfehlungen

## Was ist DZM Luigi's Box?

DZM Luigi's Box verbindet deinen JTL Shop 5 mit [Luigi's Box](https://luigisbox.de), einer KI-gestützten Such- und Discovery-Suite. Das Plugin überträgt deine Produktdaten, bindet Autocomplete und Suche in dein Frontend ein und meldet das Kaufverhalten deiner Kunden zurück, damit die KI daraus lernt.

<Note>
  Das Plugin ist kostenfrei. Es ist die **Anbindung** - die eigentliche Leistung erbringt die Luigi's Box Suite, für die du ein eigenes Konto benötigst. Ein kostenloses Konto legst du unter [app.luigisbox.com](https://app.luigisbox.com/users/onboarding?language=de) an.
</Note>

<AccordionGroup>
  <Accordion title="Produktfeed je Sprache">
    Pro Sprache eine eigene Anbindung mit eigener Tracker-ID. Hinter Luigi's Box steckt ein Sprachmodell - die saubere Sprachtrennung ist deshalb entscheidend für die Qualität der Ergebnisse.
  </Accordion>

  <Accordion title="Automatische Synchronisation">
    Ein Cronjob hält Preise, Bestände, Kategorien, Varianten und Merkmale aktuell. Einen manuellen Voll-Sync stößt du jederzeit aus dem Backend an.
  </Accordion>

  <Accordion title="Autocomplete und Suche">
    Luigi's Box blendet Vorschläge und Suchergebnisse in deiner bestehenden Suchleiste ein - mit Bild, Preis und Verfügbarkeit ab dem ersten Buchstaben.
  </Accordion>

  <Accordion title="Produktempfehlungen">
    Wahlweise als Luigi's Box Widget oder serverseitig als nativer Produktslider deines Templates. Platziert per OPC-Portlet oder automatisch je Seitentyp.
  </Accordion>

  <Accordion title="Analytics und Tracking">
    GA4-konforme E-Commerce-Events, wahlweise über deinen bestehenden Google Tag Manager oder über einen eigenen DataLayer. Consent-Anbindung inklusive.
  </Accordion>
</AccordionGroup>

## Voraussetzungen

| | |
| - | - |
| JTL Shop | 5.5.3 bis 5.8.1 |
| PHP | 8.2 bis 8.5 |
| DZM Resources und Health | ab 1.11.16 (kostenlos) |
| Cronjob | für die laufende Produktsynchronisation |
| Luigi's Box Konto | aktiv, mit Tracker-ID und Client-Secret |

<Warning>
  Installiere immer **zuerst DZM Resources & Health**. Das gilt auch bei einem Update: Erst Resources & Health aktualisieren, dann alle anderen Plugins von uns.
</Warning>

## Bereiche im Plugin

<CardGroup cols={2}>
  <Card title="Installation" icon="flag" href="/Luigis-Box/Installation">
    Plugin einspielen, Anbindung anlegen, Produktdaten synchronisieren und Analytics konfigurieren
  </Card>

  <Card title="Empfehlungen" icon="wand-magic-sparkles" href="/Luigis-Box/empfehlungen">
    Produktempfehlungen einrichten - nativer Slider oder Widget, per Portlet oder automatisch
  </Card>

  <Card title="Changelog" icon="clock-rotate-left" href="/Luigis-Box/changelog">
    Alle Updates und Änderungen
  </Card>
</CardGroup>

## Wie die Teile zusammenspielen

<Steps>
  <Step title="Das Plugin schickt Produktdaten raus">
    Je Sprache ein eigener Feed. Initial per Voll-Sync, danach laufend über den Cronjob.
  </Step>

  <Step title="Luigi's Box übernimmt Suchleiste und Ergebnisse">
    Das Plugin bindet das Luigi's Box Script in dein Template ein. Welche Elemente Luigi's Box dabei übernimmt, steuerst du über die Selektoren in deinem Luigi's Box Konto.
  </Step>

  <Step title="Das Kaufverhalten läuft zurück">
    Das Plugin liefert GA4-konforme E-Commerce-Events. Daraus lernt die KI, welche Produkte zu welcher Suchanfrage passen.
  </Step>

  <Step title="Ranking und Empfehlungen werden besser">
    Was geklickt und gekauft wird, steigt nach oben - ohne handgepflegte Synonymlisten und Rankings.
  </Step>
</Steps>

## Support

Fragen zu Search, Ranking, Synonymen und Auswertung beantwortet das **Luigi's Box Team** - das ist deren Oberfläche und deren Expertise.

Fehler im Plugin beheben wir über Updates. Beratung, Einrichtung und individuelle Anpassungen bieten wir als kostenpflichtige Leistung an.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.