Mercurial > prosody-modules
diff mod_roster_command/README.wiki @ 1782:29f3d6b7ad16
Import wiki pages
author | Kim Alvefur <zash@zash.se> |
---|---|
date | Mon, 24 Aug 2015 16:43:56 +0200 |
parents | |
children |
line wrap: on
line diff
--- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/mod_roster_command/README.wiki Mon Aug 24 16:43:56 2015 +0200 @@ -0,0 +1,51 @@ +#summary Manage rosters through prosodyctl +#labels Stage-Beta + += Introduction = + +This module allows you to perform various actions on user rosters via prosodyctl. + += Details = + +After putting this module in your modules directory you can use it via prosodyctl like this: + +{{{ + prosodyctl mod_roster_command COMMAND [OPTIONS...] +}}} + +*Note:* Do not add mod_roster_command to your Prosody config file. This is unnecessary because it will automatically be loaded by prosodyctl when you use it. + +== Commands == + +{{{ + subscribe user@host contact@host +}}} + +Subscribes the user to the contact's presence. That is, the user will see when the contact is online (but the contact won't see the user). + +{{{ + subscribe_both user@host contact@host +}}} +The same as the 'subscribe' command, but performs the subscription in both directions, so that both the contact and user will always see each other online. + +{{{ + unsubscribe user@host contact@host +}}} + +Removes a subscription to the contact's presence. + +{{{ + unsubscribe_both user@host contact@host +}}} + +Same as unsubscribe, but also revokes a contact's subscription to the user's presence. + +{{{ + rename user@host contact@host [name] [group] +}}} + +Sets or updates a name for a contact in the user's roster, and moves the contact to the given group, if specified. + += Compatibility = +|| 0.9 || Works || +|| 0.8 || Works || \ No newline at end of file