Mercurial > prosody-modules
diff mod_pubsub_github/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_github/README.wiki Mon Aug 24 16:43:56 2015 +0200 @@ -0,0 +1,32 @@ +#summary Publish Github commits over pubsub +#labels Stage-Beta + += Introduction = + +This module accepts Github web hooks and publishes them to a local pubsub component for XMPP clients to subscribe to. + +Entries are pushed as Atom payloads. + += Configuration = + +Load the module on a pubsub component: + +{{{ +Component "pubsub.example.com" "pubsub" + modules_enabled = { "pubsub_github" } +}}} + +The module also takes the following config options: + +|| *Name* || *Default* || *Description* || +|| github_node || "github" || The pubsub node to publish commits on. || + +The URL for Github to post to would be either: + + * http://pubsub.example.com:5280/pubsub_github + * https://pubsub.example.com:5281/pubsub_github + +If your HTTP host doesn't match the pubsub component's address, you will need to inform Prosody. For more info see Prosody's [https://prosody.im/doc/http#virtual_hosts HTTP server documentation]. + += Compatibility = +|| 0.9 || Works || \ No newline at end of file