doc-src/im

   1 <!-- Copyright 2008-2010 StatusNet Inc. and contributors. -->
   2 <!-- Document licensed under Creative Commons Attribution 3.0 Unported. See -->
   3 <!-- http://creativecommons.org/licenses/by/3.0/ for details. -->
   4
   5 You can post messages to %%site.name%% using a [Jabber](http://jabber.org/) client
   6 on your computer, mobile phone, or other platform. ([GTalk](http://talk.google.com/),
   7 Google's Jabber program, will also work.) This can be a convenient way to keep
   8 up with your friends on %%site.name%%.
   9
  10 If you don't already have a Jabber account, you can use GTalk or one of the other
  11 [public Jabber services](http://www.jabber.org/im-services). You'll probably also
  12 need an IM client like [Pidgin](http://www.pidgin.im/).
  13
  14 Managing your IM settings
  15 -------------------------
  16
  17 Use the [IM settings](%%action.imsettings%%) page to set your IM preferences. You can add or change your Jabber address and set the flags for Jabber update.
  18
  19 When you add or change your address, you'll receive a message from **%%xmpp.user%%@%%xmpp.server%%** asking you to confirm the change. (You may need to
  20 add %%xmpp.user%%@%%xmpp.server%% to your buddy list *before* changing your IM
  21 settings; this is definitely true for GTalk.)
  22
  23 Sending updates
  24 ---------------
  25
  26 You send updates by sending messages to %%xmpp.user%%@%%xmpp.server%%. Messages
  27 should be less than %%site.textlimit%% characters; longer messages will be truncated.
  28
  29 Commands
  30 --------
  31
  32 You can do some minor management of your account through Jabber. These are the
  33 currently-implemented commands:
  34
  35 * **on**: Turn on notifications. You'll receive copies of messages by people
  36   you subscribe to.
  37 * **off**: Turn off notifications. You'll no longer receive Jabber
  38   notifications.
  39 * **stop**: Same as 'off'
  40 * **quit**: Same as 'off'
  41 * **help**: Show this help. List available Jabber/XMPP commands
  42 * **follow &lt;nickname&gt;**: Subscribe to &lt;nickname&gt;
  43 * **sub &lt;nickname&gt;**: Same as follow
  44 * **leave &lt;nickname&gt;**: Unsubscribe from &lt;nickname&gt;
  45 * **unsub &lt;nickname&gt;**: Same as leave
  46 * **d &lt;nickname&gt; &lt;text&gt;**: Send direct message to &lt;nickname&gt; with message body &lt;text&gt;
  47 * **get &lt;nickname&gt;**: Get last notice from &lt;nickname&gt;
  48 * **last &lt;nickname&gt;**: Same as 'get'
  49 * **whois &lt;nickname&gt;**: Get Profile info on &lt;nickname&gt;
  50 * **fav &lt;nickname&gt;**: Add user's last notice as a favorite