view mod_muc_webchat_url/README.markdown @ 3672:b8bcea17ccd6

mod_muc_webchat_url: Advertise the URL to a webchat in disco#info
author Kim Alvefur <>
date Tue, 17 Sep 2019 17:12:59 +0200
children 8ee5816363b0
line wrap: on
line source

# Introduction

Many projects have a support room accessible via a web chat. This module
allows making the URL to such a web chat discoverable via the XMPP
service discovery protocol, enabling e.g. [search
engines]( to index and present these.

# Configuring

## Enabling

``` {.lua}
Component "" "muc"
modules_enabled = {

## Settings

The URL is configured using the in-band MUC room configuration protocol.

The module can optionally be configured to give all public (not
members-only, hidden or password protected) rooms gain a default value
based on a template:

``` {.lua}
muc_webchat_url = "{node}"

The following variables will be subsituted with room address details:

:   The complete room address, eg ``ยท

:   The local part (before the `@`) of the room JID.

:   The domain name part of the room JID.