> ## 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.