Mercurial > prosody-modules
view mod_pubsub_feeds/README.markdown @ 5951:d6a695abb33c
mod_ping_muc: Delay ping a configurable amount of time
If a server is restarting, checking immediately before it has a chance
to complete its restart and get ready would often fail, preventing the
possibility of transparent restarts as supported by Prosody's mod_muc.
Reconnecting immediately when a connection is closed for being idle, or
because the remote server is trying to reclaim some resources, is also
counter-productive as the connection may fail.
Also, if there is some Internet routing problem affecting s2s, it may
help to wait a bit before checking, in case the problem resolved itself
in the mean time.
author | Kim Alvefur <zash@zash.se> |
---|---|
date | Sun, 11 Aug 2024 16:10:24 +0200 |
parents | f93b1fc1aa31 |
children |
line wrap: on
line source
--- 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 ------ -------