Software /
code /
prosody-modules
Diff
mod_pubsub_text_interface/README.md @ 6003:fe081789f7b5
All community modules: Unify file extention of Markdown files to .md
author | Menel <menel@snikket.de> |
---|---|
date | Tue, 22 Oct 2024 10:26:01 +0200 |
parent | 3436:12c7c0d7e1b0 |
line wrap: on
line diff
--- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/mod_pubsub_text_interface/README.md Tue Oct 22 10:26:01 2024 +0200 @@ -0,0 +1,35 @@ +# Introduction + +This module lets you manage subscriptions to pubsub nodes via simple +chat messages. Subscriptions are always added based on bare JID. The +`include_body` flag is enabled so that a plain text body version of +events can be included, where supported. + +# Configuring + +``` {.lua} +Component "pubsub.example.com" "pubsub" +modules_enabled = { + "pubsub_text_interface", +} +``` + +# Commands + +The following commands are supported. Simply send a normal chat message +to the PubSub component where this module is enabled. When subscribing +or unsubscribing, be sure to replace `node` with the node you want to +subscribe to or unsubscribe from. + +- `help` - a help message, listing these commands +- `list` - list available nodes +- `subscribe node` - subscribe to a node +- `unsubscribe node` - unsubscribe from a node +- `last node` - sends the last published item from the node to you + +# Compatibility + +Should work with Prosody since 0.9, when +[mod\_pubsub][doc:modules:mod_pubsub] was introduced. + +The `last` command is available from Prosody 0.11.