# HG changeset patch
# User Kim Alvefur <zash@zash.se>
# Date 1480773675 -3600
# Node ID b426f1d46938821b33b267e5f8a27cfea649b352
# Parent  9d132153d78665c670f34d6d6f99a8fc9343b970
mod_track_muc_joins/README: Add some example code

diff -r 9d132153d786 -r b426f1d46938 mod_track_muc_joins/README.markdown
--- a/mod_track_muc_joins/README.markdown	Fri Dec 02 20:47:11 2016 +0000
+++ b/mod_track_muc_joins/README.markdown	Sat Dec 03 15:01:15 2016 +0100
@@ -2,6 +2,43 @@
 summary: Keep track of joined chat rooms
 ...
 
+# Introduction
+
 This module attempts to keep track of what MUC chat rooms users have
 joined. It's not very useful on its own, but can be used by other
 modules to influence decisions.
+
+# Usage
+
+Rooms joined and the associated nickname is kept in a table field
+`rooms_joined` on the users session.
+
+An example:
+
+``` lua
+local jid_bare = require"util.jid".bare;
+
+module:hook("message/full", function (event)
+    local stanza = event.stanza;
+    local session = prosody.full_sessions[stanza.attr.to];
+    if not session then
+        return -- No such session
+    end
+
+    local joined_rooms = session.joined_rooms;
+    if not joined_rooms then
+        return -- This session hasn't joined any rooms at all
+    end
+
+    -- joined_rooms is a map of room JID -> room nickname
+    local nickname = joined_rooms[jid_bare(stanza.attr.from)];
+    if nickname then
+        session.log("info", "Got a MUC message from %s", stanza.attr.from);
+
+        local body = stanza:get_child_text("body");
+        if body and body:find(nickname, 1, true) then
+            session.log("info", "The message contains my nickname!");
+        end
+    end
+end);
+```