Ga naar inhoud

Mailchimp-/RSS-feed voor de nieuwsbrief

Doel & URL('s)

Machine-leesbare RSS-feed met de artikelen van de afgelopen week, als bron voor nieuwsbriefautomatisering (Mailchimp-RSS-campagnes). Geen bezoekerspagina.

Ingang URL Mechanisme
Feed-endpoint /feed/mailchimp/ geregistreerde custom feed (add_feed); bestaat ook onder elk archief, bijv. /nieuws/feed/mailchimp/
Pagina-variant /rssfeed/ GB-pagina "rssfeed" met template "Mailchimp RSS Feed"

Beide ingangen renderen exact dezelfde output (zelfde controller/view).

Opbouw (outputformaat)

RSS 2.0-XML (Content-Type: application/rss+xml), met media- en atom-namespaces:

  • Channel: titel (zie hieronder), atom:link rel="self", link naar de site-home, description "Gereformeerde Bond - Nieuwste artikelen", language nl-NL, lastBuildDate/pubDate.
  • Channeltitel: "{titel van het nieuwste artikel} en {n} nieuwe artikelen van de afgelopen week"; bij precies één artikel alleen die titel; zonder artikelen de fallback "Gereformeerde Bond - RSS Feed".
  • Items — wv-artikelen van de afgelopen week (date after '1 week ago'), zichtbaar op WV óf GB, maximaal 50, nieuwste eerst. Per item:
    • title — artikeltitel;
    • link — artikel-permalink (met evt. ?t=-parameter);
    • pubDate — RFC 2822 (GMT);
    • description — article_intro, afgekapt op 25 woorden;
    • media:content — artikelafbeelding: eerste item op 560×260 (nieuwsbrief-formaat), overige op 180×136;
    • category — highlighted-article voor het eerste item, article voor de rest.
  • De pubDate van het nieuwste item wordt bewaard in de optie gb_rss_feed_latest_post_date (t.b.v. campagne-triggering).

Databronnen

Bron Gebruik
wv-article (afgelopen week; Websites WV of GB; max. 50; datum DESC) items
article_intro description (≤25 woorden)
article_image (formaten 560×260 en 180×136) media:content
Optie gb_rss_feed_latest_post_date laatst gepubliceerde datum (schrijf-bijwerking van het renderen)

Gedrag & rollen

  • Openbaar; geen authenticatie. Paywall speelt geen rol: de feed bevat alleen titel/intro/beeld, nooit de artikeltekst.
  • In weken zonder nieuwe artikelen is de feed leeg (channel zonder items, fallback-titel).
  • Afnemer: de Mailchimp-RSS-campagne voor de wekelijkse nieuwsbrief. (Er bestaat daarnaast een losse, handmatige Listmonk-keten via het CPT newsletter-edition; die valt buiten deze site-rebuild — zie notities.)

Acceptatiecriteria

  • Als client op /feed/mailchimp/ dan HTTP 200 met geldig RSS 2.0-XML (<rss version="2.0"> met media- en atom-namespace) en Content-Type application/rss+xml.
  • Als client op /rssfeed/ dan byte-vergelijkbare output met /feed/mailchimp/ (zelfde channel en items).
  • Als er in de afgelopen 7 dagen n (1 < n ≤ 50) wv-artikelen zijn gepubliceerd, dan bevat de feed precies die artikelen, nieuwste eerst, en luidt de channeltitel "{nieuwste titel} en {n−1} nieuwe artikelen van de afgelopen week".
  • Als er in de afgelopen 7 dagen geen artikelen zijn, dan is de feed leeg en luidt de channeltitel "Gereformeerde Bond - RSS Feed".
  • Als de feed items bevat, dan heeft het eerste item category = highlighted-article met beeld op 560×260, en hebben alle volgende items category = article met beeld op 180×136.
  • Als een item een intro van meer dan 25 woorden heeft, dan is de description afgekapt op 25 woorden.
  • Als de feed items bevat, dan verwijst elke link naar de bijbehorende artikelpagina en levert die link HTTP 200 op.
  • Als anonieme client de feed opvraagt, dan bevat geen enkel item de artikeltekst zelf (alleen titel/description/beeld).

Bekende afwijkingen (NIET nabouwen; wel vermelden in het testrapport)

  • De feed bestaat op twee URL's (/feed/mailchimp/ en de pagina /rssfeed/), en bovendien technisch onder elk archiefpad (…/feed/mailchimp/). In de rebuild één canonieke feed-URL kiezen en de overige 301'en (afnemer: de bestaande Mailchimp-campagneconfiguratie — afstemmen vóór livegang).
  • Het renderen van de feed heeft een schrijf-bijwerking (optie gb_rss_feed_latest_post_date); in een headless opzet moet die statusbron opnieuw ontworpen of geschrapt worden.
  • De naamgeving "Mailchimp RSS Feed" versus de (deels naar Listmonk verplaatste) nieuwsbriefketen is verwarrend; welke nieuwsbrief deze feed feitelijk voedt moet met de beheerder worden bevestigd (zie ook de notitie bij de paywall over de Mailchimp/Listmonk-splitsing).