Sources: Feeds, Kalender, APIs und Tabellen in YOOtheme Pro

Sources ist kein Builder-Element, sondern eine Sammlung von Datenquellen für den Dynamic Content von YOOtheme Pro, unter Joomla und unter WordPress. Du nimmst ein Element, dessen Gestaltung dir gefällt, etwa ein Grid, eine Liste oder eine Slideshow, und verbindest es mit einem Feed, einem Kalender, einer API oder einer Tabelle. Die Felder erscheinen im Dynamic-Content-Dialog in der Gruppe Tonino Gerns, genauso wie Beiträge oder Artikel. Das Aussehen bleibt deine Entscheidung im Builder, den Inhalt liefert die Quelle.

Die Quellen im Überblick

• RSS- und Atom-Feeds: Titel, Text, HTML-Inhalt, Datum, Link, Bild und Autor aus jeder Feed-URL, etwa für News, Blogartikel oder Podcast-Folgen
• iCal-Kalender: Termine aus Outlook, Google Kalender, Nextcloud oder einem Abfallkalender, mit Serienterminen, Ausnahmen, ganztägigen und mehrtägigen Terminen in einem Zeitfenster
• JSON-APIs und JSON-Dateien als benannte Verbindungen mit eigenen Feldern
• CSV-Dateien und veröffentlichte Google Sheets, eingerichtet wie die JSON-Verbindungen
• YouTube: die neuesten Videos eines Kanals oder einer Playlist, auf Wunsch ohne Shorts. Dafür brauchst du einen eigenen Schlüssel für die YouTube Data API
• Google-Bewertungen: Durchschnitt, Anzahl und bis zu fünf Bewertungen eines Unternehmensprofils. Dafür brauchst du einen eigenen Schlüssel für die Google Places API
• Joomla-Banner aus com_banners, einzeln oder als gefilterte Liste, nur unter Joomla

JSON und CSV: einmal verbinden, echte Felder bekommen

Eine API oder Tabelle richtest du einmal im Customizer ein, statt in jeder Bindung eine URL und Spaltennamen einzutippen. Du gibst der Verbindung einen Namen und trägst eine URL ein oder wählst eine Datei aus dem Medienordner deiner Website. Ein Klick auf "Felder erkennen" liest die ersten Einträge, schlägt bei JSON den Pfad zur Liste vor und legt für jedes Feld Bezeichnung und Typ fest: Text, HTML, Zahl, Ja/Nein, Datum, URL oder Bild. Du entscheidest, welche Felder du verwendest.

Jede Verbindung erscheint danach als eigene Quelle, zum Beispiel "JSON - Produktkatalog" oder "CSV - Öffnungszeiten", mit genau den Feldern, die du freigegeben hast. Listen innerhalb eines Eintrags, etwa die Bewertungen oder Bilder eines Produkts, gibt es als zusammengefügten Text und als Unterliste, die ein Mehrfach-Element wiederholen kann. Benennst du eine Verbindung um, bleiben deine Bindungen bestehen. Braucht eine API einen Zugangsschlüssel, gehört er ins Token-Feld der Verbindung und wird nur an den Server dieser URL geschickt.

Statt einer URL kannst du eine CSV-, JSON- oder TXT-Datei aus dem Medienordner deiner Website nehmen, bis 5 MB. Ersetzt du die Datei, gilt die neue Fassung ab dem nächsten Seitenaufruf. Zahlen liest Sources in deutscher wie in englischer Schreibweise, etwa 6,50, 1.234,50 oder 1.500 €. Mehrdeutige Werte wie 1.500 ohne Währungszeichen schlägt die Felderkennung nicht als Zahl vor, statt still falsch zu lesen.

Ein Panel für alles: TG - Sources

Eingestellt wird im YOOtheme-Customizer unter Einstellungen, TG - Sources. Dort schaltest du jede Quelle einzeln ein oder aus, hinterlegst die API-Schlüssel, legst Verbindungen an und bestimmst, wie lange Daten im Cache bleiben. Die Vorgaben: RSS und iCal eine Stunde, JSON und CSV 15 Minuten, YouTube sechs Stunden, Google-Bewertungen 24 Stunden. Je Quelle siehst du, wann der letzte Abruf gelang und welcher Fehler zuletzt auftrat, und du kannst den Cache leeren.

API-Schlüssel und Zugangstoken liegen nicht in den Theme-Einstellungen, sondern getrennt in den Plugin-Einstellungen. Nach dem Speichern zeigt das Panel nur noch "gespeichert" an, der Wert geht nie zurück an den Browser und steht in keinem Export der Theme-Einstellungen. Ändern dürfen ihn nur Super User unter Joomla und Administratoren unter WordPress, im Multisite-Netzwerk die Netzwerk-Administratoren.

Abruf auf deinem Server, nicht im Browser

Alle Daten holt dein Server, nicht der Browser deiner Besucher. Deren IP-Adressen gehen beim Laden eines Feeds, eines Kalenders oder einer API also nicht an fremde Dienste. Die Ergebnisse landen im Cache, die Seite wartet deshalb nicht bei jedem Aufruf auf eine fremde API. Fällt eine Quelle aus, zeigt Sources bis zu sieben Tage lang den letzten guten Stand statt einer leeren Stelle.

Eine Ausnahme solltest du kennen: Bilder aus Feeds, Vorschaubilder von YouTube und Profilfotos aus Google-Bewertungen bleiben Adressen auf fremden Servern. Bindest du sie im Layout ein, lädt der Browser sie von dort. Das gehört wie jede eingebundene Fremdressource in deine Datenschutzerklärung.

