Mercurial > prosody-modules
view mod_pubsub_feeds/README.markdown @ 4976:75b6e5df65f9
various: Improve error reporting if missing file server module on 0.12
If there is some error loading net.http.files then it would be swallowed
by the pcall and then it would proceed to trying mod_http_files, which
might cause unexpected behavior on 0.12
Ref #1765
author | Kim Alvefur <zash@zash.se> |
---|---|
date | Mon, 18 Jul 2022 22:47:54 +0200 |
parents | e4a986d55bb2 |
children | 43b67142b37c |
line wrap: on
line source
--- 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. # 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. # PubSubHubbub This module also implements a [PubSubHubbub](http://pubsubhubbub.googlecode.com/svn/trunk/pubsubhubbub-core-0.3.html) subscriber. This allows feeds that have an associated "hub" to push updates when they are published. Not all feeds support this. It needs to expose a HTTP callback endpoint to work. # Option summary 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` Set to `false` to disable PubSubHubbub # Compatibility ----- ------- 0.9 Works ----- -------