The Chatbox Hitskin_logo Hitskin.com

This is a Hitskin.com skin preview
Install the skin • Return to the skin page

The forum of the forums
Would you like to react to this message? Create an account in a few clicks or log in to continue.
The forum of the forums

    The Chatbox

    Caihlem
    Caihlem
    Caihlem
    Energetic


    Male Posts : 8969
    Reputation : 342
    Language : English, French & Female
    Location : You can't fly like the phenix
    • Post n°1

    The Chatbox Empty The Chatbox

    Post by Caihlem March 26th 2007, 3:12 am

    The Chatbox


    A ChatBox, is one of many ways of communicating, chatting with the members of your forum. ChatBox is to some extent, a software of instant communication (Msn Messenger) integrated into your forum. The ChatBox present on your forum, uses AJAX "technologies" (Asynchronous JavaScript And XML).

    Activate the ChatBox

    "Administration Panel / Modules / Chatbox / Configuration" (The Chatbox Chatbox) >> Activate the Chatbox: YES

    Deactivate the ChatBox

    "Administration Panel / Modules / Chatbox / Configuration" (The Chatbox Chatbox) >> Activate the Chatbox: NO


    Locations of the ChatBox

    In the configuration of the ChatBox, you have the choice of several places where you can have your ChatBox: do not display, Top of the home page, Bottom of the home page.

    Do not Dsiplay:
    Your ChatBox wil be availiable in the Who's Online area under a link/pop-up
    The Chatbox Chatbo10
    *No matter where the ChatBox is located, this will be also available under a link/popup in the Who's online, like on this screen above

    Top of the Home Page:
    Your ChatBox will be availiable on the top of your home page

    Bottom of the Home Page:
    Your ChatBox will be availiable at the bottom of your Home Page. Under the Who's Online block and on top of the Legends

    On the Portal:
    First of all you must activate the ChatBox (Whether you choose you display it or not, it doesn't change anything) so you will have it in your existing modules in the portal. Then :

    "Administration Panel / Modules / Portal Management / Structure" (The Chatbox Portail) Arrow Adding of existing modules Arrow select the "ChatBox" module Arrow Select its location Arrow Add the module

    Alternatively, you can simply drag and drop the chatbox widget.

    -------------------

    Configuration of the location
    The Chatbox Chatbo11

    ChatBox on the portal
    The Chatbox Chatbo12


    Commands of the ChatBox

    These following commands must be typed in the "message" field, as if you were posting a message :

    Erase messages:
    You simply have to write
    Code:
    /clear
    or
    Code:
    /cls

    A confirmation message should appear:
    The Chatbox Chatbo13

    Ban a User: (from the ChatBox)
    You simply have to write
    Code:
    /ban USER
    You have to change USER by the name of the user.
    The user will then not see the ChatBox, like guests. (The ChatBox is reserved for members)

    A confirmation message should appear:
    The Chatbox Chatbo14
    (sorry onii-chan The Chatbox Mr2fl)

    Unban a User: (from the ChatBox)
    You simply have to write
    Code:
    /unban USER
    You have to replace USER by the users name

    A confirmation message should appear:
    The Chatbox Chatbo15
    (here, onii-chan forgives me ^^)

    It is also possible to unban users from the ChatBox via this path:
    "Administration Panel / Modules / Chatbox / Banned Users"

    The Chatbox Chatbo16

    It is also possible to unban a list of banned users (see below)

    * Users banned from the ChatBox are not banned from your forum

    Making a member a moderator of the Chatbox
    You simply have to write
    Code:
    /mod USER
    You have to replace USER by the users name

    A confirmation message should appear:
    The Chatbox Chatbo17
    (onii-chan is happy The Chatbox Icon_mrgreen)

    Removing the moderator rights from a member of the Chatbox
    You simply have to write
    Code:
    /unmod USER
    You have to replace USER by the users name

    A confirmation message should appear:
    The Chatbox Chatbo18
    (onii-chan is angry now Razz)

    It is also possible to give moderation rights to a member via :

    "Administration Panel / Modules / Chatbox / Moderators" (The Chatbox Chatbox)

    You will find the username of the members who have moderation rights on the ChatBox, a button leading to their profile, a button to send them a private message (PM), and finally a checkbox to tick to remove the moderation rights from them.

    The Chatbox Chatbo19

    Exclamation Users having the moderation rights on your forum do NOT automatically have them for the chatbox and vice versa
    Exclamation Admins are automatically mods of the chatbox and cannot have their rights withdrawn

    Access to the banlist
    You simply have to type
    Code:
    /banlist

    This following popup window will open

    The Chatbox Chatbo20

    Then it will be possible to :
    Arrow look at the member's profile
    Arrow Unban a banned member

    Writing a message to the 3rd person
    You simply have to write
    Code:
    /me message

    A confirmation message should appear:
    The Chatbox Chatbo21

    Kicking a member from the chatbox
    You simply write
    Code:
    /kick USER
    You have to replace USER by the users name

    Then the member will be immediately disconnected from the CharBox. Take notice that he can log-in back after. If the member tends to not respect the rules, use the ban command.

    [12:04:32]Max--- has been kicked by Ishimaru Chiaki

    Leaving the ChatBox

    This feature can be used only by members. It has the same effect than the /kick command. This means that this will log you out. Take notice that you can also use the "Log out" link on top of the chatbox page.

    You simply write
    Code:
    /exit

    A confirmation message should appear:
    [12:04:32] You are disconnected.[/b]

    Mark yourself as Away:
    You simply have to write

    Code:
    /away

    or

    Code:
    /abs


    This command will transfer you in the Away users block and a confirmation message should appear:
    [12:02:09] Ishimaru Chiaki is away

    You can also leave a message while putting yourslef on "Absent"
    You simply have to write

    Code:
    /away message

    or

    Code:
    /abs message


    A confirmation message should appear:
    [12:03:36] Ishimaru Chiaki is away : My cat stole my clothes !

    To get back to the "Online" members block, you just have to type one of the previous commands, click on "Refresh" or type a message.

    The Buttons of the ChatBox

    The Chatbox Chatbo10

    1. The refresh button allows you to manually refresh the ChatBox
    2. The checkbox Auto-refresh allows you to have the ChatBox automatically refreshed.
    3. The archives button allows you to see older posts (unless the messages have been cleared)
    4. The log-in/logout buttons is used to log-in or log-out from the ChatBox
    5. The button B allows you to put your text in bold format
    6. The button I allows you to put your text in italic format
    7. The button U allows you to underline your text
    8. The button S allows you to strike your text
    9. This button allows you to change the color of your text
    10. This button allows you to insert smilies in your texts.
    11. This is where you post the contents of your message
    12. This button allows you to change the height of your Chatbox.

    To type a complicated username The Chatbox Icon_mrgreen

    Have you already encontered this situation when you had to talk to a specific member, but you fainted at the idea to type his super-complicated username ? In this case, it's possible to do a copy-paste of the username, but there's a way which is even simpler. You just have to click on the username, in the Online/Absent column and/or where the messages are displayed.

    The right-click

    Right-clicking a member's username allows you to access to a few features :

    Arrow View the member's profile
    Arrow Send a PM to this member
    Arrow Show yourself as Away (a popup window will [Language] you to give a reason, it's up to you to fill in this field or not)
    Arrow Leave the ChatBox (a popup wiindow will ask you to give a reason, it's up to you to fill in this field or not)
    Arrow Kick a member (depends on the permissions)
    Arrow Ban a member (depends on the permissions)
    Arrow Give him the moderationi status (depends on the permissions)


    Mini-FAQ

    Who are the members with the @ ? These are members who can use the ChatBox moderation commands.

    Which are the rights of the Chatbox moderators ? the moderator members can clear the messages, kick and ban members from the CharBox. The Administrators can use these commands mentioned above, but they can also give and withdraw moderation status to a member.

    What is the ChatBox's capacity ? The ChatBox can store up to about 195 messages maximum

    I can't ban a member ? In most cases, it comes from the fact that the member to ban has moderation rights on the ChatBox. Remove them from this member then try again.

    The ChatBox is invisible/ There is a white frame / I don't see the ChatBox ? This comes from a Javascript cache memory problem. Just a Ctrl+F5 and/or a cleanup of the cache memory should solve the problem

    Arrow [url=LINK TO INSERT]Clear the cache memory and modifications not done[/url]

    I don't see some infos in the ChatBox such as logins/logoffs, kicks and bans of members this problem comes from the fact that you are viewing your ChatBox's archives. To have access to these infos, you just have to click on the "Without archives" link which is next to "Refresh", "Auto-refresh", etc.

    My parameters (bold, colors, etc.) aren't saved. These parameters are saved using Cookies, so make sure your browser accepts Cookies.

    Are the Chatbox ads disabled when I pay to have the ads removed on my forum? Yes, disabling the ads via the points management will also disable the ads in your ChatBox.

    Why am I disconnected after a refresh (F5) / Why aren't we automatically connected ?


    A technician wrote:This process is necessary. Otherwise, a person who comes on the homepage without wanting to use the ChatBox will see his page being regularly refreshed for nothing... This makes the servers, your machine, etc. work for nothing.

    Only the chatbox is refreshed, but this is using some database and then, sends requests, so this consumes server loading uselessly for some cases.

    So, when you access the homepage (or portal), the chatbox stays (and will stay) logged off.
    [i]
    Notice from Katt : I'm not sure about the accuracy of this quote translation, so you can PM me for corrections.

    ------------------

    This tutorial was written by mamboule.
    Translated by Caihlem
    Corrected and updated by Katt
    Updated by Sunny_D || 11. 07. '08

    • Back to top