[텍스트큐브] TraceWatch 추적 코드 넣기 플러그인

텍스트큐브/끼우개 2011/07/17 13:03 글쓴이 : 팥알

텍스트큐브 블로그에 설치형 웹 통계 도구인 TraceWatch의 추적 코드를 붙여 주는 확장기능(플러그인)입니다. 텍스트큐브 1.7.7 이상에서 쓸 수 있습니다. 도아님의 TraceWatch 로그 플러그인과 구실이 같고, TraceWatch 0.352판에 맞추어 기능을 더 붙였습니다.

고친 내용

자바스크립트 코드가 들어가지 않던 것을 바로잡음 (1.0.1)
eregi_replace() → preg_replace() (PHP 5.4에 맞춤, 1.0.2)

주된 기능

블로그 글, 글 목록, 방명록, 피드(RSS,ATOM) 등에 TraceWatch 추적 코드를 붙임
PHP, 자바스크립트, 먼거리 PHP(remote PHP) 가운데 코드 종류를 고를 수 있음
환경 설정에서 고른 부가 기능과 선택 사항에 맞추어 추적 코드를 만듦

설정 방법

TraceWatch의 경로는 블로그 뿌리 경로에 대한 상대 경로를 넣습니다. 블로그가 http://blogname.org나 그 하위 경로에 깔려 있고 http://blogname.org/twatch에 TraceWatch가 깔려 있다면 TraceWatch 경로는 '/twatch'라고 넣습니다.
PHP, 자바스크립트, 먼거리 PHP 가운데 코드 유형을 고릅니다. 블로그와 TraceWatch가 같은 서버에 있으면 PHP로 넣을 수 있습니다. 자바스크립트와 먼거리 PHP는 TraceWatch가 블로그와 다른 서버에 있거나 PHP로 넣기 어려울 때 씁니다.
여러 누리집을 운영한다면 Website ID를 달리 하여 통계를 따로 낼 수 있습니다. TraceWatch 관리 화면에 ID를 지정하는 곳이 있습니다.
페이지 매개변수(URL 매개변수)를 넣지 않으면 'http://blogname.org/123?category=1'처럼 매개변수가 붙은 주소를 'http://blogname.org/123'과 같은 주소로 다룹니다.
먼거리 PHP로 쓰려면 /twatch/api에 있는 RemoteLogRequest.php를 블로그가 있는 서버에 복사하고 경로를 넣습니다. TraceWatch가 깔린 곳의 도메인 주소도 넣어야 합니다.
맨 위의 확인 항목에 갈매기표를 하고 저장해야 추적 코드가 들어갑니다. 잘못된 경로 설정 때문에 확장기능을 켜자마자 블로그가 먹통이 되지 않게 하는 안전장치입니다.

주의할 점

하위 도메인(서브도메인)을 상위 도메인과 함께 쓸 때는 경로 설정에 유의해야 합니다. 블로그 주소가 http://blog.blogname.org이고, Tracewatch가 http://blogname.org/twatch에 있다면 설정에 넣을 TraceWatch 경로는 '../tracewatch'와 같은 꼴이 되기도 합니다. 올바른 경로는 웹 계정이 어떻게 하위 도메인을 연결하고 있느냐에 다릅니다.
TraceWatch의 설치 경로를 잘못 넣으면 블로그가 먹통이 됩니다. 그래서 확인 항목에 갈매기표를 하고 저장해야 추적 코드가 들어가게 했습니다.
많은 웹 계정들이 보안 때문에 PHP의 allow_url_fopen이 잠겨 있습니다. 이 부분이 막히면 먼거리 PHP로 통계를 내지 못합니다.
자바스크립트 코드로는 검색기 로봇의 움직임을 잘 잡을 수 없고 피드 통계를 잡지 않습니다. PHP로 넣는 쪽이 정확한 정보를 얻기 좋습니다.
웹 문서에 오류를 나타내게 하면 HTML 앞쪽에 나오는 오류 내용 때문에 블로그 틀이 어긋날 수 있습니다.

확장기능 설정의 여러 항목들은 TraceWatch Code Generator에 나온 것들입니다. 설정을 그대로 두면 그 곳의 기본값과 같게 들어갑니다.

보람말 : ATOM, blog, Feed, PHP, plugin, Remote PHP, RSS, Textcube, TraceWatch, 먼거리 PHP, 방문자, 블로그, 웹 통계, 자바스크립트, 텍스트큐브, 통계, 트레이스워치, 플러그인, 피드, 피드 통계, 확장기능

