미니톡

굵게, 기울임, 밑줄 등 툴바에 사용자 정의 버튼을 추가할 수 있습니다. 툴바영역을 벗어나는 버튼에 대해서는 MORE 버튼을 통해 숨겨지고 해당 버튼을 클릭하여, 벗어나는 버튼목록을 볼 수 있습니다.

Object tool[] 의 형태로 정의되어 집니다. (예제소스 참조)

Object tool - 툴바버튼의 객체가 정의됩니다.

icon:String - 버튼아이콘의 전체경로를 정의합니다.
text:String - 버튼이름을 정의합니다.
viewText:Boolean - toolType 변수의 값이 "icon"일 때라도 버튼이름을 보일지 여부를 정의합니다. (true 일 경우 toolType 값과 관계없이, 버튼이름도 함께 출력합니다.)
fn:Function - 버튼이 클릭했을 때의 액션을 함수로서 정의합니다.

new Minitalk({
    // 생략
    addToolList:[
        {
            icon:"http://www.yourdomain.com/icon.gif",
            text:"홈페이지이동",
            viewText:true,
            fn:function(minitalk) {
                minitalk.printMessage("system","홈페이지로 이동합니다.");
                window.open("http://www.minitalk.kr");
            }
        },{
            // 생략
        }
    ],
    // 생략
});

info 변수값 등을 활용하여, 접속유저의 닉네임을 클릭했을 때 나타나는 유저메뉴를 추가할 수 있습니다.
Object userMenu[] 형태로 배열로 등록하게 됩니다. (예제소스 참조)

Object userMenu - 하나의 메뉴에 대한 객체가 정의됩니다.

icon:String - 메뉴아이콘의 전체경로를 정의합니다.
text:String - 메뉴의 이름을 정의합니다.
viewMenu:Function - 해당메뉴가 출력되는 여부를 함수로서 정의합니다.
fn:Function - 메뉴를 클릭했을 때 액션을 함수로서 정의합니다.

new Minitalk({
	// 생략
	info:{homepage:"http://www.memberhomepage.com",email:"email@email.com"},
	addUserMenuList:[ 
		{
			icon:"http://www.yourdomain.com/homepage.gif",
			text:"유저홈페이지가기",
			viewMenu:function(minitalk,user,myinfo) {
				if (user.info.homepage) { // 홈페이지정보가 있을 때
					return true; // 이 메뉴를 보인다.
				} else {
					return false; // 정보가 없다면 메뉴를 숨긴다. 
				} 
			},
			fn:function(minitalk,user,myinfo) {
				window.open(user.info.homepage);
			} 
		},{
			// 생략 
		} 
	],
	// 생략
});

미니톡 관리자에서 생성한 채널의 이름을 설정합니다.

new Minitalk({
	channel:"example",
	// skip lines
});

개인채널등이나, 각종 미니톡 프로그램상에서 한글이 깨진다면, 이 변수값으로 홈페이지의 인코딩셋과 맞춰줄 수 있습니다.

기본값은 UTF-8 이며, 들어갈 수 있는 값은 EUC-KR, CP494, EUC-JP 등 홈페이지에서 사용중인 기본 인코딩값을 입력하시면 됩니다.

new Minitalk({
	channel:"example",
	encode:"EUC-KR",
	// skip lines
});

채팅글꼴 설정도구박스를 숨길지 보일지 설정할 수 있습니다.

true : 채팅글꼴 설정도구박스를 숨깁니다.
false : 채팅글꼴 설정도구박스를 숨기지 않습니다.

new Minitalk({
	channel:"example",
	fontSettingHide:true,
	// skip lines
});

미니톡의 세로크기를 픽셀단위 또는 퍼센트(가변)단위로 정의합니다.

