Newsfeeds in Joomla

2. News Feeds aanmaken

2.1 Maak eerst een categorie aan

Een feed moet altijd in een categorie staan, dus maak die eerst aan:

Componenten → News Feeds → Categorieën → Nieuw

Dit is een gewone Joomla-categorie met extension = com_newsfeeds. De categorie gebruikt dezelfde geneste boomstructuur, dezelfde toegangsrechten en dezelfde knop Herstellen als artikelcategorieën.

2.2 Maak de News Feed aan

Voeg daarna de feed zelf toe:

Componenten → News Feeds → Feeds → Nieuw

Drie velden zijn verplicht:

• Naam, de titel van de feed.
• Link, de feed-URL, bijvoorbeeld https://www.joomla.org/announcements?format=feed&type=rss.
• Categorie, de com_newsfeeds-categorie waarin de feed wordt geplaatst.

Tip: veel Joomla-sites bieden zelf RSS-feeds aan. Vaak kun je ?format=feed&type=rss toevoegen aan de URL van een categorieweergave om een bruikbare feed-URL te krijgen.

2.3 Weergave-instellingen van een feed

Elke feed heeft een aantal instellingen die bepalen hoe de items worden weergegeven:

Elk veld heeft ook de optie Globaal gebruiken. De standaardwaarden worden ingesteld via de componentopties.

2.4 De twee omlijstende afbeeldingen

Een feed kan twee afbeeldingen bevatten (image_first en image_second), elk met een alt-tekst, onderschrift en uitlijning:

[ image_first ]   ← bijvoorbeeld een partner- of sponsorlogo
   ...feeditems...
[ image_second ]

Met float_first en float_second bepaal je of de afbeelding links, rechts of zonder uitlijning wordt weergegeven. Handig wanneer je een gesyndiceerd feedblok wilt voorzien van een partnerlogo.

2.5 Geen aangepaste velden

In tegenstelling tot Contact en Artikelen ondersteunt com_newsfeeds geen aangepaste velden. Er bestaat dus geen context "Velden → News Feeds".

Dat is logisch: de inhoud van een feed komt van een externe bron. Aangepaste velden zouden nergens zinvol kunnen worden weergegeven. Wil je feeds groeperen of labelen, gebruik dan categorieën.

3. News Feeds weergeven

3.1 Een feed doet niets zonder een menu-item

Net als de meeste Joomla-inhoud is een News Feed slechts een record totdat een menu-item deze weergeeft. Er zijn drie menu-itemtypen:

Let op het belangrijke verschil: de lijstweergave toont de feeds zelf, niet de items binnen die feeds. Alleen de weergave Enkele News Feed haalt daadwerkelijk koppen en nieuwsitems op.

3.2 De weergave Enkele News Feed

Deze weergave combineert de instellingen van de feed met de opties van het menu-item. Het resultaat ziet er ongeveer zo uit:

[ feedafbeelding ]   Feedtitel
                     Feedbeschrijving
                     ────────────────
                     • Nieuwsitem 1   → link naar bron
                       itembeschrijving (ingekort)
                     • Nieuwsitem 2   → link naar bron
                     • ... tot numarticles

Elke kop verwijst naar het oorspronkelijke artikel op de website van de bron, niet naar een pagina op je eigen website.

3.3 De weergave-erfenis op drie niveaus

Of een bepaald onderdeel wordt weergegeven, wordt volgens een vaste volgorde bepaald. Dit is hetzelfde patroon dat ook door Contacten en Banners wordt gebruikt:

News Feed (bewerkscherm)      Tonen / Verbergen / Globaal gebruiken
   └─ Menu-itemopties         Tonen / Verbergen / Globaal gebruiken
        └─ Componentopties    (globale standaardinstelling)

Globaal gebruiken vormt hierbij de verbindende schakel. Stel een waarde één keer in via de componentopties en overschrijf deze alleen waar nodig, per menu-item of per feed.

3.4 Template-overrides

Elke weergave kan per template worden overschreven:

components/com_newsfeeds/tmpl/newsfeed/default.php
templates/<jouw_template>/html/com_newsfeeds/newsfeed/default.php   ← override

Hier kun je van een eenvoudige lijst met koppen bijvoorbeeld kaarten, een ticker of een tweekolomsweergave maken. De gegevens (de opgehaalde feed) en de presentatie (de layout) blijven gescheiden. Je overschrijft daarom altijd de weergave, nooit de parser.

3.5 De snelle oplossing: mod_feed

Er bestaat ook een tweede, veel lichtere manier om een feed op een pagina te plaatsen: de standaardmodule Feedweergave.

