> ## 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 von NIUplus

## Installationsvideo

<iframe src="https://www.loom.com/embed/7d6fde33d9f4483ab1c8f11bd57e7cca" title="Loom video player" frameborder="0" className="w-full aspect-video rounded-xl" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture; web-share" allowfullscreen />

<Warning>
  **⚠️ BEVOR DU BEGINNST**

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

## Schnellstart (tl;dr)

<Steps>
  <Step title="Resources & Health installieren">
    Das Plugin muss als Erstes installiert sein
  </Step>

  <Step title="NIU Plus Companion installieren">
    Installiere das Companion Plugin
  </Step>

  <Step title="Lizenzschlüssel eintragen">
    Trage den Lizenzschlüssel in der Companion App ein
  </Step>

  <Step title="Template Files laden">
    Lade die Template Files über die Companion App
  </Step>

  <Step title="Werkeinstellungen setzen">
    Setze die initiale Konfiguration
  </Step>

  <Step title="Template kompilieren">
    Wechsle in den Tab **Variablen** und kompiliere das Template
  </Step>

  <Step title="Anpassen">
    Passe die Settings nach deinen Wünschen an. Nutze unser Styleshub für die wichtigsten Einstellungen
  </Step>
</Steps>

***

## Vorbereitung

### Wo finde ich die Installationsfiles?

Die Installer Pakete findest du jeweils am Produkt.