걸린 글 1 / 덧글 11

글 걸기 주소 : 이 글에는 글을 걸 수 없습니다.

<걸린 글>

태터 플러그인: TraceWatch 업데이트

도아의 세상사는 이야기2011/11/04 05:42

사실 새롭게 글을 작성할 만큼 변경 사항이 있는 것은 아닙니다. 다만, 플러그인을 발표하고 확인해보니 두 가지 문제점이 있었습니다. 방명록과 공지가 카운트에 포함되지 않는 문제 이 부분은 플러그인을 동작하는데 사용한 이벤트가 ViewPostContent이기때문에 발생한 현상입니다. 즉, 기사가 있는 게시물에는 ViewPostContent 이벤트에 의해 TraceWatch 플러그인이 호출되지만 ViewPostContent 이벤트가 없는 페이지의 경우...

덧글을 달아 주세요

아르 2011/07/18 23:11 고유주소 고치기 답하기

팥빙산님 유용한 플러그인 감사드립니다. 기존에 플러그인 좀 수정해서 쓰고 있었는데 바로 갈아탔습니다. ^^
- 팥빙산 2011/07/19 07:20 고유주소 고치기 답하기
  
  고맙습니다. 저도 아르님의 언어 파일 잘 쓰고 있습니다.^^
其仁 2011/11/07 17:15 고유주소 고치기 답하기

이런 더 편한 플러그인이 여기에 있었네요. 다시 한 번 감사드리면서 잘 이용하겠습니다.
- 팥알 2011/11/08 13:36 고유주소 고치기 답하기
  
  고맙습니다.^^
비밀방문자 2012/11/02 02:59 고유주소 고치기 답하기

관리자만 볼 수 있는 덧글입니다.
- 팥알 2012/11/02 08:35 고유주소 고치기 답하기
  
  PHP를 쓸 수 있다면, PHP로 끼워 넣는 것이 가장 깔끔합니다. 그럴 수 없다면 위에도 고리 걸어 놓은
  
  http://www.tracewatch.com/doc/code
  
  에서 자바스크립트(JavaScript)코드를 만들어서 HTML 파일에 붙이면 됩니다. 대신 자바스크립트로 추적하면 자바스크립트를 쓰지 않는 검색 로봇(robot)과 방문자를 추적하지 못합니다.
  
  호스팅 환경을 어떻게 설정하느냐에 따라 HTML에도 PHP를 끼워넣을 수 있게 할 수 있으니 확인해 보셔야 할 것 같습니다.
  
  추적하는 문서마다 추적 코드가 들어가도록 해야 방문자의 경로까지 추적할 수 있습니다.
  위 텍스트큐브 플러그인이 텍스트큐브 블로그 글마다 추적 코드를 붙이는 구실을 합니다.
비밀방문자 2013/02/11 23:14 고유주소 고치기 답하기

관리자만 볼 수 있는 덧글입니다.
- 팥알 2013/02/12 00:45 고유주소 고치기 답하기
  
  tracewatch 설치가 잘못되거나 플러그인 설정이 잘못되어 있으면 블로그가 먹통이 될 수 있습니다. 아이폰에서 잘 보이는 건 텍스트큐브에서 그렇게 설정이 되어 있기 때문일 겁니다.
  
  저처럼 이미 도구를 본 사람도 설치형 도구는 오랜 만에 다시 쓰려고 하면 벽에 부딪힐 때가 종종 있습니다. 설치에 성공하더라도 잘잘한 문제가 생긴다면 보완 작업이 더 필요할 수 있습니다. 원인을 알 수 없다면, 시험 삼아 PHP 파일을 만들어 시험하기도 하는 요령을 부리기도 합니다.
  
  차근차근 해 보시며 안 되는 원인을 찾아 가면 좋을 듯합니다.
- 팥알 2013/02/12 00:54 고유주소 고치기 답하기
  
  PHP로 넣는 방법으로 잘 되지 않는다면, 자바스크립트로 넣을 수도 있습니다. 다만 자바스크립트로 넣는다면 PHP로 넣을 때의 몇몇 기능은 포기해야 할 수 있습니다.
비밀방문자 2014/01/16 17:41 고유주소 고치기 답하기

관리자만 볼 수 있는 덧글입니다.
- 팥알 2014/01/16 19:18 고유주소 고치기 답하기
  
  텍스트큐브에 플러그인으로 설치하는 파일입니다.
  압축을 풀어서 '텍스트큐브설치경로/plugins'에 올리면 됩니다.