Content → Sitemodules → Nieuw → Feedweergave   (mod_feed)

Beide oplossingen zijn bedoeld voor verschillende situaties:

Onder de motorkap gebruiken beide dezelfde FeedFactory. Bij mod_feed plak je simpelweg de URL in de module en stel je het aantal items, de beschrijving en de woordlimiet in. Er is geen categorie, geen record en geen menu-item nodig.

Vuistregel: één feed in een zijbalk gebruik je met mod_feed. Een doorzoekbare, gecategoriseerde verzameling feeds gebruik je met com_newsfeeds.

5. Categorieën en toegangsbeheer

5.1 News Feeds gebruiken het gedeelde categoriesysteem

Feedcategorieën zijn gewone Joomla-categorieën met extension = com_newsfeeds:

#__categories  WHERE extension = 'com_newsfeeds'

Dat betekent dat ze dezelfde geneste boomstructuur, dezelfde knop Herstellen en hetzelfde toegangsbeheersysteem gebruiken als artikelcategorieën. Wil je meer weten over de lft- en rgt-waarden van nested sets, bekijk dan mijn aparte artikel Focus op categorieën.

5.2 Waarom categorieën hier belangrijk zijn

• Een menu-item van het type Categorieën weergeven richt zich op een categorie, die vervolgens als jouw feedoverzicht fungeert.
• Je kunt feeds organiseren op onderwerp, partner, regio of taal.
• Rechten erven door de boomstructuur heen: Aanmaken, Bewerken, Status bewerken en Verwijderen.

5.3 Toegang en taal

• Het Toegangsniveau van een feed bepaalt wie deze mag bekijken.
• De weergave controleert zowel het toegangsniveau van de feed als dat van de bijbehorende categorie voordat iets wordt getoond.
• Met de instelling Taal kun je een feed alleen laten verschijnen op websites die dezelfde taal gebruiken.

7. Achter de schermen (voor ontwikkelaars)

7.1 Eén tabel

De component is klein en gebruikt slechts één eigen tabel:

#__newsfeeds   de feedabonnementen + weergave-instellingen

Daarnaast gebruikt de component records in de gedeelde tabel #__categories waar extension = com_newsfeeds.

7.2 Belangrijke kolommen in #__newsfeeds

