raow/mautic-rss-to-email-bundle

Mautic RSS to E-mail

Description

The Mautic RssToEmailBundle is a Mautic plugin that allows you to generate e-mails from a RSS-feed., _(*1)

Purpose

Send out an e-mail with for example to latest posts of your blog., _(*2)

Compatibility

This plugin has been tested with Mautic versions 2.x, 3.x and 4.x., _(*3)

Features

• Set the number of posts you want to display
• Create a custom template for the items in the feed
• Use images from the feed
• Format dates
• Reverse view

Installation

1. Download the plugin from github
2. Move / Upload folder to the plugins directory. Name the folder MauticRssToEmailBundle
3. In the Mautic GUI, go to the gear and then to Plugins.
4. Click on the "Install/Upgrade Plugins" button
5. You should now see the "Rss To Email" in your list of plugins.

Usage

Use the "code mode" slot of the froala/grapejs e-mail editor. In the content of the slot set to following content:, _(*4)

{feed url="<<FEEDURL>>"}
    {feeditems}
        <h3>{feeditem:title}</h3>
        <p><small>{feeditem:date format="d-m-Y H:i"}</small></p>
        <p>{feeditem:description}</p>
        <p><img src="{feeditem:image}"></p>
    {/feeditems}
{/feed}

This should give a basic setup to start with., _(*5)

The following tags can be used in the {feed} block:

• {feedinfo:title}
  Returns: title of the feed, _(*6)

• {feedinfo:url} Returns: url of the feed, _(*7)

• {feedinfo:description} Returns: description of the feed, _(*8)

The following tags can be used in the {feeditems} block:

Optional param:

• Batch mode, _(*9)

  By default batch-mode will be enabled. This means that the feed-tags will only be replaced once per batch. When you disable batch-mode, the feed will be parsed for every single e-mail. So if you have a list of 1000 addresses, the feed will be requested 1000 times. Because of the high number of requests in a short timeframe it could cause the server where the feed is on to go down. So handle with care!, _(*10)

  {feed batch="0"} - Will DISABLE batch-mode on the feed., _(*11)

• Count
  {feeditems count="3"} - Returns only the first N items from the feed, _(*12)

• Offset
  {feeditems count="3" offset="2"} - Skips the first N items from the feed, _(*13)

• Reverse
  {feeditems reverse="1"} - Returns resuls in reversed view, _(*14)

• Shuffle
  {feeditems count="3" shuffle="1"} - Returns results in shuffled (random) view, can be used in combination with the count parameter, _(*15)

Merge tags:
* {feeditem:title}
Returns: title of the post, _(*16)

• {feeditem:link}
  Returns: link to the post, _(*17)

• {feeditem:content}
  Returns: summarized content (desciption), when description is not available it will return the full content, _(*18)

• {feeditem:content_full}
  Returns: full content of the post, _(*19)

• {feeditem:content_text}
  Returns: summarized content (desciption), when description is not available it will return the full content. Tags are stripped., _(*20)

• {feeditem:content_full_text}
  Returns: full content of the post stripped of tags, _(*21)

• {feeditem:description}
  Returns: summarized content (desciption) of the post, _(*22)

• {feeditem:date}
  Optional param: format {feeditem:date format="d-m-Y H:i"}
  Returns: summarized content (desciption) of the post, _(*23)

• {feeditem:author}
  Returns: author name of the post, _(*24)

• {feeditem:categories}
  Returns: comma seperated list of the categories, _(*25)

• {feeditem:image}
  Returns: url of the image. Will check the enclosere and media tags of the xml., _(*26)

• {feeditem:custom:KEY}
  Returns: value of custom field in RSS feed., _(*27)

  To use this functionality you have to:, _(*28)

  1. Add this to the xmlns definitions in your RSS-feed: xmlns:mautic="https://www.mautic.org/rss/mautic/", _(*29)

     For example:, _(*30)

     <rss version="2.0"
     xmlns:content="http://purl.org/rss/1.0/modules/content/"
     xmlns:wfw="http://wellformedweb.org/CommentAPI/"
     xmlns:dc="http://purl.org/dc/elements/1.1/"
     xmlns:atom="http://www.w3.org/2005/Atom"
     xmlns:sy="http://purl.org/rss/1.0/modules/syndication/"
     xmlns:slash="http://purl.org/rss/1.0/modules/slash/"
     xmlns:mautic="https://www.mautic.org/rss/mautic/">
     
     <channel>
     ...
     

  2. Add the custom field to your RSS-feed with the following syntax:
     <mautic:location>New York</mautic:location>, _(*31)

  3. Inside your mail template use the following tag:
     {feeditem:custom:location}, _(*32)

Icon