Een RSS-feed inladen met sjabloontags
Aan veel websites is een RSS-feed (of de variant Atom-feed) gekoppeld. Daarin staan artikelen van de site in een standaardformaat dat goed door computers te lezen is. Laposta kan deze feed uitlezen en de artikelen in een sjabloon invoegen, zodat je een nieuwsbrief snel kunt vullen zonder te kopiëren en plakken.
Zodra je een RSS-blok in de nieuwsbrief plaatst, leest Laposta de feed in en toont de items. Je kunt de inhoud en de volgorde van de items aanpassen, en de feed opnieuw inladen.
Deze tags gelden alleen voor een geïmporteerd HTML-sjabloon, niet voor de drag & drop-editor. Hoe je zo’n sjabloon importeert, staat in Een zelfgemaakt sjabloon importeren in Laposta.
De feed starten met <lp-rss>
Sluit de feed in tussen <lp-rss> en </lp-rss>. Je kunt meerdere feeds in hetzelfde sjabloon opnemen.
Opties
Geeft aan welke feed er geladen moet worden.
Geeft het type feed aan: rss of atom. Laat je dit attribuut weg, dan gaat Laposta uit van rss.
Het maximale aantal items dat wordt ingeladen. Voorbeeld: bij lp-rss-maxitems="5" worden er maximaal 5 items getoond. Laat je dit attribuut weg, dan worden alle items geladen.
Je kunt dit aantal nog aanpassen bij het vullen van de nieuwsbrief.
Geeft een van/tot-bereik aan voor de te tonen items, in het formaat [getal]-[getal]. Bij lp-rss-range="2-5" worden alleen de items 2, 3, 4 en 5 getoond. Je kunt ook één item tonen, bijvoorbeeld lp-rss-range="1-1" voor alleen het eerste item.
Laat je dit attribuut weg, dan worden alle items geladen.
Soms bevat de tekst in een feed HTML. Voeg dit attribuut toe als je niet wilt dat die HTML in de editor wordt weergegeven.
Met lp-rss-maxchars="[x]" geef je aan dat de inhoud van items in de feed niet langer mag zijn dan x karakters.
Geeft aan welke items getoond mogen worden, op basis van een veld in de feed dat verschillende waarden kan bevatten, zoals labels of categorieën. Bevat de feed bijvoorbeeld dit:
Wil je alleen de artikelen tonen die over arbeidsmarkt of onderwijs gaan, dan ziet het filter er zo uit:
Het formaat is [naam veld]|[naam subitems]|waardeA,waardeB,waardeC,...
Staan de subitems direct in de feed, zonder bovenliggend item, laat dan de eerste plek leeg. Bevat de feed bijvoorbeeld dit:
Dan wordt het filter:
Tekst tonen met <lp-rss-content>
De HTML tussen <lp-rss> en </lp-rss> wordt herhaald voor elk item in de feed. Daarin kun je de inhoud uit de feed verwerken.
De naamgeving van velden verschilt per feed. Zet na de dubbele punt de naam van het veld, bijvoorbeeld <lp-rss-content:title> voor de titel.
Voor sub-eigenschappen en attributen gebruik je een dubbel koppelteken: <lp-rss-content:category--term> voor <category term="..."/>.
Een speciaal veld dat de datum van het item toont in Nederlandse opmaak.
Inhoud wijzigbaar maken
Wil je dat een gebruiker de inhoud nog kan wijzigen bij het vullen van de nieuwsbrief, gebruik dan deze attributen:
Met lp-type="singleline|multiline" geef je aan of de tekst een singleline of een multiline is.
Voeg dit toe aan een afbeelding om deze wijzigbaar te maken.
Een afbeelding tonen met <lp-rss-image>
Een feed bevat vaak per item een afbeelding. Die kun je tonen met <lp-rss-image>. Er zijn geen speciale attributen nodig. Je kunt deze tag gebruiken als een gewone afbeelding.
Gebruik dit als je alleen de locatie van de afbeelding nodig hebt.
Voorbeeld
Dit voorbeeld laadt de feed van de Volkskrant en toont per item de titel met een link erachter, de afbeelding en de tekst.