# Häufige Fragen und Fehlerbehebung

## Das Element erscheint 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 und keine Fehlfunktion.
3. Leeren Sie den YOOtheme-Zwischenspeicher: *YOOtheme → Settings → Advanced → Clear Cache*. Der Element-Browser wird zwischengespeichert.
4. Suchen Sie im Element-Browser unter der Gruppe *Graup-IT*, nicht unter den Standardelementen.

## Das Element ist da, aber es erscheinen keine Links

Schalten Sie am Element den *Test-Modus* ein und sehen Sie sich die Seite im Frontend an. Die Übersicht zeigt, welche Werte ankommen.

- **„Nicht konfiguriert" bei der Kennung:** Tragen Sie die Backlinkseller-ID in den Plugin-Einstellungen ein.
- **Kennung ist da, trotzdem keine Links:** Schalten Sie zusätzlich den Debug-Modus im Plugin ein. Dann erscheint die Ursache im Klartext — siehe nächster Abschnitt.

<div class="callout warning" id="bkmrk-beide-schalter-nach-">Beide Schalter nach der Fehlersuche wieder ausschalten. Der Debug-Modus deaktiviert den Zwischenspeicher, der Test-Modus ersetzt die Linkliste durch die Übersicht.

</div>## Die Meldungen im Debug-Modus

- **„Backlinkseller ID ist nicht konfiguriert":** Die Kennung fehlt in den Plugin-Einstellungen.
- **„Verbindung zu Backlinkseller konnte nicht hergestellt werden":** Weder die deutsche noch die internationale Adresse hat innerhalb von 5 Sekunden geantwortet. Mögliche Gründe: Der Dienst ist gestört, Ihr Server lässt keine ausgehenden Verbindungen zu, oder eine Firewall blockiert Port 80.
- **„Ungültige Antwort vom Backlinkseller-Server":** Es kam eine Antwort, aber nicht im erwarteten Format. Prüfen Sie Kennung und Kanal.

## Auf der Seite stehen andere Links als erwartet

Backlinkseller ordnet die Links der gemeldeten Seitenadresse zu. Prüfen Sie im Test-Modus, welche Adresse gemeldet wird. Steht im Plugin eine feste *Seiten-URL*, gilt sie für alle Seiten gleichermaßen — leeren Sie das Feld, damit jede Seite ihre eigene Adresse meldet.

## Änderungen bei Backlinkseller wirken sich verzögert aus

Das ist der Zwischenspeicher. Warten Sie die eingestellte Cache-Zeit ab (Vorgabe 5 Minuten) oder leeren Sie den Joomla-Zwischenspeicher unter *System → Cache leeren*.

## Die Seite baut sich spürbar langsamer auf

Sehr wahrscheinlich antwortet der Dienst gerade nicht. Jeder Abruf wartet bis zu 5 Sekunden, und es gibt einen zweiten Versuch auf einer anderen Adresse. Fehlerantworten werden nicht zwischengespeichert, damit sich die Lage von selbst erholt — solange die Störung dauert, kostet das aber bei jedem Aufruf Zeit. Näheres unter [Datenschutz und Sicherheit](https://docs.graup-it.de/books/backlinkseller/page/datenschutz-und-sicherheit).

Prüfen Sie außerdem, ob die Cache-Zeit versehentlich auf `0` steht oder der Debug-Modus noch aktiv ist — beides schaltet den Zwischenspeicher ab.

## Muss ich ein Child-Theme anlegen?

Nein. Die Erweiterung meldet sich selbst beim Builder an. Ein vorhandenes Child-Theme stört aber nicht.

## 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 2.7.0 werden Joomla 6 und PHP 8.3 vorausgesetzt. Auf älteren Installationen bricht die Installation mit einem Hinweis ab, statt sich einzurichten und später auszufallen.

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