Diff

mod_group_bookmarks/README.markdown @ 1803:4d73a1a6ba68

Convert all wiki pages to Markdown
author Kim Alvefur <zash@zash.se>
date Fri, 28 Aug 2015 18:03:58 +0200
parent 1782:29f3d6b7ad16
child 1820:8de50be756e5
line wrap: on
line diff
--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/mod_group_bookmarks/README.markdown	Fri Aug 28 18:03:58 2015 +0200
@@ -0,0 +1,71 @@
+---
+labels:
+- 'Stage-Beta'
+summary: 'mod\_groups for chatrooms'
+...
+
+Introduction
+============
+
+[mod\_groups](http://prosody.im/doc/modules/mod_groups) allows you to
+insert contacts into users' contact lists. Well mod\_group\_bookmarks
+allows you to insert chatrooms into the user's bookmarks. These are
+fetched by their client and automatically joined when the log in.
+
+In short, if you want to automatically join users to rooms when they
+sign in, this is the module you want.
+
+Details
+=======
+
+Most clients support storing a private list of room "bookmarks" on the
+server. When they log in, they fetch this list and join any that are
+marked as "autojoin". Without affecting normal usage of the bookmarks
+store this module dynamically inserts custom rooms into users' bookmarks
+lists.
+
+Usage
+=====
+
+Similar to [mod\_groups](http://prosody.im/doc/modules/mod_groups), you
+need to make a text file in this format:
+
+    [room@conferenceserver]
+    user1@example.com=User 1
+    user2@example.com=User 2
+
+    [otherroom@conferenceserver]
+    user3@example.net=User 3
+
+Add "group\_bookmarks" to your modules\_enabled list:
+
+        modules_enabled = {
+                   -- ...other modules here... --
+                   "group_bookmarks";
+                   -- ...maybe some more here... --
+        }
+
+Configuration
+=============
+
+  ------------------------ ---------------------------------------------------
+  group\_bookmarks\_file   The path to the text file you created (as above).
+  ------------------------ ---------------------------------------------------
+
+Compatibility
+=============
+
+  ----- -------------
+  0.8   Works
+  0.7   Should work
+  0.6   Should work
+  ----- -------------
+
+Todo
+====
+
+-   Support for injecting into ALL users bookmarks, without needing a
+    list
+-   Allow turning off the autojoin flag
+-   Perhaps support a friendly name for the bookmark (currently uses the
+    room address)