Heb je een RSS-feed en wil je dat de content van je RSS-feed in je nieuwsbrief geladen wordt? Dan zijn er twee mogelijkheden binnen Spotler:
Handmatig RSS toevoegen
Handmatig toevoegen van een RSS-feed kan in de editor van de module Berichten en de module Webpagina's. Je vindt deze optie aan de linkerkant onder Editor-opties.
Sleep de RSS-feed optie op het canvas.
Dubbelklik op het RSS-feed blok. Er verschijnt een pop-up. Hier voer je de url van je RSS-feed in. Klik daarna op Ok.
Je ziet dat de RSS wordt ingeladen in je template.
Elk artikel wordt opgedeeld als los contentblok die je kunt verwijderen of verplaatsen.
Automatisch RSS inladen
Het is ook mogelijk om automatisch RSS in te laden. Bij het aanmaken van een bericht wordt direct de RSS automatisch ingeladen.
Bij het inladen van een RSS-feed kijkt Spotler standaard naar de volgende RSS-elementen van elk item (artikel) in de RSS-feed:
- title
- link
- description
- category (dynamische content)
- enclosure.url (voor afbeeldingen)
- pubDate
- author
Bijzonderheden
- pubDate wordt in Spotler altijd op de volgende manier uitgeschreven: maandag 2 december 2019
Dit kan niet in een andere taal weergeven worden of opgeknipt worden. - Items die in je template gezet zijn moeten ook als item beschikbaar zijn in je RRS-feed.
- Bovenstaande lijst kan onbeperkt worden aangevuld met andere, zelf verzonnen elementen door middel van een Spotler-namespace. Lees hier meer over onder het kopje overige elementen.
Overige elementen in RSS (namespace)
Er zijn een aantal elementen standaard in de RSS, zoals o.a. een title, link en description. Maar je kunt de standaard uitbreiden. Laad je artikelen in van je website? Dan kun je bijvoorbeeld ook prijs, artikelnummer en afmeting meegeven. Deze elementen zijn dus niet de standaard, maar kun je alsnog mee laten komen door een Spotler-namespace toe te voegen.
Van elk element dat in de Spotler-namespace zit, wordt de waarde door Spotler gebruikt om alle 'placeholders' met de corresponderende naam in het template te vervangen met desbetreffende waarde op het moment dat de RSS-feed wordt ingeladen.
Een voorbeeld:
<?xml version="1.0" encoding="utf8"?>
<rss version="2.0" xmlns:mailplus="https://api.mailplus.nl/rss/mailplus/">
<channel>
<title>Spotler voorbeeld</title>
<link>https://test.spotler.nl/rss/rss20.rss</link>
<description>Een voorbeeld RSS-feed met namespace extensions</description>
<item>
<title>Titel van het artikel</title>
<description>Beschrijving van het artikel</description>
<link>https://www.spotler.com</link>
<mailplus:artikelnummer>ABC 00001</mailplus:artikelnummer>
<mailplus:prijs>19,95</mailplus:prijs>
<mailplus:verpakkingseenheid>2 stuks</mailplus:verpakkingseenheid>
</item>
</channel>
</rss>
In bovenstaand voorbeeld zijn de volgende elementen namespaces:
- mailplus:artikelnummer
- mailplus:prijs
- mailplus:verpakkingseenheid
Voorwaarden namespaces in RSS
- Wanneer je de RSS-feed wilt uitbreiden met elementen die niet in de standaard zitten moet er verwezen worden naar een speciale Spotler-namespace.
- De Spotler-namespace functionaliteit werkt alleen voor versie RSS 2.0.
- De notatie van de namen van de niet-standaard elementen moet aan bepaalde voorwaarde voldoen: namelijk beginnen met "mailplus" gevolgd door een dubbele punt. Bijvoorbeeld <mailplus:prijs>
- Alleen elementen binnen een item-tag van een RSS-feed kunnen door Spotler worden uitgelezen.
Bijzonderheden namespaces
- Naast de standaard RSS-elementen worden alléén elementen die in de Spotler-namespace zitten door Spotler herkent bij het inladen van de RSS-feed.
- Alle elementen van een RSS-feed die wel in de Spotler-namespace zitten, maar die niet in het template zitten, worden genegeerd door Spotler.
- Alle elementen van een RSS-feed die in een namespace extension zitten, maar niet in de Spotler-namespace, worden genegeerd bij het inladen van de RSS-feed.
Afbeeldingen in RSS
Om afbeeldingen in te laden via de RSS wordt er gebruik gemaakt van de enclosure.url. Dat ziet er als volgt uit in de RSS-feed:
<enclosure url="https://www.spotler.com/images/test.jpg" length="2500" type="image/jpeg"/>
De grootte (hoogte en breedte) van de afbeelding moet in de juiste afmeting op de server staan. Als dat niet mogelijk is, kan een afbeelding met een Spotler-namespace in de feed geplaatst worden. Deze oplossing is ook handig indien border="0" in de img tag nodig is, omdat je een link op de afbeelding wilt plaatsen.
Voorbeeld RSS Spotler-namespace:
<mailplus:image>https://www.spotler.com/images/test.jpg</mailplus:image>
Links in RSS
De standaard links worden door Spotler altijd trackable (meetbaar) gemaakt. Je kunt in de mailingrapportage zien wie waar op heeft geklikt. Wanneer je niet wilt dat linkjes trackable zijn dan gebruik je een Spotler-namespace.
Voorbeeld van de Spotler-namespace:
<mailplus:link>https://www.spotler.com</mailplus:link>
Dynamische content op basis van RSS
Om een RSS artikelblok als optionele content te laten werken geef je per nieuwsitem een category mee in de RSS-feed. Door de category dezelfde naam mee te geven als de doelgroep in de module Lijsten van Spotler herkent Spotler dat het optionele content is voor die specifieke doelgroep. Wanneer er geen category is meegegeven, dan zal het nieuwsitem voor alle ontvangers zichtbaar zijn.
Voorbeeld van een category in je RSS-feed:
<item>
<title>Onderbieding en prijsdruk op markt freelancers</title>
<description>Het wordt steeds lastiger om als freelance journalist maandelijks een redelijke boterham te verdienen, merkt Hans Roodenburg</description>
<category>Freelance</category>
<pubDate>Thu, 09 Aug 2020</pubDate>
</item>
Let op: een nieuwsitem mag maar één category hebben. Indien meerdere categories aanwezig zijn, zal het onderdeel niet als optionele content werken. Wanneer je geen automailer gebruikt, kun je wel in de editor van de module Berichten het artikel aan meerdere doelgroepen koppelen.
Veelgestelde vragen: