# Voraussetzungen und Installation
## Voraussetzungen
- **Joomla:** 6.0 oder neuer
- **PHP:** 8.2 oder neuer
- **YOOtheme Pro:** installiert und als Site-Template aktiv
- **Phoca Download:** Version 6.x — kostenlos erhältlich auf [phoca.cz](https://www.phoca.cz/phocadownload)
Installieren Sie **zuerst Phoca Download**. Die Installation von Phoca Download Source prüft, ob die Komponente vorhanden ist, und bricht andernfalls mit einem Hinweis ab — ohne die Download-Verwaltung hätte das Plugin keine Daten, die es bereitstellen könnte.
## Installation
1. Laden Sie das Installationspaket `plg_system_ytp_phocadownload-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 - Phoca Download Source*.
Das Panel nach der Installation nennt die installierte Version und führt zu den drei Dingen, die jetzt anstehen: die Quelle im Builder auswählen, den Download-Schlüssel für Aktualisierungen hinterlegen und das Handbuch. Nach einem Update steht an der Stelle von „Erste Schritte“ das Änderungsprotokoll.
## Nach der Installation
1. Leeren Sie den YOOtheme-Zwischenspeicher: *YOOtheme → Settings → Advanced → Clear Cache*.
2. Öffnen Sie eine Seite im Builder — in den dynamischen Inhalten der Elemente erscheint jetzt die Gruppe „Phoca Download" mit den drei Quellen-Typen.
3. Tragen Sie Ihren Download-Schlüssel für automatische Updates ein — siehe [Download-Schlüssel und Updates](https://docs.graup-it.de/books/phoca-download-source/page/download-schlussel-und-updates).
## Update von Version 1.6 oder älter
Ein Update wird wie eine Neuinstallation über das ZIP oder bequem über den Joomla-Updater eingespielt; Ihre Einstellungen bleiben erhalten. Die Version 1.7 räumt dabei automatisch die Dateien älterer Plugin-Versionen auf und stellt eine bereits hinterlegte Download-ID auf das aktuelle Schlüsselformat um — Sie müssen nichts weiter tun.
## Deinstallation
Unter *System → Erweiterungen verwalten* das Plugin *System - Phoca Download Source*auswählen und deinstallieren. Ihre Downloads und Kategorien in Phoca Download bleiben vollständig erhalten; lediglich die Quelle im Builder entfällt. In Layouts verwendete Phoca-Download-Quellen zeigen danach keine Inhalte mehr an.
Gilt für Version 1.7.2.