view mod_muc_require_tos/README.markdown @ 4923:c83b009b5bc5

mod_rest: Add configuration of which stanzas to route to callback Makes it simpler to build APIs that only handle a certain kind of stanzas, letting them be handled by the unhandled stanza handler instead of having to write code to ignore certain kinds of stanzas.
author Kim Alvefur <zash@zash.se>
date Sat, 09 Apr 2022 01:04:25 +0200
parents 82dabfffaddf
children
line wrap: on
line source

---
labels:
- 'Stage-Alpha'
summary: Require visitors to accept something before being allowed in a room
...

# Introduction

This module sends a message to visitors of a room, prompting them to accept or reject it.

They get kicked if they reject it, and become members if they accept it.

# Setup

```lua
Component "rooms.example.org" "muc"
	modules_enabled = {
		"muc_require_tos";
	}
	tos_welcome_message = "Please read and accept the TOS of this service: https://lurk.org/TOS.txt"
	tos_yes_message = "Thanks, and welcome here!"
	tos_no_message = "Too bad."
```

Compatibility
=============

  ----- -----
  trunk Works
  ----- -----