* 가가 채팅(Gaga Chat)
- 홈페에지, 블로그, 게시판, 등 HTML 가능한 어디에든 방문자들이 실시간 채팅을 나눌 수 있습니다.
- 제로보드 4, 제로보드 5, 그누보드, 드루팔 , 등의 회원 시스템과 연동 가능합니다.
- 접속하자 마자 방 이름에 따라 즉시 새로운 채팅방이 생성되며, 한 방에 동시 접속자 최대 1,500명 접속 가능합니다.
기본 사용방법(빨간색 부분만 수정하면 됩니다):
호환성 위해 되도록 방이름은 영문으로 적어주시길 바랍니다.
HTML에 삽입하기
<embed height="200" width="90%" src="http://www.gagalive.kr/livechat1.swf?chatroom=원하는방이름"></embed>
홈페이지에 간단하게 프레임 자동 생성 방법
http://go.gagalive.kr/홈페이지주소
Daum 블로그, Daum 카페, 티스토리, 네이버 블로그 삽입 설명 (회원 시스템 연동은 불가능)
채팅방 끝이 ! 로 끝나면 최근 대화 기록이 남지 않습니다.(보안 채팅방도 마찬가지이며, 보안 채팅방을 ! 로 끝나게 신청을 해야 합니다)
고급 보안 채팅방 사용방법(회원 연동 채팅방):
보안 채팅방 생성하기/관리하기
제로보드 XE, XE(XpressEngine) 가가 채팅 위젯
제로보드 4 및 그누보드 4 가가 채팅 연동 예제
오피(ohpy.com)에서 연동하는 방법
테크노트 채팅 연동 예제
Drupal 4/5/6 가가 채팅 연동 예제
웹게임 연동 예제 (Perl: 베네치아, 배틀로얄, EBS, 건담 택틱스, PHP: HOF)
보안 채팅방에 대한 기본 설명:
보안 채팅방은 제로보드 4, 제로보드 XE, 그누보드, 드루팔 등 회원 시스템과 연동할 수 있는 채팅 시스템입니다.
연동 될 경우 사용자가 로그인하면 회원 시스템의 아이디 또는 닉네임에 따라 채팅방의 대화명이 고정됩니다.
채팅방 연동은 one way 암호화 기법을 사용하기 때문에 "해킹"의 염려가 없이 안전하게 연동되며, 사용자 임의로 아이디를 변경해서 사칭 등의 행위가 불가능해집니다.
사용하기 전에 위 링크를 이용해서 보안 채팅방을 생성하고 채팅방 보안키를 받으셔야 합니다.
보안 채팅방 일반적인 사용 방법:
보안 채팅방 생성 후,
~으로 시작하는 방이름은 익명 대화 허용, 익명 대화명 변경 불가능.
~~으로 시작하는 방이름은 익명 대화 비허용, 익명 대화명 변경 불가능.
~~~으로 시작하는 방이름은 익명 허용, 익명 대화명 변경 허용, 로그인시 대화명 앞에 + 표시.
보안방이름에 ~를 포함한 방이름을 적어주시길 바랍니다.
우선 로그인 상태인 사용자가 아닌 경우에는 HTML로
<embed height="200" width="90%" src="http://www.gagalive.kr/livechat1.swf?chatroom=보안방이름"></embed>
하면 익명 사용자가 채팅방에 접속하게됩니다. 이 경우 보안방이름이 ~, ~~, 또는 ~~~ 으로 시작하느냐에 따라 익명 사용자의 대화가 허용 또는 비허용됩니다.
유저가 로그인 했을 경우에는
<embed height="200" width="90%" src="http://www.gagalive.kr/livechat1.swf?chatroom=보안방이름&user=사용자아이디&encrypt=유저키"></embed>
하면 사용자아이디의 고정된 대화명으로 채팅방에 접속합니다.
일반 사용자 유저키는 md5(md5(사용자아이디 + 채팅방보안키) + 채팅방보안키) 로 생성하면 됩니다. 사용자아이디에는 접속시 고정될 대화명을 입려하면됩니다(인코딩: UTF-8). 참고로 보안 이유 때문에 사용자아이디는 스페이스나 |, *,+ 문자는 허용되지 않습니다. 채팅방 관리자인 경우 관리자 유저키를 md5(md5(일반 사용자 유저키 + 채팅방보안키) + 채팅방보안키) 로 생성하면 됩니다.
채팅방 관리자로 접속하면 아이디 앞에 * 이 생깁니다.
채팅방에서 사용 가능한 명령어 및 관리 명령어는 다음 링크를 참고하시길 바랍니다:
http://www.gagalive.kr/live/?document_srl=324846&mid=faq
유저키 생성 php 소스코드 예제
function userKey($user) {
$roomKey = "여기에 채팅방 보안 키 입력";
return md5(md5($user . $roomKey) . $roomKey);
}
$user는 UTF-8 인코딩을 사용하기 때문에 일반적인 euc-kr 를 사용하는 경우
$user = iconv("EUC-KR", "UTF-8", $user);
로 UTF-8로 변환하시길 바랍니다.
채팅방 관리자 유저키 생성 php 소스코드 예제
userKey(userKey($user));
HTML에 출력하기 전에 urlencode를 하는것도 권장합니다.
$htmluser = urlencode($user);
보안 채팅방을 프레임에 사용하기:
보안 채팅방을 채팅방이 있을 프레임 HTML에
<embed height="200" width="90%" src="http://www.gagalive.kr/livechat1.swf?chatroom=보안방이름"></embed>
입력하면 익명 사용자가 채팅방에 접속하게됩니다.
로그인 후에 다른 프레임에서
<embed height="0" width="0" src="http://www.gagalive.kr/livechat1_login.swf?chatroom=보안방이름&user=사용자아이디&encrypt=유저키"></embed>
를 부르면 자동으로 프레임의 전환 없이 채팅방이 사용자 아이디로 로그인하게 됩니다.
예제) 프레임chat: livechat1.swf(익명) -> 프레임top: 제로보드 -> 프레임top: 제로보드 로그인 후 에 livechat1_login.swf -브라우저 내부에서 메세지 통신됨-> 프레임chat: 새로고침 없이도 자동으로 livechat1.swf에서 로그인됨
예제 사이트) http://www.gagax.com
기타 채팅방 옵션
옵션은 chatroom=원하는방이름 뒤에 &옵션=옵션값 형태로 사용하면 됩니다. 모든 값은 UTF-8 입니다.
옵션: fontlarge
옵션값: small, medium, large
설명: 채팅방의 기본 폰트 크기를 조절합니다. 빈 값일 경우 사용자의 설정에 따라 달랍니다. 기본 사용자 설정은 small입니다.
사용 예) http://www.gagalive.kr/livechat1.swf?chatroom=원하는방이름&fontlarge=true
옵션: position
옵션값: 1, 2, 비어 있으면 자동 조절 (기본값)
설명: 1인 경우 채팅방 가로 형태, 2인 경우 채팅방 세로 형태, 옵션을 주지 않으면 채팅방 모양에 따라 자동 조절됩니다.
사용 예) http://www.gagalive.kr/livechat1.swf?chatroom=원하는방이름&position=2
옵션: user
옵션값: 대화명 이름
설명: 설정되면 채팅방 창에서 변경할 수 없으나, 보안 채팅방과 달리 직접 채팅방에 접속해서 변경은 가능함
추가 설명: livechat1.swf 말고 livechat2.swf 를 사용하면 익명 대화를 허용하지 않으나 보안이 없어 지식이 조금만 있어도 인위적으로 대화명을 쉽게 변경할 수 있습니다. 보안 연동을 위해서는 보안 채팅방을 이용하면 됩니다.
사용 예) http://www.gagalive.kr/livechat1.swf?chatroom=원하는방이름&user=digirave
옵션: fonttype
옵션값: font-family
설명: 채팅방의 폰트를 변경합니다
사용 예) http://www.gagalive.kr/livechat1.swf?chatroom=원하는방이름&fonttype=굴림체
옵션: fontcolor
옵션값: hex color code (#xxxxxx)
설명: 채팅방의 폰트 색깔을 변경합니다.
사용 예) http://www.gagalive.kr/livechat1.swf?chatroom=원하는방이름&fontcolor=00000
사용 예) http://www.gagalive.kr/livechat1.swf?chatroom=원하는방이름&fontcolor=black
옵션: bgcolor
옵션값: hex color code (#xxxxxx)
설명: 채팅방의 배경 색깔을 변경합니다.
사용 예) http://www.gagalive.kr/livechat1.swf?chatroom=원하는방이름&bgcolor=FFFFFF
사용 예) http://www.gagalive.kr/livechat1.swf?chatroom=원하는방이름&bgcolor=white
옵션: link
옵션값: 0, 1, 비어 있으면 1 이 기본 값
설명: http:// 로 시작하는 링크를 클릭 가능하게 자동 변환
사용 예) http://www.gagalive.kr/livechat1.swf?chatroom=원하는방이름&link=0
옵션: autofocus
옵션값: true, false(기본값)
설명: 채팅방에 새로운 대화가 있거나 누가 입장/퇴장시에 채팅방이 있는 페이지가 앞에 나오게 됨(focus).
사용 예) http://www.gagalive.kr/livechat1.swf?chatroom=원하는방이름&autofocus=true
옵션: notify
옵션값: true, false(기본값)
설명: 접속자가 채팅방에 입장/퇴장시에 대화창에 표시됨.
사용 예) http://www.gagalive.kr/livechat1.swf?chatroom=원하는방이름¬ify=true
참고로 autofocus, notify 사용시에 embed tag에 다음과 같이 AllowScriptAccess가 지정되어야 합니다.
<embed ... AllowScriptAccess="always"></embed>
Autofocus, notify 사용시에 Adobe사 제품에서 자동 생성 되는 HTML이나 제 사이트에 있는 예제 소스 코드에 있는 다음 자바스크립트 부분도 수정해야합니다.
AC_FL_RunContent(
...
"AllowScriptAccess", "always",
...
);
채팅방 즉시 사용방법
즉시 생성 방법 1
http://go.gagalive.kr/홈페이지주소 (세로형)
즉시 생성 방법 2
http://go.gagalive.kr/a/홈페이지주소 (가로형)
즉시 생성 방법 3
http://go.gagalive.kr/c/chatroom=채팅방이름(보안채팅방의 경우~포함)/홈페이지주소 (세로형)
즉시 생성 방법 4
http://go.gagalive.kr/cc/chatroom=채팅방이름(보안채팅방의 경우~포함)/홈페이지주소 (가로형)
즉시 생성 방법 5
http://go.gagalive.kr/d/채팅방이름보안채팅방의 경우~포함) (전체 화면)
채팅방 내에서 사용 가능한 명령어
/도움말
/글씨 크게
/글씨 작게 (기본값임)
/개인메세지 (아이디) (메세지)
/개인대화신청 (아이디)
/접속자 - 접속자 수 보기
/지우기 - 대화창 내용 지우기
모든 명령어는 접속자 목록 또는 대화창에서 아이디를 클릭한 후, 밑에 메세지 입력하는 칸에 오른쪽 클릭하면 메뉴를 이용해서 사용할 수 있습니다. 관리자로 로그인되어 있는 경우에는 관리자용 메뉴가 추가로 더 나타납니다.
채팅방의 한 방의 동시 접속자 수에 따른 작동
- 한 방에 동시 접속자 500명 이하에서는 옆에 실시간으로 접속자 목록이 표시됩니다. 한 방에 접속자 500명 초과할 경우 접속자 목록이 생략된 간략한 채팅방이 나옵니다.(그럴 경우 /접속자로 접속자 수를 조회할 수 있습니다) 한 방에 접속자 1,000명 초과할 경우 새로운 채팅방이 추가로 자동 생성되며 새로 접속되는 분들은 그 쪽으로 접속하게 됩니다.
보안 없이 간편하게 채팅방 회원 연동 방법(익명 사용자 대화 비허용):
익명 사용자는
<embed height="200" width="90%" src="http://www.gagalive.kr/livechat2.swf?chatroom=원하는방이름"></embed>
로 접속하게 되면 익명으로 접속하게 되고 대화가 허용되지 않습니다.
회원 사용자는
<embed height="200" width="90%" src="http://www.gagalive.kr/livechat2.swf?chatroom=원하는방이름&user=사용자아이디"></embed>
로 접속하게 되면 사용자아이디로 로그인하게됩니다.(별도 보안 없음)
프레임 사용시 회원 시스템과 연동하기(보안 없음):
보안 채팅방을 채팅방이 있을 프레임 HTML에
<embed height="200" width="90%" src="http://www.gagalive.kr/livechat2.swf?chatroom=원하는방이름"></embed>
입력하면 익명 사용자가 채팅방에 접속하게됩니다.
로그인 후에 다른 프레임에서
<embed src="http://www.gagalive.kr/livechat2_login.swf?chatroom=원하는방이름&user=사용자아이디"></embed>
를 부르면 자동으로 프레임의 전환 없이 채팅방이 사용자 아이디로 로그인하게 됩니다.
예제) 프레임chat: livechat2.swf(익명) -> 프레임top: 제로보드 -> 프레임top: 제로보드 로그인 후 에 livechat2_login.swf -브라우저 내부에서 메세지 통신됨-> 프레임chat: 새로고침 없이도 자동으로 livechat2.swf에서 로그인됨