Diff

mod_pubsub_text_interface/README.md @ 6211:750d64c47ec6

Merge
author Trần H. Trung <xmpp:trần.h.trung@trung.fun>
date Tue, 18 Mar 2025 00:31:36 +0700 (3 months ago)
parent 6003:fe081789f7b5
line wrap: on
line diff
--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/mod_pubsub_text_interface/README.md	Tue Mar 18 00:31:36 2025 +0700
@@ -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.