Kopete/Jabber Muc: Difference between revisions

From KDE Wiki Sandbox
(Markup edit)
m (Remove link to dead image)
 
(3 intermediate revisions by 2 users not shown)
Line 1: Line 1:
<languages />
<languages />
<translate>
<translate>
[[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:1-->
'''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
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.
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.
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.
First things first, '''Kopete''' users sometimes ask how the join a groupchat.
This is the  <menuchoice>join groupchat</menuchoice> action in the '''jabber''' menu.
This is the  <menuchoice>join groupchat</menuchoice> action in the '''jabber''' menu.
Line 17: Line 26:
Imagine you want to join  kde@conference.kdetalk.net.  "kde" is the room and "conference.kdetalk.net" is the server.
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.
Using the default style for groupchats is a bit annoying due to the space waste.
Fortunately, some styles render groupchats well.
Fortunately, some styles render groupchats well.


For Kopete 0.12 i would recommend theses style:
<!--T:10-->
For Kopete 0.12 I would recommend these styles:
* The '''Gaim''' style with the ''Contact Color'' variant.
* 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])
* 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 ?
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.
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.
'''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.
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]
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
Example, to erase your bookmarks, enter


<!--T:17-->
<syntaxhighlight lang="xml">
<syntaxhighlight lang="xml">
   <query xmlns='jabber:iq:private'>
   <query xmlns='jabber:iq:private'>
Line 46: Line 62:
</syntaxhighlight>
</syntaxhighlight>


<!--T:18-->
Then disconnect and reconnect in order the changes take effect.
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.
'''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
<!--T:21-->
Example, if you want to automatically join kde@conference.kdetalk.net when starting '''Kopete''', you can send the following


<!--T:22-->
<syntaxhighlight lang="xml">
<syntaxhighlight lang="xml">
   <query xmlns='jabber:iq:private'>
   <query xmlns='jabber:iq:private'>
Line 67: Line 87:
</syntaxhighlight>
</syntaxhighlight>


==XML==
==XML== <!--T:23-->


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: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]
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.
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.
If someone types your nick in the channel, the message will be highlighted, and the "highlight" notification will be emitted.


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: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 some word 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.
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]]
[[Category:Internet]]
</translate>
</translate>

Latest revision as of 12:14, 26 February 2019

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 these styles:

  • 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 send the 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 some word 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.