meta data for this page
  •  

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revisionPrevious revision
Next revision		Previous revision
plugin:rssfeed [2025/06/05 11:02] – [Deleting all items] duncancplugin:rssfeed [2026/02/17 13:56] (current) – [Formatting the feed items] duncanc
Line 18: Line 18:
 ====== Purpose ====== ====== Purpose ======
  
-This plugin lets you create campaigns that include content from RSS and Atom feeds and are automatically repeated at regular intervals.+This plugin lets you create campaigns that include content from an RSS or Atom feed and which are automatically repeated at regular intervals.
 So, for example, you can have a campaign that is sent every day at 09:00 which contains items from an RSS feed that were published in the previous day. So, for example, you can have a campaign that is sent every day at 09:00 which contains items from an RSS feed that were published in the previous day.
  
Line 29: Line 29:
 ===== Creating an RSS campaign ===== ===== Creating an RSS campaign =====
  
-==== Add an RSS feed ====+==== Add a feed ====
  
-The plugin adds a tab to the Send a campaign page on which you specify the URL of the RSS feed.+The plugin adds a tab to the Send a campaign page on which you specify the URL of the RSS or Atom feed.
 You should validate the URL first, by opening it in a browser, to ensure that it is valid and returns what you expect. You should validate the URL first, by opening it in a browser, to ensure that it is valid and returns what you expect.
 Additionally you can choose whether feed items should be displayed in ascending order of publication date (oldest first) or in descending order (latest first). Additionally you can choose whether feed items should be displayed in ascending order of publication date (oldest first) or in descending order (latest first).
Line 106: Line 106:
 ==== Formatting the feed items ==== ==== Formatting the feed items ====
  
-When phplist is building the email to be sent the plugin replaces the [RSS] placeholder in the message content by the available feed items, each of which is formatted using an RSS template. The default RSS template is specfied on the Settings page, but each campaign can have a custom RSS template, which is entered on the RSS tab.+When phplist is building the email to be sent the plugin replaces the [RSS] placeholder in the message content by the available feed items, each of which is formatted using an RSS template. The default RSS template is specified on the Settings page, but each campaign can have a custom RSS template, which is entered on the RSS tab.
  
-The template consists of html containing placeholders that will be replaced by fields from the item: +In the template placeholders that will be replaced by fields from the item:
-  * [CONTENT]+
   * [TITLE]   * [TITLE]
   * [URL]   * [URL]
   * [PUBLISHED]   * [PUBLISHED]
 +  * [AUTHOR]
 +  * [DESCRIPTION]
 +  * [CONTENT]
  
-The source of the content depends on the type of feed. For an RSS feed the ''description'' field is used if present, otherwise the ''content'' field. For an Atom feed the ''summary'' field is used if present, otherwise the ''content'' field.+A feed item may provide a short summary instead of, or as well as, the full content. The [DESCRIPTION] placeholder will be replaced by the RSS ''description'' or Atom ''summary'' element if present, otherwise replaced by the full content. The [CONTENT] placeholder will be replaced by the ''content'' element from the feed if present, otherwise replaced by the short content.
  
 Additionally, placeholders for custom tags can be included. The placeholders must match exactly the custom tags entered on the Settings page. Additionally, placeholders for custom tags can be included. The placeholders must match exactly the custom tags entered on the Settings page.
Line 278: Line 280:
   * The php ''date()'' format to be used to display the published date. This is used when the php ''intl'' extension is not enabled.   * The php ''date()'' format to be used to display the published date. This is used when the php ''intl'' extension is not enabled.
   * The php ''IntlDateFormatter'' format to be used to display the published date. This is used when the php ''intl'' extension is enabled.   * The php ''IntlDateFormatter'' format to be used to display the published date. This is used when the php ''intl'' extension is enabled.
-  * Whether to filter item content for whitelisted tags only. The default is to filter. 
-  * Whether to generate special content when an item's URL field is to YouTube or to a pdf file. The default is not to generate the special content. 
-  * The maximum size of the HTTP body of the feed response. 
-  * Whether to use the summary content or full content for the [CONTENT] placeholder. 
-The set of whitelisted tags are 
- 
-'''audio', 'video', 'source', 'dt', 'dd', 'dl', 'table', 'caption', 'tr', 'th', 'td', 'tbody', 'thead', 'h1', 'h2', 'h3', 'h4', 'h5', 'h6', 'strong', 'em', 'code', 'pre', 'blockquote', 'p', 'ul', 'li', 'ol', 'br', 'del', 'a', 'img', 'figure', 'figcaption', 'cite', 'time', 'abbr', 'iframe', 'q', 'sup', 'sub'''  
- 
-When an item's URL field (taken from the ''link'' element) is a URL to a YouTube video or to a pdf file then the plugin can generate special content instead of using the ''summary'', ''description'' or ''content'' elements. 
- 
-<code html><link href="https://www.youtube.com/watch?v=99999999"/> 
-<link href="https://example.com/document.pdf"/></code> 
- 
-For a YouTube video the content will be an iframe element that refers to the video. This is not really useful because many email clients will not display an iframe element. 
  
-<code html><iframe width="560" height="315" src="//www.youtube.com/embed/99999999" frameborder="0"></iframe></code>+The plugin used to have settings for allowing only whitelisted tags, generating special content for a Youtube URL, and specifying the maximum size of the HTTP response. These were specific to the Picofeed package which is no longer used.
  
-For a pdf file the content will be a link to the file. +There was also a setting for whether to use a feed item's ''description'' element or ''summary'' element. This setting is no longer needed because the plugin now provides a ''[DESCRIPTION]'' placeholder in addition to the ''[SUMMARY]'' placeholder.
-<code html><a href="https://example.com/document.pdf" target="_blank">https://example.com/document.pdf</a></code>+
  
 {{:plugin:rss7.png?nolink|}} {{:plugin:rss7.png?nolink|}}