Textcube : Brand yourself!

태터툴즈 1.1용 스킨은 텍스트큐브 1.5와 호환되며,  태터툴즈 1.1 플러그인의 대부분은 텍스트큐브 1.5와 호환됩니다.

• 동작하지 않는 플러그인의 대응을 위한 방법
• 텍스트큐브 1.5에서만 사용할 수 있는 스킨 치환자 및 개선점

의 경우, 텍스트큐브 배포판의 doc 디렉토리의 changes_ko 파일에서 설명하고 있습니다.

아래는 텍스트큐브 1.5와 함께 묶어 배포된 changes_ko의 변경사항 내역입니다. 같은 내용을 텍스트큐브 1.5의 doc/changes_ko에서 읽으실 수 있습니다.

목차

• 스킨 관련 변경점 및 추가 안내
• 플러그인 관련 변경점 및 추가 안내
• BlogAPI 관련 변경점 및 추가 안내
• 환경 설정 파일 관련 변경점 및 추가 안내

스킨 관련 변경점 및 추가 안내

metapage Part 추가

  블로그에 프롤로그 기능을 포함하여 다양한 기능을 가진 페이지를 더할 수 있는 메타페이지 플러그인이 추가 되었습니다. 이 기능을 사용하기 위하여 출력되는 영역을 지정하는 metaPage 가 스킨 문법에 추가되었습니다.

    * <s_meta> : 메타페이지 영역
      * <s_metapage> : 메타페이지 플러그인 및 구성요소 출력 반복 영역

아래는 예제입니다.

<s_meta>

    <div class="metapage">
        <s_metapage></s_metapage>
    </div>
</s_meta>

태그와 키워드의 통합

키워드 기능을 사용할 때, 같은 이름을 가진 태그가 있으면 해당 태그 페이지를 보여줄 때 키워드 설명을 먼저 보여주도록 할 수 있습니다. 이를 위하여 스킨에서

