Routing: Joomla
Diese Anleitung gilt, wenn Newsroom Beiträge auf einer Joomla-Website veröffentlicht. Joomla und WordPress schließen sich gegenseitig aus: ein Unternehmen kann immer nur eines von beiden als aktive Website-Anbindung haben. Siehe Rollen und Berechtigungen für die erforderliche Rolle.
Was Sie hier verwalten
Beim Verbinden von Joomla geben Sie ein:
- Host — die Adresse der Joomla-Website; Newsroom muss diese Adresse tatsächlich erreichen können.
- API-Token und die Token-Position (als Header
X-Joomla-Tokenoder als Bearer-Token) — damit kommuniziert Newsroom mit der Joomla-REST-API. - YouTube-Einbettungsposition (Pflichtfeld) — legt fest, wo ein verknüpftes YouTube-Video im Artikel landet: oben, direkt nach dem “Weiterlesen”-Punkt oder am Ende des Artikels.
Beim Speichern testet Newsroom die Verbindung sofort, indem Artikel mit dem angegebenen Token von Joomla abgerufen werden. Schlägt dies fehl, kann die Verbindung nicht gespeichert werden — Sie erhalten nie eine “halb funktionierende” Anbindung.
Pro Unternehmen kann nur eine Joomla-Anbindung aktiv sein.
Rollen und Berechtigungen
Diese Seite — wie der gesamte Bereich Settings > Routing, für alle Plattformen — ist nur für Benutzer mit der Rolle Settings erreichbar (derselben Rolle wie für die meisten anderen Settings-Seiten, z. B. KI-Einstellungen und Abonnement), keine eigene Joomla-spezifische Rolle. Ohne diese Rolle zeigt bereits das Öffnen der gesamten Routing-Seite eine Fehlermeldung statt einer Übersicht der verbundenen Plattformen.
API-Token in Joomla selbst erstellen
Das Token, das Sie in Newsroom eintragen, wird nicht in Newsroom erzeugt, sondern im Joomla-Backend des Kunden selbst. Das geschieht außerhalb von Newsroom und ist ein einmaliger Schritt pro Joomla-Benutzer:
Token für den gewählten Benutzer erzeugen
Gehen Sie zu Benutzer > Verwalten, öffnen Sie den Benutzer, der für die Anbindung verwendet werden soll, und öffnen Sie den Tab Joomla API Token. Klicken Sie auf Speichern — Joomla erzeugt das Token dann einmalig und zeigt es direkt auf dem Bildschirm an.
Token sofort kopieren
Das Token ist nach dem Erstellen nur einmal sichtbar, und zwar nur für diesen bestimmten Benutzer (auch andere Super User sehen es nicht erneut). Bewahren Sie es sofort sicher auf und tragen Sie es bei der Joomla-Anbindung in Newsroom ein.
Jeder Joomla-Benutzer kann immer nur ein aktives Token gleichzeitig haben. Muss das Token ersetzt werden (z. B. nach einer Passwortänderung oder einem Personalwechsel), kann ein Administrator mit Rechten für die Benutzerverwaltung das bestehende Token in Joomla selbst widerrufen oder zurücksetzen.
Bilder gelangen über einen verknüpften FTP/SFTP-Server zu Joomla. Verknüpfen Sie zuerst einen FTP-Server, wenn Bilder mitgesendet werden sollen.
Bildeinstellungen
Unabhängig von der FTP-Anbindung selbst stellen Sie ein:
- Bildformat — bevorzugt webp; ist keine webp-Variante des Bildes verfügbar, greift Newsroom automatisch auf jpg zurück.
- Upload-Pfad — der Ordner auf dem Joomla-Server, in dem Bilder landen
(Standard
/images). - Bildposition — ob das Bild nur im Intro-Text, nur im vollständigen Artikel oder in beiden Joomla-Feldern platziert wird.
- YouTube-Einbettungsposition — dieselbe Einstellung, die Sie schon beim Anlegen der Anbindung gewählt haben (siehe Vorgehensweise unten); hier lässt sie sich einfach erneut ändern, im selben Bildschirm wie Bildformat/-pfad/-position.
Bildposition “Vollständiger Artikel” oder “Beide” kollidiert mit der YouTube-Einbettungsposition “direkt nach dem Weiterlesen-Punkt”. Hat ein Beitrag einen “Weiterlesen”-Punkt und ein verknüpftes YouTube-Video, und steht die YouTube-Einbettungsposition auf “direkt nach dem Weiterlesen-Punkt”, entfernt Newsroom automatisch das Bild aus dem vollständigen-Artikel-Bereich dieses Beitrags — dort erscheint dann nur noch das Video, nicht das Bild. Bei Bildposition “Nur Intro-Text” hat dies keine Auswirkung; bei “Beide” bleibt das Bild im Intro-Text normal stehen, nur die Kopie im vollständigen Artikel verschwindet. Ohne “Weiterlesen”-Punkt oder ohne verknüpftes Video bleibt das Bild überall normal stehen.
Audio läuft nicht über diese Joomla-Anbindung — Wollen Sie zusätzlich Audio (z. B. eine gesprochene Version des Beitrags) per FTP ausliefern, regeln Sie das über die separate Plattform FTP Audio unter Settings > Routing, nicht über die FTP-Einstellungen von Joomla selbst. FTP Audio nutzt dieselbe zugrunde liegende FTP-Verbindungstechnik wie die Joomla-Bilder, ist aber eine eigene, separat konfigurierbare Anbindung .
Kategorieverknüpfung
Über die Kategorieverknüpfung legen Sie fest, welche Newsroom-Kategorie zu welcher Joomla-Kategorie gehört (gleiche Art von Verknüpfung wie bei WordPress, siehe Routing: WordPress).
Joomla unterstützt keine mehreren Kategorien pro Artikel. Wählen Sie bei einem Beitrag mehrere Kategorien (Multi-Kategorie), verwendet Joomla immer nur die zuerst ausgewählte — die übrigen werden für Joomla ignoriert.
Legen Sie für jede Kategorie, die Sie in Newsroom verwenden, die passende Joomla-Kategorie fest.
Autorennamen überschreiben (Alias)
Joomla zeigt für jeden Artikel einen Autorennamen (created_by_alias).
Newsroom füllt diesen mit dem ersten gefundenen Wert in dieser Reihenfolge:
- Quellautor des Beitrags selbst — ein Feld, das Sie pro Beitrag im Content-Editor ausfüllen können (nicht Joomla-spezifisch, funktioniert für jede Plattform).
- Ist das leer: der Alias, den der veröffentlichende Newsroom-Benutzer selbst unter Benutzer > Einstellungen festgelegt hat — auch das ist ein allgemeines Profilfeld, keine Joomla-Einstellung.
- Ist auch das leer: der normale Name des Benutzers.
Das ist also keine Einstellung, die Sie direkt bei der Joomla-Anbindung finden — es gibt kein “Autoren-Alias”-Feld unter Settings > Routing > Joomla. Es stammt aus zwei allgemeinen Feldern (Quellautor pro Beitrag, Alias pro Benutzer), die nur für Joomla mitgeschickt werden. WordPress verwendet keines von beiden — dort wird die Autorenzuordnung über die explizite Benutzerzuordnung in der WordPress-Anbindung selbst geregelt. Siehe Routing: WordPress für diesen Mechanismus.
Vorgehensweise
Zuerst ein API-Token in Joomla selbst erstellen
Siehe die Schritte oben — das geschieht in Joomla, nicht in Newsroom.
Settings > Routing öffnen und Joomla wählen
Host, API-Token und Token-Position eintragen.
YouTube-Einbettungsposition wählen
Diese Einstellung ist Pflicht, auch wenn (noch) keine Videos veröffentlicht werden.
FTP/SFTP-Server für Bilder verbinden
Die FTP-Daten eintragen und auf Testen klicken. Erst wenn der Test erfolgreich ist, kann die Anbindung gespeichert werden — so wird verhindert, dass eine Anbindung gespeichert wird, bei der Bilder trotzdem nicht ankommen.
Bildformat, Upload-Pfad und Bildposition einstellen
Diese legen fest, wie und wo das Bild in Joomla erscheint. In demselben Bildschirm lässt sich auch die YouTube-Einbettungsposition aus dem vorigen Schritt noch anpassen.
Kategorien verknüpfen
Über die Kategorieverknüpfung wird festgelegt, welche Newsroom-Kategorie zu welcher Joomla-Kategorie gehört.
Veröffentlichung pro Beitrag ist verpflichtend — Sobald Joomla verbunden ist, steht der Joomla-Schalter im Veröffentlichungsschritt eines Beitrags immer auf aktiv und kann nicht ausgeschaltet werden. Siehe Veröffentlichen auf Ihren Kanälen für diesen Schritt.