handleiding RSS SETUP

Transcriptie

1 handleiding RSS SETUP In dit document wordt beschreven hoe je RSS-feeds automatisch kan inladen in templates in MailPlus. Het document is bedoeld als handvat voor de optimalisatie voor RSS-feeds.

2 1. MOGELIJKHEDEN RSS CONTENT IN MAILPLUS De mogelijkheden van de content-koppeling met RSS-feeds zijn in MailPlus uitgebreid. Bij het inladen van een RSS-feed wordt in MailPlus standaard gekeken naar de volgende RSS-elementen van elk item (artikel) in de RSS-feed: Title link description category enclosure.url pubdate author Deze lijst kan onbeperkt worden aangevuld met andere, zelf verzonnen elementen. Voorwaarde is dat de RSS-feed RSS 2.0 is. MailPlus kan de waardes van deze elementen uitlezen en plaatsen in een , mits deze elementen aan bepaalde voorwaarden voldoen. Hiervoor dient de RSS-feed uitgebreid te worden met elementen die niet in de standaard zitten, in combinatie met een Mailplus-namespace. Uitbreiding RSS onderdelen Door de uitbreiding kun je alle eigenschappen van een artikel zoals prijs, artikelnummer, afmeting, etcetera plaatsen in afzonderlijke elementen. MailPlus is in staat om bij het inladen van de RSS-feed de waardes van deze nieuwe elementen te tonen in de , mits ze aan bepaalde voorwaarden voldoen. Hieronder staat een simpel voorbeeld van een RSS-feed met één artikel, dat uitgebreid is met de mailplus-namespace. Mailplus-namespace Van elk element dat in de mailplus-namespace zit, wordt de waarde door MailPlus 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.

3

4 De voorwaarden De Mailplus-namespace functionaliteit werkt alleen voor versie RSS 2.0. Er dient in de RSS-feed verwezen te worden naar een speciale namespace van MailPlus. De notatie van de namen van de niet-standaard elementen moet aan een bepaalde voorwaarde voldoen: namelijk beginnen met MailPlus gevolgd door een dubbele punt. Bijvoorbeeld: <MailPlus:prijs>. De naam van de placeholder in een MailPlus-RSS-template dient te beginnen en te eindigen met dubbele hoofdletter X, met ertussenin de naam van het element. Bijvoorbeeld: XXMailPlus:prijsXX. Alleen elementen binnen een item van een RSS-feed kunnen door MailPlus worden uitgelezen.

5 Overige bijzonderheden Naast de standaard RSS-elementen worden alléén elementen die in de Mailplus-namespace zitten door MailPlus herkent bij het inladen van de RSS feed. Alle elementen van een RSS-feed die wel in de Mailplusnamespace zitten, maar die niet in het template zitten, worden genegeerd door MailPlus. Alle placeholders in het template in MailPlus van de vorm XXMailPlus: XX die na het inladen van de RSS-feed niet zijn vervangen door waardes uit de RSS-feed, worden door MailPlus automatisch verwijderd uit het artikel. Alle elementen van een RSS-feed die in een namespace extension zitten maar niet in de Mailplus-namespace, worden genegeerd bij het inladen van de RSS-feed. Afbeeldingen in RSS Afbeeldingen die in de RSS via de enclosure.url worden meegegeven zijn in het template in te laden met de placeholder {image}. De placeholder {image} mag niet in de src gezet worden van de <img> tag. MailPlus zal deze img tag zelf plaatsen. Voorbeeld in de feed: <enclosure url= length= 7666 type= image/jpeg /> De afbeeldinggrootte dient in de RSS-feed in de juiste afmeting te staan. Indien dat niet mogelijk is, kan een afbeelding met een MailPlus 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: Placeholder: XXmailplus:imageXX RSS mailplus-namespace: <mailplus:image> images/test.jpg</mailplus:image>

6 Linkjes De standaard link (XXlinkXX) wordt door MailPlus altijd trackable gemaakt Indien dat niet moet gebeuren, gebruik dan een mailplusnamespace. Voorbeeld Placeholder: XXmailplus:linkXX RSS mailplus-namespace: <mailplus:link> mailplus:link> Dynamische koppeling nieuwsitem (optioneel) Om een RSS artikelblok als optionele content te laten werken dient per nieuwsitem een category meegeven te worden in de RSS-feed. De categroy dient dan exact dezelfde naam te hebben als een doelgroep in de list manager van MailPlus. MailPlus herkend de naam in de category en maakt het artikelblok automatisch optioneel. Let op: Een nieuwsitem mag maar 1 category hebben. Indien meerdere categories aanwezig zijn zal het onderdeel niet als optionele content werken. Indien er geen category is meegeven zal het nieuwsitem voor alle ontvangers zichtbaar zijn.

