# Voraussetzungen und Installation

## Voraussetzungen

- **Joomla:** 6.0 oder neuer
- **PHP:** 8.2 oder neuer, mit der Erweiterung `mysqli`
- **YOOtheme Pro:** installiert und als Site-Template aktiv
- **JTL-Shop** mit erreichbarer MySQL-Datenbank

<div class="callout info" id="bkmrk-die-erweiterung-komm">Die Erweiterung kommt ohne das Kompatibilitäts-Plugin von Joomla aus. Wenn Sie es aus anderen Gründen aktiviert haben, stört das nicht — nötig ist es hier nicht.

</div>## Installation

1. Laden Sie das Installationspaket `plg_system_jtlshop-x.y.z.zip` aus Ihrem Kundenkonto auf [graup-it.de](https://www.graup-it.de) herunter.
2. Öffnen Sie im Joomla-Backend *System → Installieren → Erweiterungen*.
3. Ziehen Sie die ZIP-Datei in das Upload-Feld oder wählen Sie sie über *Durchsuchen* aus.

Das Plugin wird bei der Erstinstallation automatisch aktiviert. Sie finden es anschließend unter *System → Plugins* als *System - JTL Source*.

Nach der Installation erscheint ein Übersichtsfenster mit der installierten Version und den Einstiegen zu Erste Schritte, Download-Schlüssel und Handbuch. Nach einem Update steht an der Stelle von „Erste Schritte" das Änderungsprotokoll.

![Das Übersichtsfenster nach einem Update mit Versionsnummer und den Karten Was ist neu, Updates aktivieren und Hilfe](https://docs.graup-it.de/uploads/images/gallery/2026-08/wdUdoku-01-installationspanel.png)

<div class="callout warning" id="bkmrk-passt-die-umgebung-n">Passt die Umgebung nicht — zu altes Joomla, zu altes PHP —, bricht die Installation mit einer klaren Meldung ab, statt eine Erweiterung zu hinterlassen, die später stillschweigend nicht funktioniert.

</div>## Nach der Installation

1. Richten Sie die Verbindung zum Shop ein und prüfen Sie sie mit der eingebauten Schaltfläche — siehe [Die Shop-Verbindung einrichten](https://docs.graup-it.de/books/jtl-source/page/die-shop-verbindung-einrichten). **Ohne Verbindung bleiben die Quellen im Builder leer.**
2. Leeren Sie den YOOtheme-Zwischenspeicher: *YOOtheme → Settings → Advanced → Clear Cache*.
3. Öffnen Sie eine Seite im Builder — in den dynamischen Inhalten erscheint jetzt die Gruppe *Graup-IT* mit den beiden Quellen.
4. Hinterlegen Sie Ihren Download-Schlüssel für automatische Updates — siehe [Download-Schlüssel und Updates](https://docs.graup-it.de/books/jtl-source/page/download-schlussel-und-updates).

## Deinstallation

Deinstallieren Sie das Plugin über *System → Erweiterungen verwalten*. Die Erweiterung legt in Joomla keine eigenen Tabellen an, und am JTL-Shop ändert sie ohnehin nichts. Es bleiben nur die Plugin-Einstellungen zurück, die mit der Deinstallation entfernt werden.

<div class="callout info" id="bkmrk-denken-sie-daran%2C-de">Denken Sie daran, den für die Anbindung angelegten Datenbankbenutzer im Shop ebenfalls zu entfernen, wenn Sie ihn nicht mehr brauchen.

</div><small>Gilt für Version 1.12.0.</small>