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.