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

# Installation

> Schritt-für-Schritt Anleitung zur Installation und Einrichtung von DZM Reloadify

<Warning>
  **BEVOR DU BEGINNST**

  Resources & Health muss dringend VOR allen anderen Plugins installiert und aktualisiert werden.
</Warning>

## Schnellübersicht

Hier ist ein Überblick über die wichtigsten Schritte zur Einrichtung von DZM Reloadify:

<Steps>
  <Step title="Reloadify Account eröffnen">
    Erstelle einen Account auf reloadify.com oder buche eine Demo
  </Step>

  <Step title="API Credentials anlegen">
    Generiere ClientID und Client Secret in deinem Reloadify Account
  </Step>

  <Step title="DZM Reloadify installieren">
    Installiere das Plugin in deinem JTL Shop
  </Step>

  <Step title="Verbindung herstellen">
    Verknüpfe den Shop mit ClientID und Client Secret
  </Step>

  <Step title="Language Mapping">
    Ordne die Sprachen zwischen JTL und Reloadify zu
  </Step>

  <Step title="Profile übertragen">
    Übertrage bestehende Kundenprofile (optional)
  </Step>

  <Step title="Produktfeed anlegen">
    Erstelle Feeds und übertrage Produkte und Kategorien
  </Step>

  <Step title="Bestellungen übertragen">
    Synchronisiere bisherige Bestellungen (optional)
  </Step>

  <Step title="Cronjobs aktivieren">
    Richte automatische Synchronisation ein
  </Step>
</Steps>

***

## Vorbereitung: Reloadify

### Reloadify Account erstellen

