GagaLive - LiveChat

* LiveChat
- Add a chat room anywhere HTML is allowed, such as your homepage, blog, forum, etc
- Flexible API using secure chat room allows chat room nickname linkage to your membership system(drupal, phpBB, vBulletin, etc)
- Because the service is provided on our servers, you will notice no additional traffic or server load

Basic usage(Modify red areas):
For maximal compatibility use only alphanumeric characters for the chat room name.
Insert into HTML:
<embed height="200" width="90%" src="http://en.gagalive.com/livechat1.swf?chatroom=ChatroomName"></embed>
Automatic homepage frame creation with chat room:
http://go.gagalive.com/HomepageAddress

If the chat room name ends with an !, the recent chat log will not be shown(This is the same for secure chat rooms, but you must create the secure chat room with an ! at the end)

Usage of advanced secure chat room(member linkage chat room):
- Create/manage secure chat room
- See MOD for phpBB2
- See MOD for phpBB3
- See source code example for vBulletin
- See source code example for Drupal 4/5 CMS
- See generic PHP source code example for membership linkage

Basic explanation of secure chat room:
Secure chat rooms are chat rooms that you can link to your homepage membership system so that when users log into your homepage the nick of the chat room is changed to the members id or nick in the membership system.
Before you use a secure chat room, you must create one using the link above and receive an authorization key.
The chat room API uses one way encryption techniques so there is no worry about getting "hacked"

Basic usage of secure chat room:
After creating a secure chat room,
the chat room that starts with @ allows anonymous chat, disallows anonymous nick change.
the chat room that starts with @@ disallows anonymous chat, disallows anonymous nick change
the chat room that starts with @@@ allows anonymous chat, allows anonymous nick change, logged in users have + prepended to nick
Always use the full chat room name including the @ characters.
For users that are not logged in, use the following HTML code:
<embed height="200" width="90%" src="http://en.gagalive.com/livechat1.swf?chatroom=SecureChatroomName"></embed>
and users will connect as an anonymous user. In this case according to whether the chat room starts with @, @@, or @@@ anonymous users will or will not be allowed to chat.
For users that are logged use:
<embed height="200" width="90%" src="http://en.gagalive.com/livechat1.swf?chatroom=SecureChatroomName&user=UserID&encrypt=UserKey"></embed>
and they will be logged in using nick UserID, they will not be able to change this as this is done securely using the UserKey.

Create the UserKey using the following algorithm:
  md5(md5(UserID+ AuthorizationKey) + AuthorizationKey)
You receive the AuthorizationKey when you create the secure chat room and can see it again when you login after clicking on the create/manage secure room link. Due to security reasons spaces, |, *, + characters are not allowed in the UserID. For the chat room adminstrator create the UserKey using the following algorithm:
  md5(md5(md5(UserID+ AuthorizationKey) + AuthorizationKey))
When logged in as a chat adminstrator if you send BANIP to a user as a message their IP will be banned for several hours. To clear all banned IPs send a message to yourself(or any user) as CLEARIP. To temporarily give chat administration access to another user send them a message as GIVEOP, and to take back administration access send TAKEOP. If you wish the recent chat log send a message to yourself(or any user) as CLEARLOG.
Note that if the chat room is empty, the chat room is deleted and the IP ban list is also reset.

Example PHP source code to create the UserKey:
function userKey($user) {
$roomKey = "Enter the secure chat room authorization key here";
return md5(md5($user . $roomKey) . $roomKey);
}

Example PHP source code to create the UserKey for chat room administrators:
md5(userKey($user));

To use a secure chat room inside a frame:
Put the following HTML in the frame the chat room will be in:
<embed height="200" width="90%" src="http://en.gagalive.com/livechat1.swf?chatroom=SecureChatroomName"></embed>
The user will initially be connected as an anonymous user. After the user logs in another frame use the following HTML from that frame:
<embed height="0" width="0" src="http://en.gagalive.com/livechat1_login.swf?chatroom=SecureChatroomName&user=UserID&encrypt=UserKey"></embed>
Afterwards the users nickname will automatically change in the chat room frame without refreshing the frame.
Example) ChatFrame: livechat1.swf(anonymous user) -> TopFrame: DrupalCMS -> TopFrame: user logs into drupal livechat2_login.swf is displayed -internal communcation within browser-> ChatFrame: automatic change of nick without frame refresh

