Routing: Joomla
Gebruik deze handleiding wanneer Newsroom berichten naar een Joomla-website publiceert. Joomla en WordPress sluiten elkaar uit: een omroep kan maar één van de twee als website-koppeling actief hebben. Zie Rollen en rechten voor wie toegang heeft.
Wat je hier beheert
Bij het koppelen van Joomla vul je in:
- Host — het adres van de Joomla-website; Newsroom moet dit adres daadwerkelijk kunnen bereiken.
- API-token en de tokenpositie (als header
X-Joomla-Tokenof als Bearer-token) — hiermee praat Newsroom met de Joomla REST API. - YouTube-embedpositie (verplicht) — bepaalt waar een gekoppelde YouTube-video in het artikel terechtkomt: bovenaan, direct na het “lees meer”-punt, of onderaan het artikel.
Bij het opslaan test Newsroom de koppeling meteen door artikelen bij Joomla op te vragen met het opgegeven token. Lukt dit niet, dan kun je de koppeling niet opslaan — je krijgt geen “half werkende” koppeling.
Per omroep kan er maar één Joomla-koppeling actief zijn.
Rollen en rechten
Deze pagina — net als de rest van Settings > Routing, voor alle platforms — is alleen bereikbaar voor gebruikers met de rol Instellingen (dezelfde rol als voor de meeste andere Settings-pagina’s, bijv. AI-instellingen en Abonnement), geen aparte Joomla-specifieke rol. Zonder deze rol krijg je bij het openen van de hele Routing-pagina al een foutmelding in plaats van een overzicht van de gekoppelde platforms.
API-token aanmaken in Joomla zelf
Het token dat je in Newsroom invult, maak je niet in Newsroom aan, maar in de Joomla-beheeromgeving van de klant zelf. Dit gebeurt buiten Newsroom om en is eenmalig per Joomla-gebruiker:
Genereer het token bij de gekozen gebruiker
Ga naar Gebruikers > Beheren, open de gebruiker die je voor de koppeling wilt gebruiken, en open het tabblad Joomla API Token. Klik op Opslaan — Joomla genereert dan eenmalig het token en toont het direct op het scherm.
Kopieer het token meteen
Het token is na het aanmaken maar één keer zichtbaar, en alleen voor die specifieke gebruiker (ook andere Super Users zien het niet terug). Bewaar het direct veilig en vul het in bij de Joomla-koppeling in Newsroom.
Elke Joomla-gebruiker kan maar één actief token tegelijk hebben. Moet het token vervangen worden (bijvoorbeeld na een wachtwoordwijziging of personeelswissel), dan kan een beheerder met rechten op gebruikersbeheer het bestaande token intrekken of resetten in Joomla zelf.
Afbeeldingen gaan naar Joomla via een gekoppelde FTP/SFTP-server. Koppel eerst een FTP-server als je afbeeldingen wilt meesturen.
Afbeeldingeninstellingen
Los van de FTP-koppeling zelf stel je in:
- Beeldformaat — bij voorkeur webp; is er geen webp-variant van de afbeelding beschikbaar, dan valt Newsroom automatisch terug op jpg.
- Uploadpad — de map op de Joomla-server waar afbeeldingen terechtkomen
(standaard
/images). - Beeldpositie — of het beeld alleen in de introtekst, alleen in het volledige artikel, of in beide velden van Joomla geplaatst wordt.
- YouTube-embedpositie — dezelfde instelling die je al bij het aanmaken van de koppeling koos (zie Werkwijze hieronder); hier kun je ‘m achteraf gewoon opnieuw wijzigen, in hetzelfde scherm als beeldformaat/pad/positie.
Beeldpositie “Volledig artikel” of “Beide” + YouTube-embedpositie “direct na het lees meer-punt” botsen met elkaar. Heeft een bericht een “Lees meer”-punt én een gekoppelde YouTube-video, en staat de YouTube-embedpositie op “direct na het lees meer-punt”? Dan verwijdert Newsroom automatisch de foto uit het volledige-artikel-gedeelte van dat bericht — op die plek verschijnt dan alleen de video, niet de foto. Bij beeldpositie “Alleen introtekst” heeft dit geen effect; bij “Beide” blijft de foto in de introtekst wel gewoon staan, alleen het volledige-artikel-exemplaar verdwijnt. Zonder “Lees meer”-punt of zonder gekoppelde video blijft de foto overal gewoon staan.
Audio gaat niet via deze Joomla-koppeling — Wil je ook audio (bijv. een ingesproken versie van het bericht) via FTP laten uitleveren, dan regel je dat via het aparte platform FTP Audio in Settings > Routing, niet via de FTP-instellingen van Joomla zelf. FTP Audio hergebruikt dezelfde onderliggende FTP-verbindingstechniek als de Joomla-afbeeldingen, maar is een eigen, los te configureren koppeling.
Categoriekoppeling
Via de categoriekoppeling leg je vast welke Newsroom-categorie bij welke Joomla-categorie hoort (zelfde soort koppeling als bij WordPress, zie Routing: WordPress).
Joomla ondersteunt geen meerdere categorieën per artikel. Kies je bij een bericht meerdere categorieën (multi-categorie), dan gebruikt Joomla altijd alleen de eerst geselecteerde — de overige worden voor Joomla genegeerd.
Stel voor elke categorie die je in Newsroom gebruikt de bijbehorende Joomla-categorie in.
Auteursnaam overschrijven (alias)
Joomla toont voor elk artikel een auteursnaam (created_by_alias). Newsroom
vult die met de eerste waarde die het vindt in deze volgorde:
- Bronauteur van het bericht zelf — een veld dat je per bericht kunt invullen in de contenteditor (niet Joomla-specifiek, werkt voor elk platform).
- Als dat leeg is: de alias die de publicerende Newsroom-gebruiker zelf heeft ingesteld onder Gebruikers > Instellingen — ook dit is een algemeen profielveld, geen Joomla-instelling.
- Als ook dat leeg is: de gewone naam van de gebruiker.
Dit is dus geen instelling die je bij de Joomla-koppeling zelf terugvindt — er staat geen “auteursalias” in Settings > Routing > Joomla. Het komt uit twee algemene velden (bronauteur per bericht, alias per gebruiker) die alleen voor Joomla worden meegestuurd. WordPress gebruikt geen van beide velden — daar regel je auteurstoewijzing via de expliciete gebruikersmapping in de WordPress-koppeling zelf. Zie Routing: WordPress voor dat mechanisme.
Werkwijze
Maak eerst een API-token aan in Joomla zelf
Zie de stappen hierboven — dit gebeurt in Joomla, niet in Newsroom.
Open Settings > Routing en kies Joomla
Vul host, API-token en tokenpositie in.
Kies de YouTube-embedpositie
Deze instelling is verplicht, ook als je (nog) geen video’s publiceert.
Koppel een FTP/SFTP-server voor afbeeldingen
Vul de FTP-gegevens in en klik op testen. Pas als de test slaagt, kun je de koppeling opslaan — dit voorkomt dat je een koppeling opslaat waarmee beelden alsnog niet aankomen.
Stel beeldformaat, uploadpad en beeldpositie in
Deze bepalen hoe en waar het beeld in Joomla verschijnt. In hetzelfde scherm kun je ook de YouTube-embedpositie uit de vorige stap nog aanpassen.
Koppel categorieën
Via de categoriekoppeling leg je vast welke Newsroom-categorie bij welke Joomla-categorie hoort.
Publicatie per bericht is verplicht — Zodra Joomla gekoppeld is, staat de Joomla-toggle in de publicatiestap van een bericht altijd aan en is hij niet uit te zetten. Zie Publiceren naar je kanalen voor die stap.