7 2. INLADEN CONTENT VANUIT RSS- FEED Het is mogelijk om in MailPlus RSS-feeds automatisch in een template te laten laden. Dit is in te stellen in de template manager. RSS feeds hebben twee grote pluspunten m.b.t. de koppeling met een nieuwsbrief: De feed bevat meestal een introductie / samenvatting van de content met een link naar de website waar de volledige content ontsloten wordt. Dit is ideaal voor het gebruik van meetbare doorkliklinks. De content feeds bevatten een minimum aan opmaak code, waardoor het eenvoudig is om de content passend en in de juiste stijl in de nieuwsbrief in te voegen m.b.v. MailPlus templates. RSS-feed OVerplichte O xml: <rss version="2.0" xmlns:mailplus=" mailplus.nl/rss/mailplus/"> RSS (0.90, 0.91, 0.92, 0.93, 0.94, 1.0 and 2.0) and Atom 0.3 Alleen de <item>-tags worden verwerkt, channel info wordt genegeerd Verplichte tags per item: title, description Optionele tags per item: category, link, enclosure.url, pubdate, author en mailplus - namespace (alleen RSS versie 2.0) Description mag HTML content bevatten (bijv. afbeeldingen) Alle items uit de feed worden ingelezen (geen selectie of andere volgorde mogelijk bij het inlezen. Artikelen kunnen wel in MailPlus verwijderd worden na het inlezen)

8 Templates Alle artikelen in één feed worden in hetzelfde artikel-template geladen. Weet dat meerdere feeds gebruik kunnen maken van hetzelfde templateblok. De stylesheet definitie moet vast liggen in het template waar de RSS-feed in geplaatst wordt of moet inline gedefinieerd worden in het artikel template. Optioneel HTML-blok Bij sommige rss-onderdelen kun je in het template een heel HTML-blok optioneel maken (bijvoorbeeld een TD of een TR). Je moet dan bepaalde tags om dat blok heen zetten. Bijvoorbeeld: <ttl> <TR> <TD>XXtitleXX</TD> </TR> </ttl> Dat werkt alleen met de volgende tags: <lnk></lnk> verwijderd indien geen link in RSS <ttl></ttl> verwijderd indien geen title in RSS <desc></desc> verwijderd indien geen description in RSS <date></date> verwijderd indien geen pubdate in RSS <auth></auth> verwijderd indien geen author in RSS Dat geldt dus niet voor de exotische namespaces die je tegenwoordig in een RSS-feed kunt opnemen, zoals XXMailPlus:prijsXX.

9 3. VRBEELD RSS EN SETUP RSS HTML-TEMPLATEBLOK RSS template Artikel screenshot: Belangrijkste highlights uit de HTML van het voorbeeld hier boven: <div class="mped_contentblock"> <table> <tr> <td valign="bottom" align="left" style=".."><a href= XXlinkXX" style="..">xxtitlexx</a></td> </tr> <tr> <td valign="top" align="left" style="..">xxdescriptionxx</td> </tr> <tr> <td valign="top" align="left"><table width="100%" cellspacing="0" cellpadding="0" border="0"> <tr> <td width="10" align="left"><img width="4" height="8" src="..pijl.gif" alt="" /></ td> <td><a href="xxlinkxx" target="_blank" style="..">lees verder</a></td> </tr> </table></td> </tr> </table> </div>

10 Wanneer je een afbeelding in je RSS artikel wilt plaatsen inclusief link, kun je dit op de volgende manier doen: <a href="xxlinkxx" target="_blank">{image}</a> Een datum kan als volgt genoteerd worden in de RSS: XXrss-dateXX 3.2 RSS-feed Gebruikte RSS-feed in dit voorbeeld: nieuwsbrief_opinie_1/ De XML achter deze feed: <?xml version= 1.0 encoding= utf-8?> <rss version= 2.0 xmlns:dc= xmlns:sy= xmlns:admin= xmlns:rdf= xmlns:content= > <channel> <title>villamedia - Opinie</title> <link> <description>villamedia, Opinie en columns</description> <dc:language>nl</dc:language> <dc:creator>noreply@villamedia.nl</dc:creator> <dc:rights>copyright 2012</dc:rights> <dc:date> t13:31:58+00:00</dc:date> <admin:generatoragent rdf:resource= />

11 <item> <title>onderbieding en prijsdruk op markt freelancers</title> <link> markt-freelancers/</link> <guid> <description>het wordt steeds lastiger om als freelance journalist maandelijks een redelijke boterham te verdienen, merkt Hans Roodenburg </description> <category>arbeidsmarkt, bezuiniging, crisis, freelance</category> <pubdate>thu, 09 Aug 12 09:00: </pubDate> <dc:date> t09:00:30+00:00</dc:date> </item> </channel> </rss> Setup automatisch RSS inladen in template Feeds kunnen automatisch worden ingelezen zodra het template wordt gekozen in MailPlus. 1. Kopieer in de template manager van het account een bestaand RSS-templateblok en gebruik deze als basis voor de nieuwe feed. Plaats om het artikelbok het volgende: <div class= MPED_ CONTENTBLOCK >.. </div>. Daarmee is het artikel bewerkbaar na het inladen van het template. Dit RSS-blok mag voor meerdere feeds gebruikt worden 2. Voeg onderin de template manager een nieuwe RSS-feed toe.

12 Vul hier een logische naam in de RSS-feed hoort. Bijvoorbeeld RSS nieuwitem of RSS agenda. Bij URL dient de link van de RSS-feed ingevoerd te worden. Kies in de dropdown het templateblok dat voor deze feed nodig is (in stap 1 aangemaakt). 3. Voeg in de nieuwsbrief de volgende commenttag toe op de plek waar de RSS-feed moet worden ingeladen.  waarbij # het rssid is van de net toegevoegde RSS feed. Bijvoorbeeld  Het Id is te vinden onderin de template manager.

13 Voorbeeld HTML code in de nieuwsbrief: 4. Open het MailPlus-account. In het Message Center selecteer het juiste template en controleer of de feed correct wordt ingelezen en linkjes trackable zijn. Algemeen Support