Dies ist eine alte Version des Dokuments!
Inhaltsverzeichnis
TCB Partnerlogos
TCB Partnerlogos ist eine Eigenentwicklung für TheCruiserBlog.
Das Plugin dient zur Verwaltung und Ausgabe von Partnerlogos auf TheCruiserBlog.
Aktueller Stand
| Version | Status | Einsatz |
|---|---|---|
| 1.0.0 | produktiv | TheCruiserBlog |
Zweck
TCB Partnerlogos stellt auf TheCruiserBlog eine zentrale Verwaltung und Ausgabe von Partnerlogos bereit.
Partner werden im WordPress-Backend verwaltet. Die Ausgabe der ausgewählten Partner erfolgt über einen eigenen Shortcode und kann dadurch an der gewünschten Stelle innerhalb von TheCruiserBlog eingebunden werden.
Ziel des Plugins ist es, die Verwaltung der Partner von der eigentlichen Seitengestaltung zu trennen und die Partnerlogos zentral pflegen zu können.
Funktionsumfang
Version 1.0.0 unterstützt:
- Verwaltung mehrerer Partner
- Partnername und Partnerlogo
- optionale Ziel-URL
- optionaler Kurztext
- individuelles Aktivieren und Deaktivieren von Partnern
- Priorität von 1 bis 10
- prioritätsgewichtete Zufallsauswahl
- optionale Sponsored-Kennzeichnung
- interne Notizen zu einem Partner
- konfigurierbare Ausgabe über einen Shortcode
- optionale Anzeige von Partnername und Kurztext
- responsive Darstellung der Partnerlogos
- Unterstützung mehrerer Shortcode-Instanzen auf einer Seite
- Erfassung von Einblendungen und Klicks
- automatische Berechnung der Klickrate (CTR)
- Zurücksetzen der Statistik für einzelne Partner
- gemeinsames Zurücksetzen aller Statistikwerte
- REST-basierte dynamische Partnerauswahl
- administrative Direktänderung von Aktiv-Status und Priorität
Für die Frontend-Ausgabe werden nur aktive Partner mit vorhandenem Partnernamen und Partnerlogo berücksichtigt.
Die Auswahl der Partner erfolgt zufällig. Die hinterlegte Priorität beeinflusst dabei die Auswahlwahrscheinlichkeit, nicht jedoch die Position eines Logos innerhalb der Ausgabe.
Bedienung
Die Verwaltung erfolgt im WordPress-Backend über den Menüpunkt:
TCB Partnerlogos
Für jeden Partner können folgende Angaben hinterlegt werden:
| Feld | Funktion |
|---|---|
| Partnername | Name des Partners |
| Partnerlogo | Logo des Partners |
| Ziel-URL | Optionale Internetadresse, die beim Klick auf das Partnerlogo geöffnet wird |
| Kurztext | Optionaler kurzer Beschreibungstext für die Frontend-Ausgabe |
| Priorität | Wert von 1 bis 10 zur Gewichtung bei der zufälligen Auswahl; Standardwert ist 5 |
| Aktiv | Legt fest, ob der Partner grundsätzlich für die Frontend-Ausgabe berücksichtigt wird |
| Sponsored | Kennzeichnet den Partnerlink bei Bedarf als Sponsored-Link |
| Interne Notiz | Optionale interne Information, die ausschließlich im Backend verwendet wird |
Neu angelegte Partner sind zunächst inaktiv.
Ein Partner kann nur aktiviert werden, wenn ein Partnername und ein Partnerlogo vorhanden sind.
Wird das Logo eines bereits aktiven Partners entfernt, bleibt der Partner intern aktiv, wird jedoch nicht mehr im Frontend ausgegeben. Sobald wieder ein Logo hinterlegt ist, kann der Partner erneut an der Auswahl teilnehmen.
Einbindung
Die Ausgabe von TCB Partnerlogos erfolgt über den Shortcode:
[tcb_partnerlogos]
Ohne weitere Attribute werden standardmäßig maximal vier Partnerlogos angezeigt.
Für die individuelle Konfiguration stehen folgende Shortcode-Attribute zur Verfügung:
| Attribut | Standard | Funktion |
|---|---|---|
anzahl | 4 | Maximale Anzahl der anzuzeigenden Partnerlogos |
hoehe | 150 | Maximale Höhe des Logobereichs in Pixeln |
abstand | 30 | Abstand zwischen den Partnerlogos in Pixeln |
name | nein | Partnername anzeigen; mögliche Werte: ja oder nein |
text | nein | Kurztext anzeigen; mögliche Werte: ja oder nein |
Beispiel:
[tcb_partnerlogos anzahl="6" hoehe="120" abstand="20" name="ja" text="nein"]
Dieses Beispiel zeigt maximal sechs Partnerlogos mit einer maximalen Logohöhe von 120 Pixeln und einem Abstand von 20 Pixeln. Der Partnername wird angezeigt, der Kurztext nicht.
Mehrere Instanzen des Shortcodes können unabhängig voneinander auf derselben Seite verwendet werden.
Zufallsauswahl und Priorität
Die im Frontend angezeigten Partner werden bei jedem Aufruf zufällig aus den verfügbaren aktiven Partnern ausgewählt.
Die hinterlegte Priorität von 1 bis 10 dient dabei als Gewichtung. Eine höhere Priorität erhöht die Wahrscheinlichkeit, dass ein Partner für die Ausgabe ausgewählt wird.
Ein Partner mit Priorität 10 besitzt beispielsweise die doppelte Auswahlchance gegenüber einem Partner mit Priorität 5.
Die Priorität beeinflusst ausschließlich die Wahrscheinlichkeit der Auswahl. Sie bestimmt nicht die Position des Partnerlogos innerhalb der Ausgabe.
Innerhalb einer einzelnen Shortcode-Ausgabe wird jeder Partner höchstens einmal angezeigt. Nach der gewichteten Auswahl wird auch die Reihenfolge der ausgewählten Partner zufällig bestimmt.
Stehen weniger geeignete Partner zur Verfügung als über das Shortcode-Attribut anzahl angefordert wurden, werden alle verfügbaren Partner angezeigt.
Als geeignet gelten aktive Partner mit vorhandenem Partnernamen und Partnerlogo.