The Discourse RSS Polling plugin allows topics to be automatically created from one or more RSS feeds. This topic describes how to install and configure the plugin.
If your site is hosted by us, the plugin is pre-installed on your site, but the setting to enable it is hidden. Contact our support team to have us enable the plugin for you.
For self-hosted sites, install the plugin following the method outlined in Install Plugins in Discourse.
For self-hosted sites, select the
rss polling enabled site setting to enable the plugin. For sites on our hosting, contact out support team to have us enable the plugin for you.
rss polling frequency site setting controls the frequency that the RSS feed is polled. The default value is to poll the feed once every 30 minutes. The setting has a minimum allowed value of 10 minutes.
Once the plugin is enabled, go to your Admin / Plugins page. Click the RSS Polling entry from the plugin’s page sidebar to add your feed URLs. Each Feed URL needs to be associated with a Discourse user. That user will be the author of the feed’s topics. Click the “save” icon to save your changes:
Set the feed’s categories
The categories that your feed gets published to are configured on the Host section of the Admin / Customize / Embedding page. Start by clicking the “Add Host” button to add a host record for your feed:
In the form that appears, set the “Allowed Hosts” field to the domain that is set in the
link attributes of your feed. In many cases, the domain that is used in the
link attributes will be the same domain as your feed is on. This is not always the case though. You can confirm this by loading your feed directly in your browser and looking at the value of the
The optional “Path Whitelist” field allows you to target specific URL paths to have them publish to separate Discourse categories. The path should start with
/ and end with a wildcard symbol (
.* ). For example
The “Post to Category” field sets the category that the host record will publish to.
In the following example, there are two host entries for the feed at
blog.example.com . Posts in that feed that are on the
/en/ path will be published to the “English” category. Posts in that feed that are on the
/fr/ path will by published to the “French” category:
Showing the full post content
embed truncate site setting is enabled on your site (it is enabled by default), feed topics will only display an excerpt of the feed post. Users can view the full post by clicking the “Show Full Post” button that is displayed below the excerpt. Discourse will then scrape the topic’s embed URL to get the full post content. If the full post content is not being correctly retrieved, you can fix the issue by configuring the
embed whitelist selector site setting. See How to configure the embed whitelist selector setting for details about that setting.