Comparison

mod_track_muc_joins/README: Add some example code

comparison

equal deleted inserted replaced

-:9d132153d786
+:b426f1d46938
 ---
 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);
+```