문서

톡 플러그인는 PHP 환경의 웹사이트에 쉽게 설치할 수 있는 채팅 위젯 솔루션입니다. 클라이언트 파일을 서버에 업로드한 후 몇 줄의 코드로 채팅 위젯을 삽입할 수 있습니다.

1. 대시보드에서 라이선스를 발급받고 API 토큰을 확인합니다.
2. client/ 디렉터리 전체를 웹서버의 원하는 경로에 업로드합니다. (예: /talk/)
3. Talk.class.php를 require한 후 위젯 iframe을 삽입합니다.

<?php
require_once '/path/to/talk/classes/Talk.class.php';
$talk = new Talk([
    'server_domain' => 'https://talk.yourserver.com',
    'token'         => 'YOUR_JWT_TOKEN',
    'channel'       => 'default',
]);
echo $talk->widget();

Talk 클래스 생성자에 옵션 배열을 전달해 동작을 제어합니다.

위젯은 <iframe> 형태로 삽입되며, 부모 페이지와 postMessage API로 통신합니다.

<!-- 기본 임베드 -->
<div id="my-chat" style="width:360px;height:600px;"></div>
<script src="/talk/scripts/loader.js"></script>
<script>
  TalkChat.init({
    container: '#my-chat',
    serverDomain: 'https://talk.yourserver.com',
    token: 'YOUR_JWT_TOKEN',
    channel: 'default',
    lang: 'ko',
  });
</script>

postMessage 이벤트

/talk/admin/ 경로로 접근하면 관리자 패널을 사용할 수 있습니다. 관리자 패널에서는 채널 관리, 채팅 내역 조회, IP 차단, 채팅금지 관리 등을 할 수 있습니다.

주요 기능

• 채널 생성·수정·삭제
• 채팅 내역 조회 (채널·닉네임·키워드 검색)
• 고정 공지 설정
• IP 차단 관리
• 채팅금지 목록 관리
• 전체 공지 브로드캐스트

채널은 대화 공간의 단위입니다. 용도별로 여러 채널을 만들어 운영할 수 있습니다.

채널별로 채팅창 상단에 고정 공지를 표시할 수 있습니다. 공지 내용이 긴 경우 자동으로 좌측으로 흐르는 마퀴(marquee) 애니메이션이 적용됩니다.

1. 관리자 패널 → 채널 설정에서 "고정 공지" 입력란에 내용을 입력합니다.
2. 저장하면 해당 채널의 모든 접속자에게 즉시 실시간으로 반영됩니다.
3. 내용을 비워두면 공지가 사라집니다.

관리자·운영자는 특정 사용자의 채팅을 일정 기간 금지할 수 있습니다.

채팅창에서 직접 금지

1. 관리자 또는 운영자 계정으로 채팅창에 접속합니다.
2. 금지할 사용자의 메시지에서 우클릭합니다.
3. 컨텍스트 메뉴에서 "채팅금지"를 선택합니다.
4. 금지 기간(1시간 ~ 영구)과 사유를 선택한 후 "금지 적용"을 클릭합니다.

관리자 패널에서 금지

1. 관리자 패널 → 메시지 내역에서 채널·닉네임·키워드로 검색합니다.
2. 해당 메시지 행의 "채팅금지" 버튼을 클릭합니다.
3. 기간과 사유를 입력한 후 적용합니다.

모든 클라이언트 API는 X-Site-Token 헤더에 사이트 토큰을 포함해야 합니다.

채널

메시지 내역

채팅금지

IP 차단