Fremde Daten, sauber gefiltert

Was aus einem fremden Feed kommt, landet auf deiner Seite. Sources ruft deshalb nur http- und https-Adressen ab, sperrt private und lokale Netzwerkadressen, prüft jede Weiterleitung neu und hält die geprüfte IP-Adresse fest, damit ein DNS-Trick nicht doch ins interne Netz führt. Jeder Abruf hat höchstens 5 Sekunden und 5 MB. Textfelder kommen als reiner Text an, HTML-Felder laufen durch eine Positivliste erlaubter Tags, Links und Bilder sind nur mit http oder https erlaubt. Bereinigt wird vor dem Cache, gespeichert wird nur, was schon sauber ist.

Google-Bewertungen und das UWG

Die Google Places API liefert höchstens fünf Bewertungen je Unternehmen, sortiert nach Relevanz. Sources kann sie nach Mindeststernen filtern. Wer nur ausgewählte Bewertungen zeigt, sollte Durchschnitt und Gesamtzahl mit anzeigen und auf Google verlinken, sonst droht eine Irreführung nach dem UWG. Die Felder dafür liefert die Quelle immer mit: Durchschnitt, Gesamtzahl, Link zum Profil und zu allen Bewertungen sowie die Quellenangabe von Google. Die Einstellung im Builder weist dich darauf hin.

Lizenz und Aktivierung

Eine Lizenz gilt für bis zu drei Websites, wahlweise unter Joomla oder WordPress. Mit dem Download-Key aus deinem Kundenkonto aktiviert sich Sources für die Domain der Website. Im Panel TG - Sources steht danach die Website-Kennung, dieselbe Kennung findest du in deinem Kundenkonto unter Lizenzverwaltung. Dort gibst du eine Website auch wieder frei, wenn du umziehst oder den Platz für eine andere Website brauchst.

Lokale Umgebungen wie localhost, private Netzwerkadressen, .test, .local oder .ddev.site laufen ohne Aktivierung und belegen keinen Platz. Eine Staging-Kopie unter dev., staging., test., demo. oder sandbox. einer aktivierten Domain ist mit abgedeckt. Die Aktivierung läuft online: Deine Website braucht dafür einmal eine Verbindung zum Lizenzserver und gleicht die Aktivierung danach einmal pro Woche ab. Eine Offline-Aktivierung per Code gibt es für Sources nicht. Solange eine Live-Website nicht aktiviert ist, zeigen die Quellen dort keine Inhalte.

Kurzanleitung

1. Plugin installieren. Unter Joomla aktiviert es sich selbst, unter WordPress aktivierst du es in der Plugin-Liste.
2. Download-Key aus deinem Kundenkonto hinterlegen: unter Joomla bei System, Update-Seiten, unter WordPress bei Einstellungen, Sources. Damit bekommst du Updates, und Sources wird für deine Website aktiviert.
3. Den YOOtheme-Customizer öffnen und unter Einstellungen, TG - Sources die Quellen einschalten, die du brauchst. Für YouTube und Google-Bewertungen den API-Schlüssel eintragen, für JSON und CSV eine Verbindung anlegen und die Felder erkennen lassen.
4. Im Builder ein Element wählen, zum Beispiel ein Grid, und im Dynamic-Content-Dialog in der Gruppe Tonino Gerns die Quelle auswählen.
5. Die Felder der Quelle mit Titel, Inhalt, Bild und Link des Elements verbinden.

Wenn etwas nicht erscheint

• Die Quellen zeigen auf der Live-Website keine Inhalte: Sources ist dort noch nicht aktiviert. Das Panel TG - Sources zeigt unter Lizenz, was fehlt. Ist die Lizenz schon auf drei Websites aktiv, gibst du im Kundenkonto eine frei oder kaufst eine weitere Lizenz.
• Ein gebundenes Element ist verschwunden: Die Quelle ist im Panel abgeschaltet oder die Verbindung wurde gelöscht. YOOtheme blendet Elemente ohne gültige Quelle aus.
• Eine Adresse im eigenen Netz wird abgelehnt: Private und lokale Adressen sind gesperrt. Für ein Intranet oder eine lokale Testumgebung gibt es im Panel den Schalter "Lokale Netzwerkadressen erlauben".
• Neue Einträge fehlen: Der Cache liefert noch den alten Stand. Warte die Cache-Dauer ab oder leere den Cache im Panel.
• Eine Datei-Verbindung findet die Datei nicht: Erlaubt sind nur .csv-, .json- und .txt-Dateien bis 5 MB im Medienordner der Website.
• YouTube oder Google-Bewertungen bleiben leer: Prüfe im Panel, ob der API-Schlüssel gespeichert ist, und sieh beim Cache-Status nach dem letzten Fehler.

Voraussetzungen

• Joomla 5 oder 6 mit YOOtheme Pro 4.5 oder 5 und PHP 8.2 oder neuer
• WordPress 6.5 oder neuer mit YOOtheme Pro 5 und PHP 8.2 oder neuer
• Für YouTube und Google-Bewertungen je ein eigener API-Schlüssel aus der Google Cloud
• Für die Aktivierung einmal eine Verbindung der Website zum Lizenzserver
• Die Lizenz gilt für bis zu drei Websites, wahlweise unter Joomla oder WordPress, mit Updates und Support während der Laufzeit. Ob du einmalig kaufst oder ein Abo abschließt, wählst du beim Kauf über CopeCart.