퍼센트단위로 입력할 경우, 반드시 따옴표( " ) 로 묶은 뒤 입력하여야 정상동작 합니다.

new Minitalk({
    channel:"example",
    height:100,
    // skip lines
});

또는,

new Minitalk({
	channel:"example",
	height:"100%",
	// skip lines
});

공용클래스에서 호출하기 위한 현재의 미니톡객체를 가르키는 고유한 값을 지정합니다.

지정하지 않을경우, 랜덤한 값으로 자동으로 지정됩니다.
한페이지에 여러개의 미니톡을 설치할 경우, 이 값은 유일하여야 합니다.

new Minitalk({
	channel:"example",
	id:"MyMinitalk-1",
	// skip lines
});

해당정보는 User Object 의 info 라는 이름으로 정의되어 집니다.

new Minitalk({
	channel:"example",
	// skip lines
	info:{homepage:"http://www.memberhomepage.com",email:"email@email.com"},
	addUserMenuList:[ // example for user menu 
		{
			icon:"http://www.yourdomain.com/homepage.gif",
			text:"Go User Homepage",
			viewMenu:function(minitalk,user,myinfo) {
				if (user.info.homepage) { // If homepage exist,
					return true; // show this menu
				} else {
					return false; // hide this menu. 
				} 
			},
			fn:function(minitalk,user,myinfo) {
				window.open(user.info.homepage);
			} 
		},{
			// skip lines
		} 
	], 
	listeners:{ // example for event listener
		onConnect:function(minitalk,channel,user) { 
			minitalk.printMessage("system",user.nickname+" homepage is [ "+user.info.homepage+"]");
		}
	} 
});

language 변수를 통한 다국어를 지원합니다. 언어셋파일은 언어팩다운로드 메뉴에서 다운로드 받아 서버에 업로드 한 뒤 불러올 수 있습니다.

언어셋파일명의 영문 2글자가 설정값이 됩니다.

예) 한국어 : ko 영어 : en

new Minitalk({
	channel:"example",
	language:"en", // Used English
	// skip lines
});

이벤트핸들러 종류는 이벤트부분을 참고하여 주시기 바랍니다.

new Minitalk({
	channel:"example",
	// skip lines
	listeners:{
		onConnect:function() { },
		onJoin:function() { }
	}
});

채널에 사용자가 있고, 페이지이동등으로 채널에 재접속하였을 경우, 최근에 이루어진 대화를 설정한 값에 따라 (0 ~ 30 사이의 값) 불러오도록 설정합니다.

단, 채널에 사용자가 아무도 없을 경우, 최근에 이루어진 대화기록은 자동으로 삭제됩니다.

0으로 설정할 경우 이전대화기록을 불러오지 않습니다.

new Minitalk({
	channel:"example",
	logLimit:30, // show 30 lines log
	// skip lines
});

이미지닉네임의 이미지가 위치한 경로를 http:// 를 포함한 절대경로로 입력합니다.

회원시스템과의 연동이 필요없을 경우, 정의하지 않으시면 됩니다.
이미지닉네임을 2개이상 사용하거나(닉네임아이콘, 이미지닉네임), 특정아이콘과 함께 텍스트로 닉네임을 표현하고자 할경우 아래와 같이 콤마(,)로 구분하여 입력하시면 됩니다.

2가지 이미지를 출력할 경우

new Minitalk({
	channel:"example",
	nickcon:"http://yourdomain.com/img1.gif,http://yourdomain.com/img2.gif",
	// skip lines
});

닉아이콘과 함께 텍스트로 닉네임을 출력할 때

new Minitalk({
	channel:"example",
	nickcon:"http://yourdomain.com/img1.gif,{nickname}",
	nickname:"my nickname",
	// skip lines
});

해당 변수의 값이 있을 경우, 미니톡 접속시 회원권한을 획득하게 됩니다.

회원시스템과의 연동이 필요없을 경우, 정의하지 않으시면 됩니다.

new Minitalk({
	channel:"example",
	nickname:"My Nickname",
	// skip lines
});

해당 변수에 값이 존재할 경우, 해당회원은 설정한코드의 권한을 가지게 됩니다.

특정인에게만 관리자권한을 주기 위하여, 서버스크립트 언어의 IF문등을 활용하여, 정의합니다.
해당코드의 위변조를 통한 관리자권한획득을 방지하기 위하여, 특정규칙으로 암호화하여야 합니다.

<?php
$_MINITALK_KEY = '12345678123456781234567812345678'; // 미니톡 설치시 사용했던 32자리 KEY
  
function MiniTalkEncoder($value) {
	global $_MINITALK_KEY;
	
	$padSize = 16 - (strlen($value) % 16);
	$value = $value.str_repeat(chr($padSize),$padSize);
	$output = mcrypt_encrypt(MCRYPT_RIJNDAEL_128,$_MINITALK_KEY,$value,MCRYPT_MODE_CBC,str_repeat(chr(0),16));
	return base64_encode($output);
}
  
