Tweaking documentation to clarify that Oauth2 can be used for VirtualHosts and Component
installations.
---
summary: Subscribe to Atom and RSS feeds over pubsub
rockspec:
build:
modules:
mod_pubsub_feeds.feeds: feeds.lib.lua
---
# Introduction
This module allows Prosody to fetch Atom and RSS feeds for you, and push
new results to subscribers over XMPP.
# Configuration
This module needs to be be loaded together with
[mod\_pubsub][doc:modules:mod\_pubsub].
For example, this is how you could add it to an existing pubsub
component:
``` lua
Component "pubsub.example.com" "pubsub"
modules_enabled = { "pubsub_feeds" }
feeds = {
-- The part before = is used as PubSub node
planet_jabber = "http://planet.jabber.org/atom.xml";
prosody_blog = "http://blog.prosody.im/feed/atom.xml";
}
```
This example creates two nodes, 'planet\_jabber' and 'prosody\_blog'
that clients can subscribe to using
[XEP-0060](http://xmpp.org/extensions/xep-0060.html). Results are in
[ATOM 1.0 format](http://atomenabled.org/) for easy consumption.
# WebSub {#pubsubhubbub}
This module also implements [WebSub](https://www.w3.org/TR/websub/),
formerly known as
[PubSubHubbub](http://pubsubhubbub.googlecode.com/svn/trunk/pubsubhubbub-core-0.3.html).
This allows "feed hubs" to instantly push feed updates to subscribers.
This may be removed in the future since it does not seem to be oft used
anymore.
# Option summary
Option Description
------------------------------ --------------------------------------------------------------------------
`feeds` A list of virtual nodes to create and their associated Atom or RSS URL.
`feed_pull_interval_seconds` Number of seconds between polling for new results (default 15 *minutes*)
`use_pubsubhubub` Set to `true` to enable WebSub
# Compatibility
------ -------
0.12 Works
0.11 Works
------ -------