Kopete/Jabber Muc: Difference between revisions

Revision as of 10:51, 30 October 2010

Other languages:

Internet-group-chat Jabber Group Chat, also called MUC (multi user chat) is the Jabber equivalent of IRC channels.

Warning

Some of this information is old and may be obsolete. If you are a user of Kopete please either directly edit this page or add notes on the attached Discussion page

The Kopete support of MUC is only partial, this is because our backend XMPP library (iris) only supports the old GroupChat protocol. Anyway, Kopete is still pretty good and some good improvements have been made in the version 0.12

This page will describe some hidden Kopete features.

MUC is really a good alternative to IRC. It supports almost everything that IRC supports and even more.

Join a groupchat

First things first, Kopete users sometimes ask how the join a groupchat. This is the join groupchat action in the jabber menu. There, a dialog asks you for the room and the server and your nick. Imagine you want to join kde@conference.kdetalk.net. "kde" is the room and "conference.kdetalk.net" is the server.

Style

Using the default style for groupchats is a bit annoying due to the space waste. Fortunately, some styles render groupchats well.

For Kopete 0.12 i would recommend theses style:

The Gaim style with the Contact Color variant.
The Kone style with the Contact Color No Icon Compact variant (available on kde-look)

Invitation

Did you know that from Kopete v.0.12, it is possible to invite a contact to a MUC ? Simply drag and drop the contact in the MUC chat window.

Bookmarks

Kopete uses JEP-0048 for showing the chat bookmark menu. There is no Kopete interface to remove or edit bookmarks. Each chat you join is automatically added to your bookmarks.

You could anyway use the send RAW XML dialog (in the jabber account menu) to edit the bookmark in XML on the server, as explained in JEP-0048 and JEP-0049

Example, to erase your bookmarks, enter

  <query xmlns='jabber:iq:private'>
    <storage xmlns='storage:bookmarks'>
  </query>

Then disconnect and reconnect in order the changes take effect.

Auto-JOIN

Kopete does also support auto-joining groupchat when connecting. This still follow the bookmark specification of JEP-0048.

Example, if you want to automatically join kde@conference.kdetalk.net when starting Kopete, you can sendthe following

  <query xmlns='jabber:iq:private'>
    <storage xmlns='storage:bookmarks'>
      <conference name='Kde channel'>
                  autojoin='true'
                  jid='kde@conference.kdetalk.net'>
        <nick>Puck</nick>
      </conference>
    </storage>
  </query>

XML

More generally, most of moderation and admin features are available with the XML console, although you need to have compiled kde with debug in order to see the result in the debug output. Run kdebugdialog and make sure jabber raw (14131) is checked.

All the MUC protocol is described in JEP-0045

Notifications

By default, messages in a group chat are notified with the "not important message" notification. If someone types your nick in the channel, the message will be highlighted, and the "highlight" notification will be emitted.

The Highlight plugin has great value in group chat. Go into the configure plugins menu, and enable highlight. You can add filters to match someword or regular expression in a chat and you can change the notification level of such messages.

Thus, you can stay idle in a groupchat and be notified when someone talks about a subject you are interested in.

@@ Line 1: / Line 1: @@
 <languages />
 <translate>
+<!--T:1-->
 [[File:Internet-group-chat.svg|Internet-group-chat]] '''Jabber Group Chat, also called MUC (multi user chat) is the Jabber equivalent of IRC channels.'''
+<!--T:2-->
 {{Warning|1=Some of this information is old and may be obsolete. If you are a user of Kopete please either directly edit this page or add notes on the attached Discussion page}}
+<!--T:3-->
 The '''Kopete''' support of MUC is only partial, this is because our backend XMPP library ('''iris''') only supports the old ''GroupChat'' protocol.  Anyway, '''Kopete''' is still pretty good and some good improvements have been made in the version 0.12
+<!--T:4-->
 This page will describe some hidden '''Kopete''' features.
