view mod_pubsub_github.wiki @ 500:4d4d81fa31fa

mod_mam_sql: Add warning about being unsupported and outdated
author Kim Alvefur <zash@zash.se>
date Wed, 07 Jan 2015 21:20:43 +0100
parents 3cd17a2dd5c6
children
line wrap: on
line source

#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 ||