function MiniTalkDecoder($value) {
	global $_MINITALK_KEY;
	 
	$_MINITALK_KEY = $_MINITALK_KEY ? md5($_MINITALK_KEY) : md5($_CONFIGS->key);
	$value = base64_decode($value);
	$output = mcrypt_decrypt(MCRYPT_RIJNDAEL_128,$_MINITALK_KEY,$value,MCRYPT_MODE_CBC,str_repeat(chr(0),16));
	$valueLen = strlen($output);
	if ($valueLen % 16 > 0) return false;

	$padSize = ord($output{$valueLen - 1});
	if (($padSize < 1) || ($padSize > 16)) return false;

	for ($i=0;$i<$padSize;$i++) {
		if (ord($output{$valueLen - $i - 1}) != $padSize) return false;
	}
	
	return substr($output,0,$valueLen - $padSize);
}
  
function GetOpperCode($opper) {
	$value = json_encode(array('opper'=>$opper,'ip'=>$_SERVER['REMOTE_ADDR']));
	return urlencode(MiniTalkEncoder($value));
}
?>

PHP의 경우 위와 같은 방법으로 GetOpperCode 함수를 정의하여 사용하면 되며, 다른 언어의 경우에도 같은 암호화기법으로 정의하시면 됩니다.
특정언어에 대하여, 관리자코드를 생성하는 방법을 잘 모르실 경우, 문의게시판을 통해 문의하여 주시기 바랍니다.
관리자코드는 JavaScript나 Html으로는 만들 수 없으므로, 서버스크립트가 지원되지 않는 곳에서는 이 방법으로 관리자권한을 획득할 수 없습니다.

new Minitalk({
	channel:"example",
	<?php if ($isAdmin == true) { // For Administator ?>
	opperCode:"<?php echo GetOpperCode('ADMIN'); ?>",
	<?php } elseif ($isMember == true) { // For member ?>
	opperCode:"<?php echo GetOpperCode('MEMBER'); ?>",
	<?php } ?>
	// skip lines
}); 

설치된 플러그인중 사용할 플러그인을 배열로 지정을 하거나, 전부 사용 또는 전부 미사용하길 원한다면 아래의 키워드로 정의하세요.

ALL : 설치된 모든 플러그인사용
NONE : 플러그인 비활성화
또는 사용할 플러그인을 배열로 선택 배열에 들어가는 플러그인명은 plugin 폴더내의 각각의 플러그인들의 폴더명입니다.

전체 플러그인을 사용하고자 할 경우

new Minitalk({
	channel:"example",
	plugin:"ALL",
	// skip lines
});

일부 플러그인만 사용하고자 할 경우

new Minitalk({
	channel:"example",
	plugin:["googleSearch","chatHelper"], // used googleSearch & chatHelper plugin
	// skip lines
});

모든 플러그인을 사용하지 않을 경우

new Minitalk({
	channel:"example",
	plugin:"NONE",
	// skip lines
});

default : 스크립트가 있는 위치에 정해진 width, height 크기로 미니톡을 출력합니다.

그 외 아래 값으로 지정한 경우, 미니톡이 홈페이지 UI에 영향을 미치지 않고, 브라우져의 특정위치에 고정되어 스크롤바를 따라다닙니다.
유저가 미니톡 타이틀바를 클릭하면 채팅영역이 나타났다가, 미니톡 이외의 영역을 마우스클릭하면 다시 숨겨집니다.
(예제 미리보기 참조)

TL : 상단좌측에 미니톡에 타이틀바만 나타난채로 스크롤에 고정됩니다.
TR : 상단우측에 미니톡에 타이틀바만 나타난채로 스크롤에 고정됩니다.
BL : 하단좌측에 미니톡에 타이틀바만 나타난채로 스크롤에 고정됩니다.
BR : 하단우측에 미니톡에 타이틀바만 나타난채로 스크롤에 고정됩니다.

new Minitalk({
	channel:"example",
	position:"TL", // fixed position on top left
	// skip lines
});

position옵션을 TL, TR, BL, BR 으로 사용시 부가적인 옵션을 정의합니다.

Object positionOption

Boolean autoShow : 미니톡이 로드될때 숨겨진 상태가 아닌 확장된 상태로 보이게 합니다. (기본값 : false)

Boolean autoHide : 미니톡이 확장된 상태일때, 미니톡영역이 아닌 다른영역을 클릭시 자동으로 숨겨지도록 합니다. (기본값 true)

