{docbook}
    <highlights>
        <itemizedlist>
            <listitem>
                <para>
                   <link linkend="CSUser_guide.How_to_use_Chat.Create_a_chat_room.Add_contact_to_friends_list">Add contacts to your friend list</link>
				</para>
				<para>
				Steps to add a contact to your contact list.
                </para>
            </listitem>
            <listitem>
                <para>
                   <link linkend="CSUser_guide.How_to_use_Chat.Remove_contact">Remove a contact</link>
				</para>
				<para>
				Steps to remove a contact from your contact list.
                </para>
            </listitem>
            <listitem>
                <para>
                   <link linkend="CSUser_guide.How_to_use_Chat.Chat_with_contact">Chat with a contact</link>
				</para>
				<para>
				How to start a conversation with a contact and to perform many related actions, such as setting the online status, sending files, exporting or showing the chat history.
                </para>
            </listitem>
            <listitem>
                <para>
                   <link linkend="CSUser_guide.How_to_use_Chat.Create_a_chat_room">Create a chat room</link>
				</para>
				<para>
					Steps to create a chat room and perform many related actions, including: adding people, joining/leaving a chat room and changing the chat room preferences.
                </para>
            </listitem>
        </itemizedlist>
    </highlights>
{docbook}

{docbook}
<note>
<para>
Two portlets, including <emphasis role="bold">Chat</emphasis> and <emphasis role="bold">Chatbar,</emphasis> and their services are deprecated. They remain fully supported for eXo customers, however they will not receive any enhancement and will be removed from the product
scope in the future.
</para>
</note>
{docbook}

The *Chat* feature is used through the *Chat* or *Chatbar* portlet. The only difference between these portlets is the arrangement of common actions.
In particular, actions of the *Chat* portlet are arranged in a window, meanwhile actions of the *Chatbar* portlet are put in one bar. Also, the *Chatbar* holds shortcuts to your *Calendar*, *Contact*, *Mail*.

*Chat portlet*

!images/Chat_portlet.png|align="center" width="70mm" fo:scalefit="1" html:scalefit="0"!

*Chatbar*

!images/Chatbar.png|align="center" width="150mm" fo:scalefit="1" html:scalefit="0"!

To use the *Chat* feature, you first need to add the Chat portlet or the Chatbar to a specific site or page as follows:

{docbook}
<para>
        <emphasis role="bold">1.</emphasis> Drag and drop the application called <guilabel>Chat Portlet</guilabel>
        or <emphasis role="bold">ChatBar Portlet</emphasis> from the <menuchoice><guimenu> Edit Inline Composer/Page Editor</guimenu><guisubmenu>Applications</guisubmenu> <guimenuitem>Collaboration</guimenuitem></menuchoice> to the body of your selected site/page.  You can do this step while <link linkend="sect-User_Guide-Page_Creation_Wizard">creating a new page</link>, or <link linkend="sect-User_Guide-Manage_Pages-Edit_a_Page">editing an existing page</link>, or <link linkend="proc-User_Guide-Manage_Portals-Edit_Layout">editing the portal layout.</link> For example, drag and drop the <guilabel>Chatbar</guilabel> portlet as the below illustration.</para>
{docbook}

!images/Chat_drag_chat_bar.png|align="center" width="150mm" fo:scalefit="1" html:scalefit="0"!

*2.* Edit the *Chatbar* portlet by hovering your cursor over it, then clicking !images/Chat_edit_portlet_icon.png|width="4mm" fo:scalefit="1" html:scalefit="0"!.

!images/Edit_chat_bar_portlet.png|align="center" width="100mm" fo:scalefit="1" html:scalefit="0"!

{docbook}
<para>
        <emphasis role="bold">3.</emphasis> Go the the <guilabel>Windows Settings</guilabel> tab and uncheck the following options: <guilabel>Show Info Bar</guilabel>, <guilabel>Show Porlet Mode</guilabel>, <guilabel>Show Window State</guilabel>. By unchecking these options, the portlet border will be hidden. This may help the Chatbar portlet look homogeneous with other components of your site/page.</para>
{docbook}

