Mercurial > prosody-modules
diff mod_pubsub_feeds/README.wiki @ 1782:29f3d6b7ad16
Import wiki pages
author | Kim Alvefur <zash@zash.se> |
---|---|
date | Mon, 24 Aug 2015 16:43:56 +0200 |
parents | |
children |
line wrap: on
line diff
--- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/mod_pubsub_feeds/README.wiki Mon Aug 24 16:43:56 2015 +0200 @@ -0,0 +1,31 @@ +#summary Subscribe to Atom and RSS feeds over pubsub + += Introduction = + +This module allows Prosody to fetch Atom and RSS feeds for you, and push new results to subscribers over XMPP. + +This module also implements a [http://pubsubhubbub.googlecode.com/svn/trunk/pubsubhubbub-core-0.3.html PubSubHubbub] subscriber, allowing updates be delivered without polling for supporting feed publishers. + += Configuration = + +This module must be loaded on a Prosody pubsub component. Add it to `modules_enabled` and configure like so: + +{{{ +Component "pubsub.example.com" "pubsub" + modules_enabled = { "pubsub_feeds" } + + feeds = { + 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 [http://xmpp.org/extensions/xep-0060.html XEP-0060]. Results are in [http://atomenabled.org/ ATOM 1.0 format] for easy consumption. + +|| *Option* || *Description* || +|| feeds || A list of virtual nodes to create and their associated Atom or RSS URL. || +|| feed_pull_interval || Number of minutes between polling for new results (default 15) || +|| use_pubsubhubub || If PubSubHubbub should be enabled, true by default. || + += Compatibility = +|| 0.9 || Works ||