Boolean saveStatus : 미니톡의 숨김/확장상태를 기억하여 페이지를 새로고침하거나 다른페이지로 이동할 때 해당상태를 유지합니다. (IE8이하버전에서는 동작하지 않음) (기본값 : true)

int defaultHeight : 숨김상태일때 보일 높이값을 지정합니다. 미니톡 스킨의 타이틀영역만큼이 적당합니다. (기본값 26)

Boolean showCloseButton : 별도로 닫기버튼을 보입니다. (기본값 : true)

String closeButtonImage : 닫기버튼 이미지전체경로 (기본값 : 미니톡폴더/images/close.png)

int closeButtonWidth : 닫기버튼 이미지 가로크기 (기본값 : 24)

int closeButtonHeight : 닫기버튼 이미지 세로크기 (기본값 : 24)

new MiniTalk({
	channel:"example",
	position:"BR", // fixed position on bottom right
	positionOption:{
		autoShow:false,
		autoHide:ture,
		saveStatus:true,
		defaultHeight:26,
		showCloseButton:true,
		closeButtonWidth:24,
		closeButtonHeight:24
	},
	// skip lines
});

SendProtocol() 메소드를 이용해 전달되어지는 사용자 정의 프로토콜에 대한 이벤트리스너를 정의합니다.

Object

KEY : 프로토콜의 명칭입니다. SendProtocol() 메소드에서 보내는 프로토콜명

VALUE : 이벤트리스너 함수입니다. 미니톡과 프로토콜로 전달되는 데이터객체가 전달됩니다.

플러그인 또는 스킨 등 미니톡 외부에서 사용자정의 프로토콜 전송

// m is minitalk global value
m.sendProtocol("newpost",{nickname:"MyNickame",title:"This is Post Title."});
// Check "newpost" protocols on next example.

미니톡 내부에서 사용자정의 프로토콜 전송

new Minitalk({
	channel:"example",
	listeners:{
		onConnect:function(minitalk,channel,user) {
			// You can send custom protocol on event listeners
			minitalk.sendProtocol("sayhi",{nickname:user.nickname});
		}
	},
	protocols:{
		newpost:function(minitalk,data) {
			minitalk.printMessage("system",data.nickname+" posted ["+data.title+"]");
			// result : MyNickname posted [This is Post Title]
		},
		sayhi:function(minitalk,data) {
			minitalk.printMessage("system",data.nickname+" said Hi!");
		}
	},
	// skip lines
});

채널접속시 채널명과 함께 접속메세지를 보일지 설정합니다. 접속하고자 하는 채널명을 숨기고자 한다면, false 로 지정합니다.

new Minitalk({
	channel:"example",
	showChannelConnectMessage:false, // You can't see connect message.
	// skip lines
});

미니톡의 스킨코드를 정의합니다. 미니톡 스킨은 스킨다운로드 메뉴에서 가능하며, 스킨의 폴더명이 스킨명이 됩니다.

new Minitalk({
	channel:"example",
	skin:"kakaotalk", // Used kakaotalk skin
	// skip lines
});

채팅내용에서 닉네임과 대화내용을 구분하는 문자열을 지정합니다. 이 문자열을 이용하여 채팅내용을 구분합니다.

new Minitalk({
	channel:"example",
	splitString:" said, ",
	// skip lines
});

기본 :

SomeUser : Some Talk;

위의 예제를 적용할 경우 :

SomeUser said, Some Talk

미니톡의 상태아이콘(온라인, 자리비움, 다른용무중 등)의 경로를 지정합니다.

경로는 미니톡이 설치된 경로로부터 상대경로 또는 절대경로를 입력합니다.

해당경로에는 반드시 모든 디바이스별(PC, Android, iOS) 폴더내에 상태에 대한 아이콘이 다음과 같은 이름으로 존재하여야 합니다.

온라인 : online.png

오프라인 : offline.png

자리비움 : away.png

추모 : pray.png

다른용무중 : otherwork.png

삽질중 : working.png

new Minitalk({
	channel:"example",
	statusIconPath:"http://yourdomain.com/minitalk/images/status", // removed last slash("/")
	// skip lines
});

굵게, 기울임, 밑줄 등 툴바의 버튼의 형태를 정의합니다.

icon : 버튼의 아이콘만 표시합니다.

text : 버튼의 이름만 출력합니다. (굵게, 기울임, 밑줄 등)