!images/Chat_bar_window_settings.png|align="center" width="140mm" fo:scalefit="1" html:scalefit="0"!

{docbook}
<para>
        <emphasis role="bold">4.</emphasis> Click <guibutton>Save And Close</guibutton> to finish your changes and quit the Edit form of the <emphasis role="bold">ChatBar Portlet</emphasis>.</para>
{docbook}

{docbook}
<para>
        <emphasis role="bold">5.</emphasis> Click <inlinemediaobject>
          <imageobject role="fo">
            <imagedata fileref="images/Edit_inline_composer_Save.png" format="PNG" scalefit="1" width="4mm"/>
          </imageobject>
          <imageobject role="html">
            <imagedata fileref="images/Edit_inline_composer_Save.png" format="PNG" scalefit="0" width="4mm"/>
          </imageobject>
        </inlinemediaobject> to save all changes on the page/site and quit the <guilabel>Edit Inline Composer/Page Editor</guilabel> form. After that, you will see the <emphasis role="bold">Chatbar</emphasis> in your site/page.</para>
{docbook}

{docbook}
<note>
    <para>
    Steps 2, 3 and 4 are optional, but you are recommended to follow these steps.
    </para>
</note>
{docbook}

{docbook}
<para>
<prompt>
    <emphasis role="bold">See also</emphasis>
</prompt>
</para>
{docbook}

