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. Select a user from your Discourse site for the feed’s Author field. That user will become the owner of all posts published from the feed. Use the Discourse Category setting to configure which category the feed’s posts will be published to:
Note that if you have previously configured the RSS Polling plugin by setting the categories to publish to on your site’s Embedding page, those category settings will continue to work. The new method of configuring the feed categories directly on the RSS Polling page is a far more straightforward approach. Let us know if you have questions about this change.
embed unlisted site setting.
The optional Feed Category Filter setting for each entry allow you to limit which feed items get published to Discourse based on the item’s category. When a category is entered into this setting, only feed items matching this category will be published to Discourse. Taking the feed at https://blog.discourse.org/feed.xml as an example, if you load that feed directly in your browser you will see that each entry has a
category tag associated with it. The value of that category’s
term property is what you would enter into the Feed Category Filter setting if you wished to only publish feed items for a specific category. For example:
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 allowed embed selectors setting for details about that setting.