+<!--T:5-->
 MUC is really a good alternative to IRC.  It supports almost everything that IRC supports and even more.
-==Join a groupchat==
+==Join a groupchat== <!--T:6-->
+<!--T:7-->
 First things first, '''Kopete''' users sometimes ask how the join a groupchat.
 This is the  <menuchoice>join groupchat</menuchoice> action in the '''jabber''' menu.
@@ Line 20: / Line 26: @@
 Imagine you want to join  kde@conference.kdetalk.net.   "kde" is the room and "conference.kdetalk.net" is the server.
-==Style==
+==Style== <!--T:8-->
+<!--T:9-->
 Using the default style for groupchats is a bit annoying due to the space waste.
 Fortunately, some styles render groupchats well.
+<!--T:10-->
 For Kopete 0.12 i would recommend theses style:
 * The '''Gaim''' style with the ''Contact Color'' variant.
 * The '''Kone''' style with the ''Contact Color No Icon Compact'' variant (available on [http://kde-look.org/ kde-look])
-==Invitation==
+==Invitation== <!--T:11-->
+<!--T:12-->
 Did you know that from '''Kopete''' v.0.12, it is possible to invite a contact to a MUC ?
 Simply drag and drop the contact in the MUC chat window.
-==Bookmarks==
+==Bookmarks== <!--T:13-->
+<!--T:14-->
 '''Kopete''' uses [http://www.jabber.org/jeps/jep-0048.html JEP-0048] for showing the chat bookmark menu.
 There is no '''Kopete''' interface to remove or edit bookmarks. Each chat you join is automatically added to your bookmarks.
+<!--T:15-->
 You could anyway use the <menuchoice>send RAW XML</menuchoice> dialog (in the jabber account menu) to edit the bookmark in XML on the server, as explained in [http://www.jabber.org/jeps/jep-0048.html JEP-0048] and [http://www.jabber.org/jeps/jep-0049.html JEP-0049]
+<!--T:16-->
 Example, to erase your bookmarks, enter
+<!--T:17-->
 <syntaxhighlight lang="xml">
    <query xmlns='jabber:iq:private'>
@@ Line 49: / Line 62: @@
 </syntaxhighlight>
+<!--T:18-->
 Then disconnect and reconnect in order the changes take effect.
-==Auto-JOIN==
+==Auto-JOIN== <!--T:19-->
+<!--T:20-->
 '''Kopete''' does also support auto-joining groupchat when connecting.  This still follow the bookmark specification of JEP-0048.
+<!--T:21-->
 Example, if you want to automatically join kde@conference.kdetalk.net when starting '''Kopete''', you can sendthe following
+<!--T:22-->
 <syntaxhighlight lang="xml">
    <query xmlns='jabber:iq:private'>
@@ Line 70: / Line 87: @@
 </syntaxhighlight>
-==XML==
+==XML== <!--T:23-->
+<!--T:24-->
 More generally, most of ''moderation'' and ''admin features'' are available with the XML console,  although you need to have compiled kde with debug in order to see the result in the debug output.  Run kdebugdialog and make sure <menuchoice>jabber raw (14131)</menuchoice> is checked.
+<!--T:25-->
 All the MUC protocol is described in [http://www.jabber.org/jeps/jep-0045.html JEP-0045]
-==Notifications==
+==Notifications== <!--T:26-->
+<!--T:27-->
 By default, messages in a group chat are notified with the  "not important message" notification.
 If someone types your nick in the channel, the message will be highlighted, and the "highlight" notification will be emitted.
+<!--T:28-->
 The <menuchoice>Highlight</menuchoice> plugin has great value in group chat. Go into the <menuchoice>configure plugins</menuchoice> menu, and enable <menuchoice>highlight</menuchoice>.  You can add filters to match someword or regular expression in a chat and you can change the notification level of such messages.
+<!--T:29-->
 Thus, you can stay idle in a groupchat and be notified when someone talks about a subject you are interested in.
+<!--T:30-->
 [[Category:Internet]]
 </translate>