# Häufige Fragen und Fehlerbehebung

## Die Quelle „Phoca Download" erscheint nicht im Builder

- Leeren Sie den YOOtheme-Zwischenspeicher: *YOOtheme → Settings → Advanced → Clear Cache*, danach den Builder neu laden.
- Prüfen Sie unter *System → Plugins*, ob *System - Phoca Download Source* aktiviert ist.
- Prüfen Sie, ob die Komponente Phoca Download installiert **und aktiviert** ist — ohne sie bleibt das Plugin bewusst inaktiv.
- Leeren Sie zusätzlich den Joomla-Cache (*System → Cache leeren*) und den Browser-Cache (Strg+F5).

## Es werden keine Dokumente angezeigt

- Dokumente müssen in Phoca Download **veröffentlicht** und **freigegeben** (approved) sein — beides wird geprüft.
- Im Modus „Automatisch": Stimmen die gewählten Kategorien? Liegt das Dokument in einer Unterkategorie, muss *Unterkategorien einbeziehen* aktiv sein.
- Im Modus „Manuell": Ist mindestens ein Dokument ausgewählt?
- Das Plugin folgt den Sichtbarkeitsregeln von Phoca Download: Dokumente mit eingeschränkter **Zugriffsebene** sehen nur berechtigte Besucher, und ein gesetzter **Veröffentlichungszeitraum** wird beachtet. Prüfen Sie beides im Dokument.

## Bilder werden nicht angezeigt

- Phoca-Download-Bilder liegen unter `images/phocadownload/` — prüfen Sie, ob die Datei dort existiert (im Zweifel im Dokument in Phoca Download neu zuweisen).
- Für Dateityp-Icons muss die Phoca-Download-Komponente ihre Medien mitinstalliert haben (`media/com_phocadownload/images/mime/`).

## Die Dateigröße ist 0 oder falsch

Das Plugin liest die Größe direkt aus der Datei im Phoca-Download-Ordner; nur wenn die Datei dort nicht lesbar ist, greift der in der Datenbank gespeicherte Wert. Prüfen Sie, ob die Datei im konfigurierten Download-Ordner liegt und der Dateiname im Dokument stimmt.

## Eigene Felder (Custom Fields) fehlen im Builder

- Die Felder müssen für Phoca-Download-Dokumente angelegt und veröffentlicht sein.
- Nach neu angelegten Feldern den YOOtheme-Zwischenspeicher leeren.

## Das Update schlägt fehl („403", „Invalid Domain", „URL rejected")

- Prüfen Sie den Download-Schlüssel unter *System → Aktualisieren → Update-Quellen* — ohne führende oder abschließende Leerzeichen.
- Der Schlüssel ist an Ihre Website-Domain gebunden; für eine neue Domain erzeugen Sie in Ihrem Kundenkonto einen weiteren Schlüssel.

## Verändert das Plugin meine Downloads?

Nein. Das Plugin liest ausschließlich Daten aus Phoca Download. Verwaltung, Rechte, Zugriffszählung und Auslieferung der Dateien bleiben vollständig bei der Komponente.

<small>Gilt für Version 1.7.2.</small>