<div className="border border-[#DFE1E1] rounded-2xl overflow-hidden dark:border-transparent">
  <Frame>![Produktseite](https://t4655718.p.clickup-attachments.com/t4655718/584527a4-b9ba-4bfb-ac79-9684e08f28fa/image.png)</Frame>
</div>

<div className="border border-[#DFE1E1] rounded-2xl overflow-hidden dark:border-transparent">
  <Frame>![Versionsliste](https://t4655718.p.clickup-attachments.com/t4655718/6a549e67-118c-4275-a141-0535ef7acf88/image.png)</Frame>
</div>

In der Sidebar findest du alle veröffentlichten Versionen.

<Note>
  **Wichtige Hinweise bei der Versionswahl:**

  * Achte auf die Info, ob das Plugin Resources & Health benötigt und in welcher Version
  * Achte auf die kompatible Version
  * Wähle zwischen der JTL ExtStore Version und der DZM Store Version, je nachdem woher du deine Lizenz bezogen hast
</Note>

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

<Info>
  **Für NIU Plus gibt es aktuell 2 parallele Versionen:**

  * **1.x.x** für Shop Version 5.2.4 - 5.2.6
  * **2.x.x** für Shop Version 5.3.3 - 5.3.\*

  Diese unterscheiden sich nicht im Funktionsumfang, nur in der Kompatibilität. Alle 1er Versionen sind kompatibel mit Shop 5.2.x, alle 2er Versionen mit 5.3.x
</Info>

### Wo finde ich die Lizenzschlüssel?

Deine Lizenzschlüssel findest du direkt nach der Buchung in deinem Kundenkonto unter **Meine Lizenzen**

<div className="border border-[#DFE1E1] rounded-2xl overflow-hidden dark:border-transparent">
  <Frame>![Lizenzschlüssel](https://t4655718.p.clickup-attachments.com/t4655718/54435623-167b-4707-b23d-76cf534043ac/image.png)</Frame>
</div>

Diesen Lizenzschlüssel trägst du im jeweiligen Plugin ein.

<Note>
  Einen Lizenzschlüssel findest du hier nur, wenn du das Produkt über unseren Store gebucht hast.
</Note>

### Welche Lizenzen muss ich buchen?

Resources & Health benötigt keine Lizenz und kann direkt runter geladen und verwendet werden.

Alle anderen Plugins benötigen eine Lizenz.

**Für NIU Plus Starter+, Creative+ und Business+** benötigst du einen Lizenzschlüssel.

<Accordion title="Bundle Lizenzen für Creative+ und Business+">
  **NIU Plus Creative+ und Business+** bieten eine Bundle Lizenz für alle weiteren Produkte der OPC Suite.

  Das bedeutet, dass nur allein mit der Aktivierung einer Creative+ oder Business+ Lizenz automatisch auch die Plugins OPC Plus, OPC Conversion Booster, OPC Smarty Portlets und OPC Portlets vererben aktiviert hast.

  **In diesem Fall musst du in den anderen Plugins keinen eigenen Schlüssel mehr hinterlegen.**
</Accordion>

***

## Schritt-für-Schritt Installation

### 1. Resources & Health

Lade unter [https://store.dreizack-medien.de/DZM-Resources-Health](https://store.dreizack-medien.de/DZM-Resources-Health) unser Plugin **Resources & Health**

<div className="border border-[#DFE1E1] rounded-2xl overflow-hidden dark:border-transparent">
  <Frame>![Resources & Health Download](https://t4655718.p.clickup-attachments.com/t4655718/5e090647-59df-4740-a89f-2b358beb72c1/image.png)</Frame>
</div>

<div className="border border-[#DFE1E1] rounded-2xl overflow-hidden dark:border-transparent">
  <Frame>![Versionswahl](https://t4655718.p.clickup-attachments.com/t4655718/ff759739-f910-4879-9fca-be4c6263c839/image.png)</Frame>
</div>

Achte auf die Wahl der passenden Version

<div className="border border-[#DFE1E1] rounded-2xl overflow-hidden dark:border-transparent">
  <Frame>![Plugin hochladen](https://t4655718.p.clickup-attachments.com/t4655718/c723fe09-5876-490c-957d-c2f552fd1ce2/image.png)</Frame>
</div>

Lade die eben herunter geladene Zipdatei über den Plugin Manager in deinen Store hoch

<div className="border border-[#DFE1E1] rounded-2xl overflow-hidden dark:border-transparent">
  <Frame>![Plugin installieren](https://t4655718.p.clickup-attachments.com/t4655718/967c805b-eb14-4a99-9835-600aef6a3294/image.png)</Frame>
</div>

Unter **Vorhanden** wählst du nun das hochgeladene Plugin aus, akzeptierst ggfs die Lizenzbedingungen und klickst auf **Installieren**.

### 2. NIU Plus Lizenz buchen

<Steps>
  <Step title="Registrieren">
    Registriere dich in unserem Store
  </Step>

  <Step title="Paket wählen">
    Wähle unter [https://store.dreizack-medien.de/DZM-NIUplus-Template-Suite](https://store.dreizack-medien.de/DZM-NIUplus-Template-Suite) das passende Paket und die passende Kaufoption aus
  </Step>

  <Step title="Domain eintragen">
    In diesem Beispiel ordern wir eine Lizenz für **NIU Plus Creative+** als **Vollversion** und tragen unsere Domain ein, ohne `https://` oder führendes `www.`
  </Step>
</Steps>

<div className="border border-[#DFE1E1] rounded-2xl overflow-hidden dark:border-transparent">
  <Frame>![Lizenz buchen](https://t4655718.p.clickup-attachments.com/t4655718/2a3e59f3-8212-40c5-8299-f531ab9860c8/image.png)</Frame>
</div>

<Warning>
  **Achtung!** Diese Auswahl ist nur möglich, wenn du bereits angemeldet bist. Eine Bestellung ohne Registrierung ist ausgeschlossen!
</Warning>

<Accordion title="Lizenz von Demo/Entwickler zu Vollversion umwandeln">
  Wenn du bereits eine Demo- oder Entwicklerlizenz hast und angemeldet bist, kannst du alternativ zur Registrierung einer neuen Domain einfach unten im Dropdown deine bestehende Lizenz auswählen und in eine Vollversion umwandeln. Die passende Domain wird dann automatisch übernommen.
</Accordion>

<Info>
  Domains einer produktiven Lizenz kannst du später in deinem Kundenkonto bearbeiten und ändern. Wenn du also auf einer Staging Domain gearbeitet hast, kannst du die Lizenz hier in eine Vollversion umwandeln und anschließend in deinem Kundenkonto auf die Live Domain umschreiben.
</Info>

### 3. NIU Plus Companion Downloaden und installieren

Kehre nach erfolgreicher Buchung auf die Produktseite zurück und lade hier die passende Version der NIU Plus Companion App herunter: [https://store.dreizack-medien.de/DZM-NIUplus-Template-Suite](https://store.dreizack-medien.de/DZM-NIUplus-Template-Suite)

<div className="border border-[#DFE1E1] rounded-2xl overflow-hidden dark:border-transparent">
  <Frame>![Companion Download](https://t4655718.p.clickup-attachments.com/t4655718/da4b9896-d087-4eb0-8aa2-2763b6ab90f1/image.png)</Frame>
</div>

Lade anschließend die Zipdatei wie oben bei Resources & Health über den **Pluginmanager** in deinen Store hoch, und installiere das Plugin

### 4. Lizenz aktivieren

Wechsel in unserem Store in dein **Kundenkonto** unter **Meine Lizenzen** und kopiere dir den **Lizenzschlüssel** für deine Domain.

<Warning>
  **Selbstdeaktivierung des Plugins**

  Unter Umständen kann es passieren, dass sich das NIU Plus Companion Plugin so lange selbst deaktiviert, bis eine gültige Lizenz eingetragen wurde.

  Aktiviere in diesem Fall das Plugin einfach wieder und wechsle **sofort** in die **Plugineinstellungen** und trage den Lizenzschlüssel ein. In wenigen Ausnahmefällen kann es sein, dass sich das Plugin noch ein mal selbst deaktiviert, nachdem du den Schlüssel eingetragen hast. Aber keine Sorge. Nach letztmaliger Aktivierung bleibt es auch aktiviert. Versprochen ;)
</Warning>

<div className="border border-[#DFE1E1] rounded-2xl overflow-hidden dark:border-transparent">
  <Frame>![Plugin Einstellungen](https://t4655718.p.clickup-attachments.com/t4655718/68d35016-28a7-4bcb-b3e6-6ca16b1fe47e/image.png)</Frame>
</div>

<div className="border border-[#DFE1E1] rounded-2xl overflow-hidden dark:border-transparent">
  <Frame>![Lizenzschlüssel eintragen](https://t4655718.p.clickup-attachments.com/t4655718/44930d1d-e32e-4030-a8fc-21a80b6b9794/image.png)</Frame>
</div>

Trage deinen Lizenzschlüssel unter **Lizenz** ein und klick auf **Speichern**

<div className="border border-[#DFE1E1] rounded-2xl overflow-hidden dark:border-transparent">
  <Frame>![Lizenz aktiv](https://t4655718.p.clickup-attachments.com/t4655718/3c0db7ad-9941-483f-be5c-b780f5f867ee/image.png)</Frame>
</div>

Das Plugin signalisiert dir, dass die Lizenz valide und aktiv ist.

### 5. Setup

Wechsle in den **Setup** Bereich und folge der Anleitung.

<Steps>
  <Step title="Template Files herunterladen">
    Lade zuerst die Templatefiles herunter

    <div className="border border-[#DFE1E1] rounded-2xl overflow-hidden dark:border-transparent">
      <Frame>![Template Files laden](https://t4655718.p.clickup-attachments.com/t4655718/f343f5cf-d1d0-4df8-bf96-58c530407101/image.png)</Frame>
    </div>
  </Step>

  <Step title="Schreibrechte prüfen (optional)">
    Du kannst in Schritt 2 die Schreibrechte prüfen. In aller Regel gibt es hier keine Probleme und dieser Schritt dient eher der Selbstkontrolle oder einem Entwickler, für den unwahrscheinlichen Fall, dass es Probleme bei der Installation geben sollte.
  </Step>

  <Step title="Werkeinstellungen setzen">
    Klicke nun in Schritt 3 auf **Werkeinstellungen setzen**

    <div className="border border-[#DFE1E1] rounded-2xl overflow-hidden dark:border-transparent">
      <Frame>![Werkeinstellungen](https://t4655718.p.clickup-attachments.com/t4655718/eeb5a638-c45a-41b7-9475-dcd7438e5764/image.png)</Frame>
    </div>
  </Step>

  <Step title="Theme kompilieren">
    Wechsle nun zum Bereich **Variablen** und klicke auf **Theme kompilieren**

    <div className="border border-[#DFE1E1] rounded-2xl overflow-hidden dark:border-transparent">
      <Frame>![Theme kompilieren](https://t4655718.p.clickup-attachments.com/t4655718/06affb14-fbdb-47d1-a241-20cd799cbd0c/image.png)</Frame>
    </div>
  </Step>
</Steps>

### 6. Abschluss und weitere Schritte

<Note>
  **Herzlichen Glückwunsch!** Dein NIU Plus Template ist nun einsatzbereit.
</Note>

Du kannst nun mit der Konfiguration fortfahren oder weitere Plugins installieren.

Wenn du **NIU Plus Creative+** oder höher erworben hast, kannst du nun einfach die Plugins der OPC Reihe installieren. Folge dazu den üblichen Schritten wie bisher:

<Steps>
  <Step title="Download">
    Download des Installers von der Produktseite in der passenden Version
  </Step>

  <Step title="Hochladen">
    Hochladen über den Pluginmanager
  </Step>

  <Step title="Installieren">
    Installation durchführen
  </Step>
</Steps>

<Info>
  **Für Creative+ und höher ist für Plugins der OPC Reihe keine Buchung oder Aktivierung einer Lizenz notwendig.** Die NIU Plus Creative+ Lizenz aktiviert automatisch die übrigen OPC Plugins.
</Info>

***

## Kurzanleitung

<Accordion title="Kompakte Installationsschritte">
  <Steps>
    <Step>
      Lade das Plugin DZM Resources & Health in deinen Shop hoch und installiere es
    </Step>

    <Step>
      Lade das Plugin NIUplus Companion in deinen Shop hoch und installiere es
    </Step>

    <Step>
      Trage deinen Lizenzschlüssel in den Plugineinstellungen ein und aktiviere deine Lizenz
    </Step>

    <Step>
      Lade das Template NIUplus in deinen Template Ordner
    </Step>

    <Step>
      Lade ggfs das ChildTemplate in deinen Template Ordner
    </Step>

    <Step>
      Aktiviere das Template oder Childtemplate
    </Step>

    <Step>
      Wechsel zum Companion, wähl den Reiter "Variablen" und klicke unten auf kompilieren
    </Step>

    <Step>
      Wechsel zum Template, bearbeite es und speichere es erneut
    </Step>

    <Step>
      Wechsel zum Companion
    </Step>

    <Step>
      Gehe durch jeden Einstellungsreiter durch und klicke auf Speichern
    </Step>

    <Step>
      Das Template sollte jetzt einsatzbereit sein. lösche ggfs den Cache
    </Step>

    <Step>
      Achte darauf, dass du die richtigen Einstellungen in den Custom Boxes gesetzt hast
    </Step>
  </Steps>
</Accordion>

<div style={{height: '1px', backgroundColor: 'silver', margin: '24px 0'}} />