id, name, alias            identiteit + SEF-slug
catid                      categorie-id (→ #__categories)
link                       de RSS/Atom-feed-URL (varchar 2048)
numarticles                aantal weer te geven items
cache_time                 gewenste cacheduur (seconden, standaard 3600)
rtl                        rechts-naar-links weergeven
description                beschrijving van de feed, ingevoerd in de editor
images                     JSON: image_first / image_second + alt/caption/float
params                     JSON: show_feed_image, show_item_description,
                           feed_character_count, feed_display_order, ...
metakey/metadesc/metadata  SEO + robots
published, access, language, ordering, hits, version
publish_up / publish_down  publicatieperiode

7.3 De MVC-structuur

De code is verdeeld over de drie standaard Joomla-onderdelen:

administrator/components/com_newsfeeds/   ← feeds + categorieën beheren
   src/Model/NewsfeedModel.php, NewsfeedsModel.php
   src/Table, src/Controller, tmpl/, forms/newsfeed.xml

components/com_newsfeeds/                  ← front-end weergaven
   src/Model/NewsfeedModel.php    (laadt het feedrecord)
   src/Model/CategoryModel.php    (feeds binnen een categorie)
   src/Model/CategoriesModel.php  (categorieboom)
   src/View/Newsfeed/HtmlView.php (HAALT de live feed op en verwerkt deze)
   src/Service/Router.php

api/components/com_newsfeeds/              ← REST API
   src/Controller/FeedsController.php

De opvallende scheiding is die welke eerder al werd genoemd: het model laadt het record, maar de view haalt de externe feed op.

7.4 cache_time, een overblijfsel uit het verleden

Het veld cache_time (standaard 3600) bestaat nog steeds voor iedere feed en staat ook in het formulier. Het huidige front-endproces haalt de feed echter met FeedFactory op bij elke niet-gecachete paginaweergave. Het veld cache_time wordt daarbij niet rechtstreeks gebruikt.

De echte cache-instelling zit in Joomla zelf:

System → Global Configuration → System → Cache
   + com_newsfeeds DisplayController ondersteunt caching

Zie cache_time daarom als een historisch overblijfsel uit de oude SimplePie-periode. Wil je voorkomen dat er bij iedere paginaweergave een externe HTTP-aanvraag wordt gedaan, gebruik dan de componentcache van Joomla.

7.5 SEF-URL's en de router

Feed-URL's worden opgebouwd en verwerkt door de router van de component:

components/com_newsfeeds/src/Service/Router.php

index.php?option=com_newsfeeds&view=newsfeed&id=7
   ↔   /news-feeds/wereld/bbc-world

De router bouwt SEF-links, vertaalt binnenkomende URL's terug naar een view en een ID en geeft waar mogelijk de voorkeur aan een bestaand menu-itemsegment. Daardoor blijven feedlinks doorgaans werken wanneer een categorie wordt verplaatst.

7.6 Toegang op programmaniveau

Dezelfde Categories API voor nested sets werkt ook voor News Feeds:

use Joomla\CMS\Categories\Categories;

$categories = Categories::getInstance('Newsfeeds');
$node       = $categories->get('world');   // op alias of id
$children   = $node->getChildren();

Je kunt ook zelf een feed ophalen en verwerken vanuit elke plek binnen Joomla:

use Joomla\CMS\Feed\FeedFactory;

$feed = (new FeedFactory())->getFeed('https://example.com/feed');

foreach ($feed as $entry) {
    echo $entry->title, ' - ', $entry->uri;   // FeedEntry-objecten
}

7.7 Beveiliging, verbinding maken met de buitenwereld

Een feedreader is in feite een HTTP-client aan de serverzijde. Daardoor ontstaan risico's die veel andere componenten niet hebben:

Feedgegevens zijn per definitie niet te vertrouwen, omdat ze afkomstig zijn van een externe server. Beperk daarom wie feeds mag toevoegen en vertrouw nooit blind op feedinhoud binnen eigen template-overrides.

7.8 Op grotere schaal

Het model is eenvoudig, maar het werken met externe feeds verschilt sterk van het serveren van eigen gegevens:

De belangrijkste les: News Feeds zijn netwerkgebonden, niet querygebonden. De externe server vormt de bottleneck. Daarom levert caching hier veel meer winst op dan SQL-optimalisatie.

9. Best practices

Als je maar een paar dingen uit dit artikel onthoudt, laat het dan deze zijn:

• Maak altijd eerst een categorie aan voordat je een feed toevoegt. Elke feed moet aan een categorie gekoppeld zijn.
• Gebruik de weergave Enkele News Feed om nieuwskoppen te tonen en de weergave Lijst voor een overzicht van feeds.
• Voor één feed in een zijbalk is mod_feed meestal een betere keuze dan de volledige component.
• Schakel de componentcache van Joomla in. Dat is de echte instelling voor prestaties en actualiteit, niet cache_time.
• Laat alleen vertrouwde gebruikersgroepen feeds toevoegen of wijzigen, omdat de server elke opgegeven URL daadwerkelijk ophaalt.
• Vertrouw feedinhoud nooit blind in template-overrides en zorg ervoor dat uitvoer altijd correct wordt geëscaped.

11. Samenvatting

Joomla News Feeds is de enige corecomponent die actief informatie van buiten je website binnenhaalt. Het is een server-side RSS- en Atom-reader die volledig geïntegreerd is met de gedeelde categorieboom van Joomla.

De component biedt:

• Aggregatie, het tonen van elke externe RSS- of Atom-feed zonder handmatig kopiëren en plakken.
• Structuur, met dezelfde categorieën, toegangsrechten, menu's en SEF-routering als andere Joomla-componenten.
• Verwerking, via Joomla's eigen FeedFactory en RSS/Atom-parsers, inclusief een HTTP-fallback voor lastige servers.
• Controle over de weergave, zoals aantal items, beschrijvingen, afkappen van tekst, sorteervolgorde en omlijstende afbeeldingen.
• Integratie, met Slim Zoeken en een REST API.
• Een afwijkende architectuur, waarbij netwerkverkeer belangrijker is dan databaseprestaties en caching belangrijker is dan SQL-optimalisatie.

Zodra je begrijpt dat News Feeds slechts een verwijzing naar gegevens van iemand anders opslaat, worden alle eigenaardigheden logisch: het ophalen tijdens het renderen, het nauwelijks gebruikte cache_time-veld en de extra beveiligingsaandacht die nodig is.

Gebruik News Feeds om externe content te verzamelen en zichtbaar te maken, vertrouw op de componentcache voor prestaties en houd strikt in de hand wie nieuwe feeds mag toevoegen. Dat zijn precies de factoren die bepalen of een feedpagina probleemloos werkt of juist onbetrouwbaar wordt.