* [Manage your calendar|#Platform_User_Guide.Collaboration.Manage_calendar]
* [Manage your contacts|#Platform_User_Guide.Collaboration.Communicate_with_Contacts.Manage_Contacts]
* [Email your contacts|#Platform_User_Guide.Collaboration.Communicate_with_Contacts.Email_Contacts]

h1. Add contacts to your friend list {anchor:id="CSUser_guide.How_to_use_Chat.Create_a_chat_room.Add_contact_to_friends_listRoleNotInToc"}
You can search for contacts in your *Address Book* and add them to your friend list.

*1.* Click !images/contact_icon.png|width="4mm" fo:scalefit="1" html:scalefit="0"! on the *Chatbar*, then click !images/chat_add_contact_button.png|width="13mm" fo:scalefit="1" html:scalefit="0"! from the pop-up menu.

!images/chat_add_contact.png|align="center" width="40mm" fo:scalefit="1" html:scalefit="0"!

{docbook}
<para>The <guilabel>Add Contact</guilabel> form will appear.</para>
{docbook}

!images/add_contact_form.png|align="center" width="100mm" fo:scalefit="1" html:scalefit="0"!

*2.* Select the contacts from the list by ticking their respective checkboxes.

You can use the *Search* function to search for a specific contact.

{docbook}
<para>
    <emphasis role="bold">3.</emphasis> Click <guibutton>Add Contact</guibutton> to add your selected contacts to your friend list.</para>
{docbook}

Your invited contacts will receive the request messages.

{docbook}
<para>After the contacts have accepted your requests, you will receive the confirmation messages. Click <guibutton>OK</guibutton> to allow your contacts to see your status and add contacts to your contacts list.</para>
{docbook}

After adding your contacts successfully, the added contacts will be shown in your friend list.

h1. Remove a contact {anchor:id="CSUser_guide.How_to_use_Chat.Remove_contactRoleNotInToc"}
This action is to remove a contact from your friend list.

*1.* Click !images/contact_icon.png|width="4mm" fo:scalefit="1" html:scalefit="0"! on the Chatbar to show your friend list.

{docbook}
<para>
          <emphasis role="bold">2.</emphasis> Right-click the contact that you want to remove, then select <guilabel>Remove</guilabel> from the drop-down menu.</para>
{docbook}

!images/remove_context_menu.png|align="center" width="70mm" fo:scalefit="1" html:scalefit="0"!

{docbook}
<para>
          <emphasis role="bold">3.</emphasis> Click <guibutton>OK</guibutton> in the confirmation message to accept your removal.</para>
{docbook}

h1. Chat with a contact {anchor:id="CSUser_guide.How_to_use_Chat.Chat_with_contactRoleNotInToc"}

h2. Send messages {anchor:id="CSUser_guide.How_to_use_Chat.Send_messages"}

Sending messages in *Chat* is as simple as typing and clicking, so it is easy for you to start a conversation.

{docbook}
<citetitle>
<para>
<emphasis role="bold">Send instant messages</emphasis>
</para>
</citetitle>
{docbook}

{docbook}
<para>
 <emphasis role="bold">1.</emphasis> Open the <guilabel>Conversation</guilabel> window via one of the following ways:</para>
{docbook}

*The first way*

Click the contact name that you want to chat from your friend list.

*The second way*

{docbook}
<para>Click <inlinemediaobject>
              <imageobject role="fo">
                <imagedata fileref="images/contact_icon.png" format="PNG" scalefit="1" width="4mm"/>
              </imageobject>
              <imageobject role="html">
                <imagedata fileref="images/contact_icon.png" format="PNG" scalefit="0" width="4mm"/>
              </imageobject>
            </inlinemediaobject> on the Chatbar to show your friend list, then right-click your desired contact and select <guilabel>Send Message</guilabel> from the drop-down menu.</para>
{docbook}

{docbook}
<para>
  <emphasis role="bold">2.</emphasis> Type the message that you want to send into the message textbox, then click the <guibutton>Send</guibutton> button or hit the Enter key to send your message.</para>
{docbook}

!images/conversation_window.png|align="center" width="120mm" fo:scalefit="1" html:scalefit="0"!

{docbook}
<citetitle>
<para>
<emphasis role="bold">Minimize the chat window</emphasis>
</para>
</citetitle>
{docbook}

{docbook}
<para>Click <inlinemediaobject>
              <imageobject role="fo">
                <imagedata fileref="images/chat_minimize_icon.png" format="PNG" scalefit="1" width="4mm"/>
              </imageobject>
              <imageobject role="html">
                <imagedata fileref="images/chat_minimize_icon.png" format="PNG" scalefit="0" width="4mm"/>
              </imageobject>
            </inlinemediaobject> at the right corner of the <guilabel>Conversation</guilabel> window to minimize it to the Chatbar. To restore the window, simply click the minimized window (<inlinemediaobject>
              <imageobject role="fo">
                <imagedata fileref="images/minimized_window_icon.png" format="PNG" scalefit="1" width="4mm"/>
              </imageobject>
              <imageobject role="html">
                <imagedata fileref="images/minimized_window_icon.png" format="PNG" scalefit="0" width="4mm"/>
              </imageobject>
            </inlinemediaobject>) on the Chatbar.</para>
{docbook}

!images/chat_bar1.png|align="center" width="30mm" fo:scalefit="1" html:scalefit="0"!

{docbook}
<note>
    <para>
    When you send a message to offline contacts, they will receive your message at their next logins.
    </para>
    <para>
    You can chat with several contacts at the same time. Each conversation is displayed in its own tab. You can switch between tabs to follow different ongoing conversations.
    <mediaobject>
<imageobject role="html">
    <imagedata align="center" fileref="images/Chat_conversation_tabs.png" format="PNG" scalefit="0" width="100mm"/>
</imageobject>
<imageobject role="fo">
    <imagedata align="center" fileref="images/Chat_conversation_tabs.png" format="PNG" scalefit="1" width="100mm"/>
</imageobject>
</mediaobject>
	</para>
</note>
{docbook}

h2. Set your status {anchor:id="CSUser_guide.How_to_use_Chat.Set_status"}
When you signed in *Chat*, by default, your logged-in status is available and your friends will see the online icon !images/online_icon.png|width="4mm" fo:scalefit="1" html:scalefit="0"! appending to your account name in their friend lists.

There will be a notification about your friend's status if they are available to chat or go offline.

!images/Chat_notification_status.png|align="center" width="80mm" fo:scalefit="1" html:scalefit="0"!

{docbook}
<citetitle>
<para>
<emphasis role="bold">Change your status</emphasis>
</para>
</citetitle>
{docbook}

*1.* Click the account icon on the *Chatbar*.

!images/quick_chat_bar.png|align="center" width="40mm" fo:scalefit="1" html:scalefit="0"!

*2.* Select your desired status from the drop-down list.

*Details:*

||Icon||Description||
|!images/online_icon.png|width="4mm" fo:scalefit="1" html:scalefit="0"! *Online*| This status means you are available to chat. |
|!images/away_icon.png|width="4mm" fo:scalefit="1" html:scalefit="0"! *Away*| This status means you are away from your local device. Other users still can send instant messages to you. |
|!images/extend_away_icon.png|width="4mm" fo:scalefit="1" html:scalefit="0"! *Busy*| This status means you are away from your local device for an extended period of time. |
|!images/free_to_chat_icon.png|width="4mm" fo:scalefit="1" html:scalefit="0"! *Available*| This status means you are free to chat with everyone. |
|!images/offline_icon.png|width="4mm" fo:scalefit="1" html:scalefit="0"! *Offline*| With this status, you are invisible to other users. This means everyone will see you offline even though you are actually online. |

h2. Send a file {anchor:id="CSUser_guide.How_to_use_Chat.Send_file"}

The *Chat* application allows you to send files to your contact, such as holiday pictures, or documents needed for the incoming meeting.

{docbook}
<citetitle>
<para>
<emphasis role="bold">Send a file to a contact</emphasis>
</para>
</citetitle>
{docbook}

{docbook}
<para>
            <emphasis role="bold">1.</emphasis> Click <inlinemediaobject>
              <imageobject role="fo">
                <imagedata fileref="images/send_file_button.png" format="PNG" scalefit="1" width="14mm"/>
              </imageobject>
              <imageobject role="html">
                <imagedata fileref="images/send_file_button.png" format="PNG" scalefit="0" width="14mm"/>
              </imageobject>
            </inlinemediaobject> on the <guilabel>Conversation</guilabel> window.</para>
{docbook}
You will be prompted to select a file from your local device.

{docbook}
<para>
 <emphasis role="bold">2.</emphasis> Locate and select the file you want to send in the <guilabel>File Upload</guilabel> form, then click <guibutton>Open</guibutton>.</para>
{docbook}

Your contacts may cancel or accept the file transfer.

h2. Export the Chat history {anchor:id="CSUser_guide.How_to_use_Chat.Export_chat_history"}
The *Chat* application can archive your chat conversation and allows you to export and save your conversation history to your local device.
{docbook}
<para>
            <emphasis role="bold">1.</emphasis> Click <inlinemediaobject>
              <imageobject role="fo">
                <imagedata fileref="images/export_history.png" format="PNG" scalefit="1" width="17mm"/>
              </imageobject>
              <imageobject role="html">
                <imagedata fileref="images/export_history.png" format="PNG" scalefit="0" width="17mm"/>
              </imageobject>
            </inlinemediaobject> on the <guilabel>Conversation</guilabel> window.</para>
{docbook}
You will be prompted to select the location to save the exported file.

{docbook}
<para>
            <emphasis role="bold">2.</emphasis> Select the location to save the file, then click <guibutton>Save</guibutton> to accept the exported file to your local device.</para>
{docbook}

You will have a text file containing all of your conversation messages.

h2. Show chat history at a specific time {anchor:id="CSUser_guide.How_to_use_Chat.Show_message_at_specific_time}
Your chat messages history can be shown in a specific time interval.

*1.* Select a contact that you want to show the message log.

*2.* Select a time interval.

!images/time_interval.png|align="center" width="120mm" fo:scalefit="1" html:scalefit="0"!

Currently, the *Chat* application shows messages in the following time ranges:

{docbook}
<itemizedlist>
            <listitem>
              <para>
                <guilabel>Today</guilabel>: All messages of the current date.</para>
            </listitem>
            <listitem>
              <para>
                <guilabel>This week</guilabel>: All messages of the current week.</para>
            </listitem>
            <listitem>
              <para>
                <guilabel>Last 30 days</guilabel>: All messages during the last 30 days.</para>
            </listitem>
            <listitem>
              <para>
                <guilabel>Beginning</guilabel>: All instant messages from the beginning to the current time.</para>
            </listitem>
          </itemizedlist>
{docbook}

{docbook}
 <para>All messages with the created time and date will be shown in the <guilabel>Conversation</guilabel> window.</para>
{docbook}

h1. Create a chat room {anchor:id="CSUser_guide.How_to_use_Chat.Create_a_chat_roomRoleNotInToc"}
A chat room is a place where people with similar interests can meet and communicate with each other. People can often enter an unmoderated chat room without any verification of who they are.

With *Chat*, you also create a chat room and invite other users to join your room. In this way, you can organize and manage your group activities efficiently. It is convenient in the corporate environment when you can communicate in multiple chat rooms, each may have different topics and members. *Chat* supports up to 30 users to join a chat room.

{docbook}
<citetitle>
<para>
<emphasis role="bold">Create a chat room</emphasis>
</para>
</citetitle>
{docbook}

*1.* Click !images/chat_icon.png|width="4mm" fo:scalefit="1" html:scalefit="0"! on the *Chatbar*, then click !images/add_room_button.png|width="14mm" fo:scalefit="1" html:scalefit="0"! from the pop-up menu.

!images/pop_up_menu.png|align="center" width="60mm" fo:scalefit="1" html:scalefit="0"!

{docbook}
<para>The <guilabel>New Room</guilabel> form will appear.</para>
{docbook}

!images/new_room-form.png|align="center" width="100mm" fo:scalefit="1" html:scalefit="0"!

{docbook}
<para>
          <emphasis role="bold">2.</emphasis> Enter the room name in the <guilabel>Name</guilabel> field without any spaces, then click <guibutton>OK</guibutton> to accept adding your new room.</para>
{docbook}

{docbook}
<para>After that, the <guilabel>Conversation</guilabel> window and <guilabel>Room Configuration</guilabel> form appears.</para>
{docbook}

{docbook}
<para>
          <emphasis role="bold">3.</emphasis> Configure your chat room to your desires, including <guilabel>General</guilabel> and <guilabel>Security</guilabel> settings. <anchor id="Configure_your_chat_room"/> </para>
{docbook}

{docbook}
<note>
<para>
If you cancel this step, the default configuration will be used.
</para>
</note>
{docbook}

{docbook}
<para>
<emphasis role="bold">i.</emphasis> Set the <guilabel>General</guilabel> settings. <anchor id="Set_the_general_settings"/>
</para>
{docbook}

!images/Chat_room_configuration_general.png|align="center" width="100mm" fo:scalefit="1" html:scalefit="0"!

*Details:*

{docbook}
<informaltable>
          <tgroup cols="2">
            <thead>
              <row>
                <entry>Field</entry>
                <entry>Description</entry>
              </row>
            </thead>
            <tbody>
              <row>
                <entry>
                  <guilabel>Persistent Room</guilabel>
                </entry>
                <entry>Tick the checkbox if you want to set your room always exist even if no participant takes part. </entry>
              </row>
              <row>
                <entry>
                  <guilabel>Presence Broadcast</guilabel>
                </entry>
                <entry>By default, a room is configured without any invisible members. In this field, you can select any groups (Moderator, Participant, and Visitor) to be visible or not. Moderator is the user who has created the room or a participant who is granted the moderation right. If you want users of one group are hidden in the room, simply unselect the group. For example, if you only select the <emphasis role="bold">Participant</emphasis> and <emphasis role="bold">Visitor</emphasis> groups, users who are moderators of this room will not appear in the participants list of the chat room. Users of the hidden group only take part as "listeners" who can supervise the whole conversation of this room, although users of other groups do not know their presence. </entry>
              </row>
              <row>
                <entry>
                  <guilabel>Who is</guilabel>
                </entry>
                <entry> Specific users from the selected group in the <emphasis role="bold">Presence Broadcast</emphasis> field. At present, there is only the "anyone" option. </entry>
              </row>
              <row>
                <entry>
                  <guilabel>Room Description</guilabel>
                </entry>
                <entry>The brief description of the chat room.</entry>
              </row>
              <row>
                <entry>
                  <guilabel>Max Users</guilabel>
                </entry>
                <entry>The maximum number of participants in the chat room.</entry>
              </row>
            </tbody>
          </tgroup>
        </informaltable>
{docbook}

{docbook}
<para>
          <emphasis role="bold">ii.</emphasis> Set the <guilabel>Security</guilabel> settings. <anchor id="Set_the_security_settings"/>  </para>
{docbook}

{docbook}
<para>Click <guilabel>Show Security</guilabel> in the <guilabel>Room Configuration</guilabel> form to show the <guilabel>Security</guilabel> option.</para>
{docbook}

!images/room_configuration.png|align="center" width="100mm" fo:scalefit="1" html:scalefit="0"!

*Details:*

{docbook}
<informaltable>
          <tgroup cols="2">
            <thead>
              <row>
                <entry>Field</entry>
                <entry>Description</entry>
              </row>
            </thead>
            <tbody>
              <row>
                <entry>
                  <guilabel>Public Room</guilabel>
                </entry>
                <entry>When this option is checked, your room is listed in the chat rooms list for everyone to see and join this room.</entry>
              </row>
              <row>
                <entry>
                  <guilabel>Member Only</guilabel>
                </entry>
                <entry>Tick this option to limit the number of participants. It means that users need to be invited to participate in the room.</entry>
              </row>
              <row>
                <entry>
                  <guilabel>Allow Invitations</guilabel>
                </entry>
                <entry>This option is only available if the "Member Only" option is checked. If checked, the room's participants can invite others to join chat room.</entry>
              </row>
              <row>
                <entry>
                  <guilabel>Reserved Nickname</guilabel>
                </entry>
                <entry>Tick this option to prevent anonymous users from joining the chat room. If this option is checked, only registered users can enter the room.</entry>
              </row>
              <row>
                <entry>
                  <guilabel>Password Protected Room</guilabel>
                </entry>
                <entry>This option is to change the public room to a locked, secure protected room accessible only to specific individuals with the right password.</entry>
              </row>
              <row>
                <entry>
                  <guilabel>Moderated Room</guilabel>
                </entry>
                <entry>The room is moderated or not. With the moderated room, you can select the room administrators.</entry>
              </row>
              <row>
                <entry>
                  <guilabel>Room Admins</guilabel>
                </entry>
                <entry>This option is to select the administrators for the created chat room. It is only available when the <guilabel>Moderated Room</guilabel> option is selected. At present, there is no difference between the room moderator and regular participants.</entry>
              </row>
              <row>
                <entry>
                  <guilabel>Room Owners</guilabel>
                </entry>
                <entry>This option is to select the room's creator.</entry>
              </row>
            </tbody>
          </tgroup>
        </informaltable>
{docbook}

{docbook}
<para>
          <emphasis role="bold">4.</emphasis> Click <guibutton>OK</guibutton> to complete the room configuration.</para>
{docbook}


h2. Add people to a room {anchor:id="CSUser_guide.How_to_use_Chat.Add_contact_to_room}

This function is to add people to a chat room where you already participated.

*1.* Click !images/add_contact_to_chat_room_icon.png|width="13mm" fo:scalefit="1" html:scalefit="0"! on the chat room conversation window.

{docbook}
<para>The <guilabel>Add Contact</guilabel> form will appear:</para>
{docbook}

!images/add_contact_to_chat_room.png|align="center" width="120mm" fo:scalefit="1" html:scalefit="0"!

*2.* Select contacts you want to add by ticking their respective checkboxes.

Also, you can search for contacts through your *Address Book* simply entering the search term in the Search textbox. It can be the first name, last name or user name. All contacts matching the search term will be displayed in the results list.


{docbook}
<para>
  <emphasis role="bold">3.</emphasis> Click <guilabel>Add Contact</guilabel> to finish. The contacts you want to add will receive your invitation message.</para>
{docbook}

h2. Join/Leave a chat room {anchor:id="CSUser_guide.How_to_use_Calendar.Join_Leave_chat_room"}

{docbook}
<para xml:id="CSUser_guide.How_to_use_Chat.Join_chat_room">
<citetitle>
<emphasis role="bold">Join a chat room</emphasis>
</citetitle>
</para>
{docbook}

When joining a chat room, you can learn more about a subject, ask questions and talk with others having common interests. Joining a chat room is just few clicks away.

*1.* Click !images/chat_icon.png|width="4mm" fo:scalefit="1" html:scalefit="0"! on the Chatbar, then select !images/join_room_icon.png|width="13mm" fo:scalefit="1" html:scalefit="0"! from the drop-down menu.

{docbook}
<para>The <guilabel>Join Room</guilabel> form will appear.</para>
{docbook}

!images/join_room_form.png|align="center" width="120mm" fo:scalefit="1" html:scalefit="0"!

*2.* Select a room in the list by checking the appropriate radio button.
{docbook}
<para>
   <emphasis role="bold">3.</emphasis> Click <guilabel>Join Room</guilabel> to join the selected room. Click the <guibutton>Refresh</guibutton> button if you want to clear the selected rooms.</para>
{docbook}

{docbook}
<note>
    <para>
    You can join several chat rooms at the same time. Each chat room will be displayed in its own tab and you can easily switch between different rooms.
    </para>
</note>
{docbook}

{docbook}
<para xml:id="CSUser_guide.How_to_use_Calendar.Leave_chat_room">
<citetitle>
<emphasis role="bold">Leave a chat room</emphasis>
</citetitle>
</para>
{docbook}

Click !images/leave_room_icon.png|width="13mm" fo:scalefit="1" html:scalefit="0"! on the room conversation window.

!images/room_conversation_window.png|align="center" width="120mm" fo:scalefit="1" html:scalefit="0"!

Your conversation window of this room will be closed and you will not receive messages from the chat room any more.

h2. Configure a chat room {anchor:id="CSUser_guide.How_to_use_Chat.Configure_chat_room}
When creating a chat room, you are required to configure it before you can start the chat room conversation. However, after the chat room was created, you can also update the room configuration at any time.

{docbook}
<para>
            <emphasis role="bold">1.</emphasis> Click <inlinemediaobject>
              <imageobject role="fo">
                <imagedata fileref="images/chat_options_icon.png" format="PNG" scalefit="1" width="13mm"/>
              </imageobject>
              <imageobject role="html">
                <imagedata fileref="images/chat_options_icon.png" format="PNG" scalefit="0" width="13mm"/>
              </imageobject>
            </inlinemediaobject> in the <guilabel>Conversation</guilabel> form of the chat room.</para>
{docbook}

*2.* Set values for the fields in this form. For more details, see [here|#Configure_your_chat_room].

{docbook}
<note>
    <para>
    The chat room configuration is available only if you are the owner or administrator of the chat room. You can change the room owner and select the room administrator in the <link linkend="Set_the_security_settings">Set the Security settings</link> section.
    </para>
</note>
{docbook}
