# Backlinkseller
Bringt Ihre Backlinkseller-Werbeplätze als Element in den YOOtheme-Pro-Seitenersteller · Version 2.7.5 · Stand 18.09.2026
# Backlinkseller im Überblick
## Was die Erweiterung macht
Die Erweiterung bringt Ihre Werbeplätze von Backlinkseller als eigenes Element in den YOOtheme-Pro-Builder. Sie platzieren das Element an der Stelle, an der die Links erscheinen sollen, und gestalten es wie jede andere Liste im Builder — Aufzählung, Spalten, Abstände, Linkstil.
Bisher mussten die Werbeplätze über ein Child-Theme oder ein eigenes Template-Fragment eingebaut werden. Das entfällt: Die Erweiterung ist ein Plugin, das sich selbst beim Builder anmeldet.
## Wie die Links auf die Seite kommen
1. Das Element fragt beim Aufbau der Seite den Backlinkseller-Dienst nach den Links, die für genau diese Seitenadresse vorgesehen sind.
2. Die Antwort wird zerlegt: Aus jedem Eintrag werden Adresse, Linktext und der Text davor und danach herausgelöst.
3. Das Element gibt die Einträge als Liste aus — im Stil, den Sie im Builder eingestellt haben.
4. Das Ergebnis wird zwischengespeichert, damit nicht jeder Seitenaufruf einen neuen Abruf auslöst. Wie lange, bestimmen Sie.
## Was Sie dafür brauchen
- Ein Konto bei [backlinkseller.de](https://www.backlinkseller.de/?referrer=542949815) mit einer eigenen Kennung
- Joomla 6 und PHP 8.3
- YOOtheme Pro 4.5 oder 5.x als aktives Template
Ein Child-Theme wird **nicht** benötigt. Ein vorhandenes stört aber auch nicht.
## Was Sie einstellen können
Die Zugangsdaten stehen zentral in den Plugin-Einstellungen, nicht am einzelnen Element: Kennung, Kanal, Zwischenspeicherdauer und wahlweise eine feste Seitenadresse. Das Aussehen legen Sie dagegen je Element im Builder fest — Sie können dasselbe Konto also auf verschiedenen Seiten unterschiedlich darstellen.
Die Einzelheiten stehen unter [Einstellungen des Plugins](https://docs.graup-it.de/books/backlinkseller/page/einstellungen-des-plugins) und [Das Element im Builder verwenden](https://docs.graup-it.de/books/backlinkseller/page/das-element-im-builder-verwenden).
## Wichtig vor dem Einsatz
Der Backlinkseller-Dienst wird unverschlüsselt angesprochen, und bei jedem Abruf werden die IP-Adresse des Besuchers und die aufgerufene Seitenadresse an den Dienst übertragen. Beides hat Folgen für Ihre Datenschutzerklärung. Lesen Sie dazu [Datenschutz und Sicherheit](https://docs.graup-it.de/books/backlinkseller/page/datenschutz-und-sicherheit) — bitte vor der Freischaltung auf einer öffentlichen Website.
Gilt für Version 2.7.5.
[English version](https://docs.graup-it.de/link/187)
# Voraussetzungen und Installation
## Voraussetzungen
- **Joomla:** 6.0 oder neuer
- **PHP:** 8.3 oder neuer
- **YOOtheme Pro:** 4.5 oder 5.x, installiert und als Site-Template aktiv
- **Backlinkseller-Konto** mit eigener Kennung
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.
## Installation
1. Laden Sie das Installationspaket `plg_system_backlinkseller-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 - Backlinkseller*.
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.
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.
## Nach der Installation
1. Tragen Sie Ihre Backlinkseller-Kennung in den Plugin-Einstellungen ein — siehe [Einstellungen des Plugins](https://docs.graup-it.de/books/backlinkseller/page/einstellungen-des-plugins). Ohne sie liefert das Element nichts.
2. Leeren Sie den YOOtheme-Zwischenspeicher: *YOOtheme → Settings → Advanced → Clear Cache*.
3. Öffnen Sie eine Seite im Builder — im Element-Browser erscheint jetzt unter *Graup-IT* das Element *Backlinkseller*: 
4. Hinterlegen Sie Ihren Download-Schlüssel für automatische Updates — siehe [Download-Schlüssel und Updates](https://docs.graup-it.de/books/backlinkseller/page/download-schlussel-und-updates).
## Deinstallation
Deinstallieren Sie das Plugin über *System → Erweiterungen verwalten*. Die Erweiterung legt keine eigenen Datenbanktabellen an; es bleibt nichts zurück. Elemente, die Sie im Builder platziert haben, verlieren danach ihre Darstellung — entfernen Sie sie vorher aus den betroffenen Seiten.
Gilt für Version 2.7.5.
[English version](https://docs.graup-it.de/link/188)
# Download-Schlüssel und Updates
Backlinkseller erhält Updates über den offiziellen Joomla-Update-Mechanismus. Damit Ihre Website die Aktualisierungen abrufen darf, tragen Sie einmalig Ihren persönlichen Download-Schlüssel ein.
## Den Download-Schlüssel eintragen
1. Erzeugen Sie Ihren Download-Schlüssel in Ihrem Kundenkonto auf [graup-it.de](https://www.graup-it.de) (Menüpunkt *Download-IDs*). Ein Schlüssel gilt pro Website und deckt alle darüber bezogenen Erweiterungen ab.
2. Öffnen Sie im Backend *System → Aktualisieren → Update-Quellen*.
3. Öffnen Sie den Eintrag *Backlinkseller Updates* und tragen Sie den Schlüssel in das Feld *Download-Schlüssel* ein.
4. Speichern.
Achten Sie darauf, den Schlüssel **ohne führende oder abschließende Leerzeichen** einzufügen. Ein mitkopiertes Leerzeichen führt beim Update zu einer Fehlermeldung („URL rejected“ bzw. „Paketdownload fehlgeschlagen“).
## Updates einspielen
1. Öffnen Sie *System → Aktualisieren → Erweiterungen aktualisieren*.
2. Ist eine neue Version verfügbar, erscheint Backlinkseller in der Liste. Wählen Sie es aus und klicken Sie auf *Aktualisieren*.
3. Joomla lädt das Paket über Ihren Download-Schlüssel, prüft die Prüfsumme und spielt die neue Version ein. Ihre Einstellungen und Ihre Builder-Layouts bleiben dabei erhalten.
Findet Joomla kein Update, obwohl eine neue Version vorliegt, klicken Sie zunächst auf *Auf Updates prüfen*, um den Zwischenspeicher zu aktualisieren.
## Manueller Weg
Sie können jede Version auch manuell installieren: das ZIP herunterladen und wie bei der Erstinstallation über *System → Installieren → Erweiterungen* einspielen. Ein Update über das Paket überschreibt die vorhandene Installation und erhält Ihre Einstellungen.
Gilt für Version 2.7.5.
[English version](https://docs.graup-it.de/link/189)
# Einstellungen des Plugins
Die Zugangsdaten stehen zentral im Plugin, nicht am einzelnen Element. Sie finden sie unter *System → Plugins* im Eintrag *System - Backlinkseller*.
## Backlinkseller ID
Ihre Kennung von [backlinkseller.de](https://www.backlinkseller.de/?referrer=542949815), etwa `123456789.987654321`. Sie steht in Ihrem Backlinkseller-Konto. **Ohne sie liefert das Element nichts** — im Debug-Modus erscheint dann ein entsprechender Hinweis, im Normalbetrieb bleibt der Platz einfach leer.
Zulässig sind nur Ziffern und Punkte; alles andere wird beim Abruf verworfen.
## Seiten-URL (optional)
Backlinkseller ordnet die Links einer Seitenadresse zu. Lassen Sie das Feld **leer**, dann meldet die Erweiterung die tatsächlich aufgerufene Adresse — das ist der Normalfall und für die meisten Websites richtig.
Tragen Sie hier nur dann eine feste Adresse ein, wenn alle Werbeplätze unabhängig von der aufgerufenen Seite derselben Adresse zugeordnet werden sollen.
Eine feste Adresse gilt für die ganze Website. Legen Sie das Element auf mehreren Seiten ab, melden alle dieselbe Adresse an Backlinkseller — und bekommen dieselben Links.
## Backlinkseller Channel
Der Kanal bestimmt, welchen Server der Abruf anspricht: `channel1` bis `channel9`. Vorgabe ist `channel4`. Ändern Sie den Wert nur, wenn Backlinkseller Sie ausdrücklich dazu auffordert.
## Cache-Zeit (Sekunden)
Wie lange eine einmal geholte Antwort wiederverwendet wird, bevor erneut abgefragt wird. Vorgabe: **300 Sekunden** (5 Minuten), zulässig sind 0 bis 3600.
- **Höherer Wert:** weniger Abrufe, schnellerer Seitenaufbau, dafür wirken Änderungen bei Backlinkseller später.
- **0:** schaltet den Zwischenspeicher ab. Dann fragt *jeder* Seitenaufruf neu an. Nur zum Testen sinnvoll — im Betrieb kostet das spürbar Zeit.
Der Zwischenspeicher gilt für alle Besucher gemeinsam, nicht je Besucher. Er wird nach Kennung, Seitenadresse und Kanal geführt.
## Debug-Modus
Zeigt im Element die unbearbeitete Antwort des Dienstes, die daraus gewonnenen Einträge und etwaige Fehlermeldungen. **Schaltet zugleich den Zwischenspeicher ab.**
Nur zum Testen einschalten und danach wieder aus. Im Debug-Modus sehen Besucher technische Ausgaben, und jeder Seitenaufruf löst einen eigenen Abruf aus.
## Was das Element selbst mitbringt
Alles Gestalterische — Listenart, Aufzählungszeichen, Spalten, Textstil, Linkstil, Trennzeichen — stellen Sie am Element im Builder ein, nicht hier. Siehe [Das Element im Builder verwenden](https://docs.graup-it.de/books/backlinkseller/page/das-element-im-builder-verwenden).
Gilt für Version 2.7.5.
[English version](https://docs.graup-it.de/link/190)
# Das Element im Builder verwenden
## Das Element einfügen
1. Öffnen Sie die Seite im YOOtheme-Builder.
2. Fügen Sie ein neues Element hinzu und wählen Sie im Element-Browser die Gruppe *Graup-IT* → *Backlinkseller*.
3. Speichern Sie die Seite und rufen Sie sie im Frontend auf — dort erscheinen die Links.
Im Builder selbst sehen Sie die Links in der Regel nicht: Der Abruf richtet sich nach der Adresse der aufgerufenen Seite, und die Vorschau ist eine andere. Zum Prüfen der Einrichtung gibt es den *Test-Modus*, siehe unten.
## Test-Modus
Der Schalter *Test Modus* am Element ersetzt die Linkliste durch eine Übersicht der Werte, die aus den Plugin-Einstellungen ankommen: Kennung, Kanal, Seitenadresse, Zwischenspeicherdauer und Debug-Zustand. Ist keine Kennung hinterlegt, steht das dort ausdrücklich.
So prüfen Sie, ob das Element die Einstellungen sieht — ohne auf eine echte Antwort des Dienstes angewiesen zu sein. **Vor der Veröffentlichung wieder ausschalten.**
## Darstellung
Das Element folgt der Gestaltung des YOOtheme-Listenelements. Sie stellen ein:
- **Type:** untereinander (*vertical*) oder nebeneinander (*horizontal*).
- **Marker** und **Marker Color:** Aufzählungszeichen und dessen Farbe — nur bei der vertikalen Darstellung.
- **Style** und **Size:** Trennlinien, Streifen, Schriftgröße.
- **Separator:** das Trennzeichen zwischen den Einträgen — nur bei der horizontalen Darstellung. Vorgabe ist ein Komma mit Leerzeichen.
- **Columns**, **Columns Breakpoint** und **Divider:** mehrspaltiger Umbruch ab einer Bildschirmbreite, wahlweise mit Trennlinie.
- **HTML Element:** `ul` oder `ol`. Mit der Option daneben wird die Liste zusätzlich in ein `