# Häufige Fragen und Fehlerbehebung

## Die Quellen erscheinen nicht im Builder

1. Ist das Plugin unter *System → Plugins* aktiviert?
2. Ist YOOtheme Pro als Site-Template aktiv? Ohne YOOtheme bleibt das Plugin wirkungslos — das ist beabsichtigt.
3. Leeren Sie den YOOtheme-Zwischenspeicher: *YOOtheme → Settings → Advanced → Clear Cache*.
4. Suchen Sie unter *Dynamic Content* nach der Gruppe *Graup-IT*.

## Die Quellen sind da, aber die Auswahllisten sind leer

Das ist fast immer die Datenbankverbindung. Öffnen Sie die Plugin-Einstellungen und benutzen Sie *Datenbankverbindung testen*. Die Prüfung sagt Ihnen genau, woran es liegt.

- **Verbindung schlägt fehl:** Host, Benutzer, Passwort oder Port prüfen. Bei einem anderen Server: Nimmt der MySQL-Server Verbindungen von außen an, und ist der Benutzer für die IP-Adresse Ihres Joomla-Servers freigegeben?
- **Verbindung steht, aber Tabellen werden vermisst:** Das *Tabellen-Präfix* stimmt nicht. Vorgabe ist `t`.
- **Alles grün, Listen trotzdem leer:** Leeren Sie den YOOtheme-Zwischenspeicher — die Listen werden mit dem Builder-Schema zwischengespeichert.

## „Die Shopdaten sind derzeit nicht verfügbar"

Diese Meldung erscheint im Frontend, wenn der Zugriff auf den Shop scheitert. Der genaue Wortlaut steht bewusst nicht dort, sondern im Joomla-Protokoll: Die Meldung der Datenbank nennt Serveradresse, Benutzernamen und Schemanamen, und das geht Besucher nichts an.

Im Backend sehen Sie den vollständigen Wortlaut. Alternativ finden Sie ihn im Protokoll unter `plg_system_jtlshop`.

## Die Bilder werden nicht angezeigt

Prüfen Sie die *Shop-Basis-URL* in den Plugin-Einstellungen. Ist sie leer, setzt die Erweiterung die Bildadressen aus der Adresse Ihrer *Joomla-Website* zusammen — dort liegen die Bilder aber nicht. Tragen Sie die Adresse des Shops ein, ohne abschließenden Schrägstrich.

## Attributnamen erscheinen nicht übersetzt

Die übersetzten Bezeichnungen werden für die Sprache gelesen, die unter *Standardsprache* eingetragen ist — Vorgabe `ger`. Bei einem englischsprachigen Shop tragen Sie dort `eng` ein.

## Die Seite baut sich langsam auf

Jedes Produkt zieht weitere Abfragen für Preise, Bilder, Attribute und Varianten nach sich, und diese laufen gegen eine *entfernte* Datenbank — jede Abfrage kostet Netzwerkzeit.

- Setzen Sie die *Anzahl* so niedrig wie möglich.
- Ordnen Sie nur die Felder zu, die Sie wirklich anzeigen. Listen wie `images`, `attributes` oder `variations` werden nur geholt, wenn sie im Layout vorkommen.
- Nutzen Sie den YOOtheme-Zwischenspeicher, statt ihn abzuschalten.
- Liegen Shop und Website weit auseinander, ist die Netzwerklaufzeit die Untergrenze. Ein Server näher am Shop hilft mehr als jede Einstellung.

## Verändert die Erweiterung etwas im Shop?

Nein. Sie liest ausschließlich. Legen Sie trotzdem einen Datenbankbenutzer an, der nur lesen darf — siehe [Die Shop-Verbindung einrichten](https://docs.graup-it.de/books/jtl-source/page/die-shop-verbindung-einrichten). Dann ist es nicht nur so gemeint, sondern auch erzwungen.

## Ist das Passwort sicher gespeichert?

Nein — Joomla speichert Plugin-Einstellungen unverschlüsselt. Das Feld ist im Formular verdeckt, in der Datenbank steht es im Klartext. Deshalb die Empfehlung, einen eigenen Lesebenutzer zu verwenden: Dann ist das, was dort steht, nur für Lesezugriffe brauchbar.

## Brauche ich das Joomla-Kompatibilitäts-Plugin?

Nein. Die Erweiterung verwendet ausschließlich Schnittstellen, die Joomla 6 ohne dieses Plugin bereitstellt.

## Funktioniert die Erweiterung mit Joomla 5?

Nein. Ab Version 1.10.0 werden Joomla 6 und PHP 8.2 vorausgesetzt. Auf älteren Installationen bricht die Installation mit einem Hinweis ab.

## Ich nutze noch 1.9.8 — muss ich aktualisieren?

**Ja.** In 1.9.8 war die Verbindungsprüfung ohne Anmeldung erreichbar. Ein Besucher konnte die Website darüber als Netzwerksonde benutzen und prüfen, ob auf einem beliebigen Rechner ein Datenbankdienst läuft. Version 1.10.0 verlangt ein gültiges Sitzungstoken und das Recht, Erweiterungen zu verwalten.

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