view mod_muc_badge/README.markdown @ 3157:8a870e0319db

mod_pubsub_stats: Remove unused import of util.datetime An earlier version may have used a timestamp as item id
author Kim Alvefur <zash@zash.se>
date Thu, 28 Jun 2018 17:44:21 +0200
parents a3afab416271
children 4a77c9c2a1cd
line wrap: on
line source

---
depends:
- 'mod\_http'
- 'mod\_muc'
provides:
- http
title: 'mod\_muc\_badge'
---

# Introduction

This module generates a badge for MUC rooms at a HTTP URL like
`https://example.com:5281/muc_badge/room@conference.example.org`
containing the number of occupants.

Inspiration
:   <https://opkode.com/blog/xmpp-chat-badge/>

# Configuration

  Option             Type     Default
  ------------------ -------- --------------------------
  `badge_label`      string   `"Chatroom"`
  `badge_count`      string   `"%d online"`
  `badge_template`   string   A SVG image (see source)

The template must be valid XML. If it contains `{label}` then this is
replaced by `badge_label`, similarly, `{count}` is substituted by
`badge_count` with `%d` changed to the number of occupants.

Details of the HTTP URL is determined by [standard Prosody HTTP server
configuration][doc:http].

# TODO

-   Maybe use the room name instead of a fixed label. Would need dynamic
    resizing.