icontext : 버튼의 아이콘과 함께 이름을 출력합니다.

new Minitalk({
	channel:"example",
	toolType:"icontext", // tool icon with button text
	// skip lines
});

미니톡의 형태를 결정합니다.

세로형은 접속자목록이 채팅내용 위에 표시되며 가로형은 접속자목록이 채팅내용 우측(또는 스킨에 따라 좌측)에 위치하게 됩니다.

horizontal : 가로형으로 설정합니다.

vertical : 세로형으로 설정합니다.

auto : 미니톡의 크기에 따라 자동으로 형태가 설정됩니다.

new Minitalk({
    channel:"minitalk",
    type:"horizontal", // Horizontal style
    // skip lines
});

유저목록 세로높이는 type이 vertical로 지정되었을 때 유저목록리스트의 세로폭을 지정합니다.

이 값은 %로 지정되지 않으므로 반드시 픽셀단위의 int 형식으로 지정하세요.

new Minitalk({
	channel:"example",
	type:"vertical",
	userListHeight:100,
	// skip lines
});

유저목록 가로넓이는 type이 horizontal로 지정되었을 때 유저목록리스트의 가로폭을 지정합니다.

이 값은 %로 지정되지 않으므로 반드시 픽셀단위의 int 형식으로 지정하세요.

new Minitalk({
	channel:"example",
	type:"horizontal",
	userListWidth:200,
	// skip lines
});

유저의 채널접속/접속종료 메세지를 보일 것인지 설정합니다.

기본적으로 true 로 설정되어 있으며, alertLimit 변수값에 의해 메세지를 출력할 유저의 권한을 정의합니다.

true : 채널접속/접속종료 메세지를 보임

false : alertLimit 변수와 무관하게 채널접속/접속종료 메세지를 보이지 않음

유저의 접속/종료 메세지를 특정권한이상의 유저의 접속/접속종료시에게만 나타나도록 설정합니다.

동시접속자가 많을 경우, 또는 특정유저만 알림메세지를 나타내길 원하는 경우 아래의 5가지 권한을 지정할 수 있습니다.

NONE : 아무도 표시하지 않습니다.

ADMIN : 관리자권한만 접속/접속종료 메세지를 보이게 설정합니다.

MEMBER : 회원권한이상만 접속/접속종료 메세지를 보이게 설정합니다.

NICKGUEST : 닉네임을 지정한 모든유저를 접속/접속종료 메세지를 보이게 설정합니다.

ALL : 닉네임이 없는 모든 유저를 포함한 유저전체의 접속/접속종료 메세지를 보이게 설정합니다.

온라인, 자리비움, 다른용무중 등 미니톡의 상태아이콘이 유저목록에 나타나는 것을 설정할 수 있습니다.

true : 상태아이콘을 보임

false : 상태아이콘을 숨김

true 로 설정될 경우 접속시 기본적으로 현재 접속자목록을 출력합니다.

false 일 경우 접속시 기본적으로 현재 접속자목록이 숨겨지지만, 유저목록보기 버튼을 클릭하여, 유저목록을 보이게 할 수 있습니다.

100명 이상 접속할 경우, viewUser 값이 true 일지라도 자동적으로 접속자목록이 숨겨지게 됩니다.

유저목록을 기본적으로 출력하지 않을 경우, 시스템 성능에 따라 체감적으로 성능이 향상될 수 있습니다.

동시접속자가 많을 경우, 또는 특정유저만 유저목록에 나타내길 원하는 경우 아래의 4가지 권한을 지정할 수 있습니다.

ADMIN : 유저목록에 관리자권한만 보이게 설정합니다.

MEMBER : 유저목록에 회원권한이상만 보이게 설정합니다.

NICKGUEST : 유저목록에 닉네임을 지정한 모든유저를 보이게 설정합니다.

ALL : 닉네임이 없는 모든 유저를 포함한 유저전체목록을 보이게 설정합니다.

미니톡의 가로크기를 픽셀단위 또는 퍼센트(가변)단위로 정의합니다.

퍼센트단위로 입력할 경우, 반드시 따옴표( " ) 로 묶은 뒤 입력하여야 정상동작 합니다.

new Minitalk({
	channel:"example",
	height:200,
	// skip lines
});

또는,

new Minitalk({
	channel:"example",
	height:"100%",
	// skip lines
});