• <s_keylog_rep>
• [##_keylog_rep_title_##]
• [##_keylog_rep_desc_##]
  

치환자가 추가 되었습니다.

아래는 예제입니다.

             <s_keylog_rep>
                 <div class="entryKeylog">
                     <div class="titleWrap">
                         <h2>[##_keylog_rep_title_##]</h2>
                     </div>
                     <div class="article">
                         [##_keylog_rep_desc_##]
                     </div>
                </div>
            </s_keylog_rep>

404 에러 관련

 페이지가 없을 때 출력되는 페이지를 스킨에서 추가적으로 지정할 수 있습니다. <s_page_error>로 묶은 부분이 에러 발생시에 출력됩니다. 스킨에 해당 부분이 없을 경우에는 1.5 이전과 똑같이 동작합니다.

트랙백 검색 관련 스킨 치환자

  트랙백 검색 결과 출력을 위한

• [##_tblist_conform_##]
• [##_tblist_count_##]
• <s_tblist>
• <s_tblist_rep>
•  [##_tblist_rep_regdate_##]
• [##_tblist_rep_link_##]
• [##_tblist_rep_subject_##]
• [##_tblist_rep_body_##]

가 추가되었습니다.

아래는 예제입니다.

제목 표시 부분 추가

 제목의 모양과 표시될 때의 상태에 따라 자유롭게 변경할 수 있습니다. (더이상 :: 을 보지 않으셔도 됩니다. 이에 따라 

• 상황에 따라 제목이 변하는 영역을 의미하는 <s_page_title>
• 현재 페이지에서 보여주는 포스트 이름인 [##_page_post_title_##]

이 추가되었습니다.

아래는 예제입니다.

플러그인 관련 변경점 및 추가 안내

플러그인 이름 변수

 기존의 변수들($pluginURL, $pluginPath)에 플러그인의 이름을 가져올 수 있는 변수인

• $pluginName

이 추가되었습니다.

플러그인 설정 component 제공

 index.xml을 통한 텍스트큐브의 설정 메뉴 대신 설정 프로그램 자체를 만들 수 있습니다. 이 경우 Textcube.Model.PluginCustomConfig 컴포넌트를 사용하면 됩니다. index.xml의 manifest에서 config 바인더를 사용하지 않는 경우 컴포넌트를 사용할 수 있습니다.
 
 인터페이스는 다음과 같습니다.
 

PluginCustomConfig{
         /* public bool*/
         function load(){
        /* public string null*/
        function getValue($name){
        /* public bool*/
        function setValue($name , $value){
        /* public array null */
        function getAllValue(){
        /* public bool */
        function setMergedValue( /* array */ $configVal ){
        /* public bool */
        function setAllValue(/* array */ $configVal ){

플러그인에서 접근할 수 있는 필드명 변경

 
기존에 플러그인이 블로그를 구분하기 위하여 사용되었었던 owner 필드가 blogid (또는 경우에 따라 userid) 필드로 변경되었습니다. 기존의 태터툴즈 플러그인을 텍스트큐브에서 사용하기 위해서는 위 필드 호출 부분을 변경해야 합니다.

만약 데이터베이스 입출력이 컴포넌트의 DBQuery 클래스로 규격화되어 있다면, 호환성을 위하여 루트 디렉토리의 config.php에

• $service['useLegacySupport']

를 true로 주어서 임시로 호환성을 개선할 수 있습니다.

index.xml의 requirement 필드의 privilege 안내

 용도에 따라 전체 관리자만이 사용할 수 있는 플러그인을 지정할 수 있습니다. 전체 관리자만을 위한 플러그인이라면 <requirement> 안에 <previlege>를 지정하고, administrator를 명기하면 됩니다.
 따라서
 와 같이 지정할 수 있습니다.

 또한 플러그인에서 현재 블로그가 전체 메타 페이지인지 개인 블로그인지 구분해서 동작하기 위해서는 misc::isMetaBlog를 사용하실 수 있습니다. misc::isMetaBlog() 의 값이 true이면 전체 블로그들의 메타 페이지 입니다.

   requireComponent('Textcube.Function.misc');
   $isMetaBlog = misc::isMetaBlog();

 와 같이 사용하면 됩니다.

관리자 플러그인의 도움말 편집

 
텍스트큐브 도움말 위키를 이용하여 관리자 플러그인들의 도움말 페이지를 만들 수 있습니다. 관리자 화면의 메뉴 막대 우측의 '도우미' 링크가 이제는 관리자 플러그인 화면인 상태에서도 현재 관리자 플러그인 주소로 링크되어 동작합니다. 위키에 사용자 등록을 하신 후 도움말 페이지를 등록할 수 있습니다.
 
 

BlogAPI 관련 변경점 및 추가 안내

BlogAPI 전용 비밀번호 설정 기능

 BlogAPI를 사용하여 글을 작성하실 경우 로컬 프로그램을 사용하는 경우는 관계없지만 다른 서비스를 글 에디터로 사용하는 경우가 있습니다. 이 경우 본인의 블로그 암호를 해당 서비스에 노출하고 싶지 않은 경우를 위하여 BlogAPI에만 적용되는 비밀번호를 따로 지정할 수 있습니다. '환경설정'-'글 작성' 의 글 작성 환경 설정에서 비밀번호를 지정하시면 됩니다.

카테고리를 지원하지 않는 클라이언트에도 카테고리를 지원

 기존의 BlogAPI는

•    http://blog.example.com/api

 형태의 XMLRPC server url이 존재합니다. 클라이언트 중에서 카테고리를 지정하지 않고 글만 작성하는 경우가 있습니다. 예를 들어 me2day에서 전송해 오면 카테고리가 지정되지 않아 '분류없음' 으로 등록이 되고, 알라딘의 ttb의 경우 category가 Aladdin으로 전송되어 옵니다. 이렇게 클라이언트가 약간 기능이 부족하여 카테고리 지정으로 인한 다양한 기능을 사용하지 못하는 것을 만회하기 위해 다음과 같은 BlogAPI 주소를 사용할 수 있습니다.

1. http://blog.example.com/api?category=mycategory
   
2. http://blog.example.com/api?category=%EC%9E%A1%EC%83%9D%EA%B0%81
   
3. http://blog.example.com/api?category=2

 위와 같이 category 라는 변수 뒤에 UTF-8으로 카테고리명을 지정하면, 클라이언트가 지정하거나 혹은 지정하지 않는 경우에라도 강제로 설정하는 기능입니다. 즉, 해당 카테고리에 posting하는 BlogAPI xmlrpc service url이 되는 것입니다.

 3)의 예는 현재는 카테고리 이름만으로 구별하는데, 만약 UTF-8 문자열을 구하기 어렵거나 한글에 애로사항이 생길 경우 내부 식별자인 숫자로도 지정할 수 있습니다. 내부 식별자를 알 수 있는 방법은 "관리자>글>분류관리" 메뉴에서 미리보기의 카테고리를 눌렀을 때 주소창에 다음과 같이 나옵니다.
 http://blog.example.com/owner/entry/category/?'''id=10'''&entries=2&priority=5&name1=%ED%94%84

 이러한 부분이 어려울 수 있기 때문에 해당 기능을 간단하게 지원하기 위한 도우미가 추가 되었습니다. '환경설정' 의 '글 작성' 목록에서 카테고리를 선택하면 그에 해당하는 BlogAPI 글 보내기 링크가 자동으로 생성되어 출력되므로 그 링크를 사용하시면 됩니다.
 

환경 설정 파일 관련 변경점 및 추가 안내

config.php에서 가능한 설정 값들은 doc/config 에서 확인할 수 있습니다.

RSS 주소 기본값의 숫자 변경

 RSS로 출력되는 주소값은 관리자 모드에서 결정한 값 (문자/숫자)을 따라갑니다. 설정에 관계없이 무조건 숫자로 출력하기 위해서는 루트 디렉토리의 config.php에

$service['useNumericURLonRSS'] = true;

 를 추가하면 됩니다.

정적 페이지 캐시 기능 끄기

 1.5에서 도입된 정적 페이지 캐시 기능을 끌 수 있습니다. 루트 디렉토리의 config.php에

$service['disablePageCache'] = false;

를 추가하면 됩니다.

디버그 모드

1.5에서는 전용 디버그 모드를 가지고 있습니다.

requireComponent('Needlworks.Function.Debug');

를 설치 디렉토리에 생성된 config.php에 추가하면 디버그 모드가 동작하게 됩니다.

더 자세한 내용을 위해서는 config에서 가능한 명령 목록을 참조하시기 바랍니다.