Other chat room options
All options can be applied after the chatroom=ChatRoomName as &option=optionValue. All values are UTF-8 encoded.

Option: fontlarge
Option value: small, medium, large
Explanation: Change the font size of chat room. If not specified the chat room follows the user settings which is by default small.
Example) http://en.gagalive.com/livechat1.swf?chatroom=ChatroomName&fontlarge=true

Option: position
Option value: 1(Default), 2
Explanation: 1is horizontal oriented chatroom, 2 is vertical oriented(sidebar style) chatroom.
Example) http://en.gagalive.com/livechat1.swf?chatroom=ChatroomName&position=2
Site example) http://go.gagalive.com/kmle.com

Option: user
Option value: nickname
Explanation: If specified user cannot change their nicks, but this is not a secure way of preventing nick changes.
Note: when using livechat2.swf instead of livechat1.swf anonymous chat is not allowed but with only minimal knowledge a user could easy just use livechat1.swf to change their nick.
Example) http://en.gagalive.com/livechat1.swf?chatroom=ChatroomName&user=digirave

Option: fonttype
Option value: font-family
Explanation: change the chat room font.
Example) http://en.gagalive.com/livechat1.swf?chatroom=ChatroomName&fonttype=Arial

Option: fontcolor
Option value: hex color code (#xxxxxx)
Explanation: Change the chat room font color.
Example) http://en.gagalive.com/livechat1.swf?chatroom=ChatroomName&fontcolor=#00000
Example) http://en.gagalive.com/livechat1.swf?chatroom=ChatroomName&fontcolor=black

Option: bgcolor
Option value: hex color code (#xxxxxx)
Explanation: Change the chat room background color.
Example) http://en.gagalive.com/livechat1.swf?chatroom=ChatroomName&bgcolor=#FFFFFF
Example) http://en.gagalive.com/livechat1.swf?chatroom=ChatroomName&bgcolor=white

Instant frame automatic homepage frame creation with chat room
Method 1
http://go.gagalive.com/a/HomepageAddress (Horizontal)
Method 1
http://go.gagalive.com/HomepageAddress (Vertical/sidebar style)

Commands available in chat room
  /help
/font large
/font small (Default)
/msg (userid) (message to send)
/online - number of occupants in chat room
/clear - clear chat room screen

Maximum occupants in single chat room
- When less than 200 users are in the same chat room the user connected list is shown and updated in real time. When over 200 users are in the same chat room the chat room converts to simple display mode and does not show the user connected list anymore(in this case you may use the /online command to see how many users are in the chat room). When over 500 users are in the same chat room an alternative chat room is made automatically with newer connections transfered to it.

Membership linkage in a insecure way(disallowing anonymous chat):
Anonymous users are connected with the following HTML:
<embed height="200" width="90%" src="http://en.gagalive.com/livechat2.swf?chatroom=ChatroomName"></embed>
any they will not be able to chat.
Logged in users should be connected with the following HTML:
<embed height="200" width="90%" src="http://en.gagalive.com/livechat2.swf?chatroom=ChatroomName&user=UserID"></embed>
and thay will automatically be connected with the nickname UserID(nonsecure method)

Using frames with membership linkage(Insecure method):
Put the following HTML in the frame the chat room will be in:
<embed height="200" width="90%" src="http://en.gagalive.com/livechat2.swf?chatroom=ChatroomName"></embed>
The user will initially be connected as an anonymous user. After the user logs in another frame use the following HTML from that frame:
<embed src="http://en.gagalive.com/livechat2_login.swf?chatroom=ChatroomName&user=UserID"></embed>
Afterwards the users nickname will automatically change in the chat room frame without refreshing the frame.
Example) ChatFrame: livechat2.swf(anonymous user) -> TopFrame: DrupalCMS -> TopFrame: user logs into drupal livechat2_login.swf is displayed -internal communcation within browser-> ChatFrame: automatic change of nick without frame refresh