Wenn du noch keinen Reloadify Account hast, erstelle dir jetzt einen auf [reloadify.com](http://reloadify.com) oder buche dir eine unverbindliche Demo.

<Card title="Demo buchen" icon="calendar" href="https://www.reloadify.com/de/demo">
  Um herauszufinden, ob dein Webshop und Reloadify gut zusammenpassen, würden wir dich gerne etwas besser kennenlernen. Fordere eine Demo an.
</Card>

### API Credentials generieren

Zur Integration mit deinem JTL Shop benötigst du die API Credentials.

<Steps>
  <Step title="In Reloadify anmelden">
    Melde dich in deinem Reloadify Account an
  </Step>

  <Step title="Zu Einstellungen wechseln">
    Navigiere zu **Einstellungen**
  </Step>

  <Step title="API-Anmeldeinformationen öffnen">
    Klicke auf **API-Anmeldeinformationen**

    ![API Credentials](https://t4655718.p.clickup-attachments.com/t4655718/0062e572-58b5-45d2-8c3e-00d2efae4b56/image.png)
  </Step>

  <Step title="Neuen API Key erstellen">
    Klicke auf den Button **Neuer API Key**
  </Step>

  <Step title="Credentials notieren">
    In der Übersicht siehst du deine **ClientID** (Kunden ID) und dein **ClientSecret** (Secret Key)

    <Warning>
      Bewahre diese Daten sicher auf – du benötigst sie für die Einrichtung im JTL Shop.
    </Warning>
  </Step>
</Steps>

***

## Vorbereitung: JTL Shop Plugins

### Plugin-Dateien herunterladen

Die Installer-Pakete findest du jeweils am Produkt in der Sidebar mit allen veröffentlichten Versionen.

![Plugin Download](https://t4655718.p.clickup-attachments.com/t4655718/8908e2f5-f5d5-48a2-b599-26157332ad5a/image.png)

![Versionsübersicht](https://t4655718.p.clickup-attachments.com/t4655718/d55bafe4-2952-478e-bfb6-67d2251eb5f3/image.png)

<Note>
  Achte beim Download auf folgende Punkte:

  * **Resources & Health Anforderung**: Prüfe, ob das Plugin Resources & Health benötigt und in welcher Version
  * **Kompatible Shop-Version**: Stelle sicher, dass die Plugin-Version mit deiner JTL Shop Version kompatibel ist
  * **Lizenzquelle**: Wähle zwischen der JTL ExtStore Version und der DZM Store Version, je nachdem woher du deine Lizenz bezogen hast
</Note>

<Tip>
  **Resources & Health** ist unser kostenloses Plugin mit vielen spannenden Tools für deinen Shop. Für uns ist Resources & Health eine Codebase für die meisten Plugins, damit wir ressourcenschonend entwickeln können und bei der Verwendung mehrerer Plugins deinen Shop nicht unnötig mit doppelten Skripten belasten.
</Tip>

### Plugins installieren

<Steps>
  <Step title="Plugins herunterladen">
    Lade **Resources & Health** und **DZM Reloadify** von unserer Seite herunter
  </Step>

  <Step title="ZIP-Dateien hochladen">
    Lade die ZIP-Dateien über den Pluginmanager in deinem JTL Shop hoch
  </Step>

  <Step title="Resources & Health installieren">
    Installiere **zuerst** Resources & Health

    <Warning>
      Resources & Health muss immer als erstes Plugin installiert werden!
    </Warning>
  </Step>

  <Step title="DZM Reloadify installieren">
    Installiere anschließend DZM Reloadify
  </Step>
</Steps>

***

## Setup und Konfiguration

### Schritt 1: API anbinden

Wechsle in die Pluginsettings von **DZM Reloadify**.

![Plugin Settings](https://t4655718.p.clickup-attachments.com/t4655718/9ea72fc9-6bda-46e0-b73e-c8a963c68e9c/image.png)

<Steps>
  <Step title="Integration-Tab öffnen">
    Öffne den Reiter **Integration**
  </Step>

  <Step title="Credentials eintragen">
    Trage die **ClientID** und das **ClientSecret** ein, die du in deinem Reloadify Account erstellt hast
  </Step>

  <Step title="Speichern">
    **Bestätige die Eingabe durch Klick auf Speichern**
  </Step>

  <Step title="Verbindung prüfen">
    Wenn alles passt, hat sich dein AccessToken automatisch generiert
  </Step>
</Steps>

### Schritt 2: Language Mapping

Bleibe im Tab **Integration** und scrolle ein Stück weiter nach unten.

![Language Mapping](https://t4655718.p.clickup-attachments.com/t4655718/5b344cf3-591d-4451-a975-9fd765ea6cc5/image.png)

Wir müssen die Sprachschlüssel zwischen JTL und Reloadify verknüpfen.

<Steps>
  <Step title="JTL Shop Sprache wählen">
    Wähle eine Sprache deines JTL Shops aus der Dropdown-Liste
  </Step>

  <Step title="Reloadify Sprache zuordnen">
    Wähle anschließend die entsprechende Sprache in Reloadify aus
  </Step>

  <Step title="Mapping hinzufügen">
    Bestätige mit dem Button **Hinzufügen**
  </Step>

  <Step title="Weitere Sprachen">
    Wiederhole den Vorgang für alle weiteren Sprachen deines Shops
  </Step>
</Steps>

### Schritt 3: Profile übertragen (optional)

Mit **DZM Reloadify** werden deine Kontakte automatisch zu Reloadify übertragen, wenn sie einen Kauf getätigt haben oder sich für den Newsletter registriert haben.

Der Tab **Profile** zeigt dir eine Liste mit allen Kontakten, die für eine Übertragung in Frage kommen.

![Profile übertragen](https://t4655718.p.clickup-attachments.com/t4655718/99a997c8-518b-404f-94a0-d99061c3c0d3/image.png)

In der Tabelle siehst du:

* Ob die Kontakte für den Newsletter registriert sind
* Ob sie Bestellungen getätigt haben

<Steps>
  <Step title="Profile prüfen">
    Überprüfe die Liste der zu übertragenden Kontakte
  </Step>

  <Step title="Übertragung starten">
    Klicke auf **Übertragung starten**, um diese Kontakte zu Reloadify zu übertragen

    <Info>
      Bereits in Reloadify vorhandene Kontakte werden aktualisiert, nicht dupliziert.
    </Info>
  </Step>
</Steps>

<Note>
  Dieser Schritt ist optional. Neue Kontakte werden ab sofort automatisch synchronisiert, sobald sie eine Bestellung aufgeben oder sich für den Newsletter anmelden.
</Note>

### Schritt 4: Datafeed anlegen und Produkte übertragen

Wechsle in den Tab **Produktdaten** und erstelle deinen Datafeed.

<Warning>
  **Wichtige Hinweise zum Datafeed:**

  * Du benötigst einen Feed pro Sprache, wenn du verschiedene Sprachversionen deiner Produkte hast (Beschreibungen, Titel)
  * Du brauchst mindestens einen Feed
  * Der als **Standard** festgelegte Feed wird immer dann herangezogen, wenn es keinen spezielleren Feed gibt

  **Achte auf volle Sichtbarkeit deiner Produkte!**

  Wähle eine Kundengruppe, die alle Produkte sehen kann, da es sonst zu Problemen beim Bestellabgleich kommen kann. Im Zweifel kannst du eine neue Kundengruppe anlegen (z.B. mit dem Namen **Reloadify**), die du nur für den Produktfeed verwendest. So hast du volle Kontrolle über Sichtbarkeit und Preise.
</Warning>

![Datafeed erstellen](https://t4655718.p.clickup-attachments.com/t4655718/ea2c8e15-a33f-477e-93a0-0f64cee6bd5c/image.png)

<Steps>
  <Step title="Feed-Parameter wählen">
    Wähle **Sprache**, **Kundengruppe** und **Währung** aus
  </Step>

  <Step title="Als Standard markieren">
    **Dein erster Feed sollte als Standard behandelt werden** – aktiviere den Schalter
  </Step>

  <Step title="Feed hinzufügen">
    Bestätige abschließend mit Klick auf **Hinzufügen**
  </Step>

  <Step title="Weitere Feeds anlegen">
    Wiederhole den Vorgang für weitere Sprachen/Kundengruppen/Währungen (falls benötigt)
  </Step>
</Steps>

#### Produkte synchronisieren

![Produkte synchronisieren](https://t4655718.p.clickup-attachments.com/t4655718/b6e7a526-ca26-410e-9bc3-47b433147ae9/image.png)

Deine Produkte werden zusammengesucht und pro Feed angezeigt.

<Steps>
  <Step title="Synchronisierung starten">
    Klicke auf **Synchronisierung starten**, um deine Kategorien und Produkte zu übertragen
  </Step>

  <Step title="Fenster geöffnet lassen">
    Je nach Umfang deines Katalogs kann der Vorgang einige Zeit in Anspruch nehmen

    <Warning>
      **Lasse das Fenster bitte geöffnet**, bis die Synchronisierung abgeschlossen ist.
    </Warning>
  </Step>

  <Step title="Fortschritt beobachten">
    In den beiden Grafiken siehst du den Stand der Synchronisation:

    * **Grün** = Produkte synchronisiert
    * **Rot** = Produkte noch nicht übertragen
    * **Orange** = Produkt übertragen, aber Änderungen stehen aus
  </Step>
</Steps>

<Info>
  **Hinweis zur Produktzählung:**

  Mit **Produkte im Feed** sind Einzel- und Vaterartikel gemeint. Jeder Artikel wird übertragen. Hat ein Artikel Kindartikel, werden diese als Variante übertragen. Daher tauchen sie in der Zählung nicht mit auf.
</Info>

<Tip>
  **Automatisierung durch Cronjobs:**

  Du musst die Übertragung nicht manuell anstoßen. Wir haben dir dafür einen Cronjob angelegt, der regelmäßig:

  * Neue Produkte überträgt
  * Geänderte Produkte aktualisiert
  * Gelöschte Produkte aus Reloadify entfernt

  Siehe dazu die Beschreibung unter **Schritt 6: Cronjobs einrichten**.
</Tip>

### Schritt 5: Bestelldaten abgleichen (optional)

Dein Setup steht und neue Bestellungen werden bereits in die Liste zu übertragender Bestellungen aufgenommen und übermittelt (Cronjob vorausgesetzt, siehe unten).

Im Tab **Bestelldaten** hast du die Möglichkeit, auch vergangene Bestellungen zu übertragen, damit du mit Reloadify direkt eine gute Datenbasis hast.

![Bestelldaten abgleichen](https://t4655718.p.clickup-attachments.com/t4655718/0218e4ab-8ab0-4d40-bb99-b90cb0c028de/image.png)

<Steps>
  <Step title="Tab Bestelldaten öffnen">
    Wechsle in den Tab **Bestelldaten**
  </Step>

  <Step title="Übertragung starten">
    Klicke auf den Button **Start**, um vergangene Bestellungen zu übertragen
  </Step>

  <Step title="Abwarten">
    Die Übertragung läuft automatisch. Je nach Anzahl der Bestellungen kann dies einige Zeit dauern.
  </Step>
</Steps>

<Note>
  Dieser Schritt ist optional, aber empfehlenswert, um von Anfang an mit vollständigen Daten arbeiten zu können.
</Note>

### Schritt 6: Cronjobs einrichten

Damit Produkte, Bestellungen, Warenkörbe und Profile regelmäßig und automatisch synchronisiert werden, haben wir einige Cronjobs vorbereitet.

![Cronjobs einrichten](https://t4655718.p.clickup-attachments.com/t4655718/30fbb876-55f3-4d2c-b36f-6197b81ad4fe/image.png)

<Steps>
  <Step title="Cron-Verwaltung öffnen">
    Gehe zu **System › Cron**
  </Step>

  <Step title="Queue-Eintrag erstellen">
    Wechsle in den Tab **Queue-Eintrag erstellen**
  </Step>

  <Step title="Cronjobs anlegen">
    Lege für jeden der folgenden Cronjobs einen Eintrag an
  </Step>
</Steps>

#### Empfohlene Cronjob-Konfiguration

<AccordionGroup>
  <Accordion title="Produkte synchronisieren" icon="box" defaultOpen>
    **Häufigkeit:** Stündlich

    Überträgt neue Produkte, aktualisiert geänderte Produkte und entfernt gelöschte Produkte aus Reloadify.
  </Accordion>

  <Accordion title="Bestellungen synchronisieren" icon="cart-shopping">
    **Häufigkeit:** Stündlich

    Synchronisiert neue Bestellungen zu Reloadify für Marketing-Automatisierung und Kundenprofile.
  </Accordion>

  <Accordion title="Abgebrochene Warenkörbe synchronisieren" icon="basket-shopping">
    **Häufigkeit:** Stündlich

    Überträgt abgebrochene Warenkörbe für Remarketing-Kampagnen.
  </Accordion>

  <Accordion title="Abgemeldete Newsletter-Abonnenten synchronisieren" icon="envelope">
    **Häufigkeit:** Täglich

    Aktualisiert den Newsletter-Status in Reloadify, um Abmeldungen zu berücksichtigen.
  </Accordion>

  <Accordion title="Verwaiste Artikel & Kategorien löschen" icon="trash">
    **Häufigkeit:** Täglich

    Entfernt Produkte und Kategorien aus Reloadify, die im Shop gelöscht wurden.
  </Accordion>
</AccordionGroup>

***

## Installation abgeschlossen

<Check>
  Glückwunsch! Du hast DZM Reloadify erfolgreich installiert und eingerichtet.
</Check>

Dein JTL Shop ist nun mit Reloadify verbunden und synchronisiert automatisch:

* Kundenprofile und Newsletter-Abonnenten
* Bestellungen und Transaktionen
* Produktkatalog und Kategorien
* Abgebrochene Warenkörbe

Du kannst jetzt in deinem Reloadify Account personalisierte Marketing-Kampagnen erstellen und von automatisierten E-Mail-Workflows profitieren.

<Tip>
  Bei Fragen oder Problemen steht dir unser Support-Team gerne zur Verfügung.
</Tip>