PluginIntroduction

이 문서는 텍스트큐브 플러그인의 구조와 기능을 예제와 함께 설명합니다.

기본 개념

텍스트큐브의 플러그인은 plugins 디렉토리 하위에 설치되어 텍스트큐브의 기능을 확장하거나 새로운 기능을 더하는 역할을 합니다. 플러그인은 일반적으로

• 텍스트큐브 코어와 플러그인의 상관 관계를 정의하고 동작 위치등을 결정하는 index.xml,
• 실제 실행되는 플러그인 코드가 들어있는 index.php

를 필요로 합니다.

주의사항

텍스트큐브 플러그인 코드는 텍스트큐브에서 상상 가능한 거의 모든 곳에 연결되어 동작할 수 있습니다. 텍스트큐브의 데이터베이스 테이블에 직접 접근하거나 동작을 해킹하는 것도 가능하지만, 호환성 보장 및 보안 문제를 해결하기 위하여 텍스트큐브에서 제공하는 플러그인 API 들과 컴포넌트들을 사용하여 작성하시는 것이 좋습니다. 이렇게 하면 대부분의 텍스트큐브 코드를 수정 없이 인용하거나 재사용할 수 있으며, 향후 텍스트큐브 업그레이드 시에도 버전업에 따른 플러그인 수정 지침만 따르면 플러그인도 쉽게 업그레이드할 수 있습니다.

목차

처음 플러그인을 제작하시려는 분들께서는 각 문서의 첫 단락인 '기본 개념'과 '예제: Hello World!'를 먼저 읽어보시기 바랍니다.

1. 플러그인 드라이버- index.xml
2. 플러그인 코드 - index.php
3. 플러그인 이벤트란?
4. 플러그인을 위한 스킨 치환자와 가상 치환자들
5. 플러그인용 환경설정과 API
6. 사이드바 플러그인 만들기
7. 표지 플러그인 만들기
8. 관리자 화면 센터에서 사용할 수 있는 위젯 플러그인 만들기
9. 플러그인으로 관리자 화면에 메뉴 만들기
10. 플러그인 고유의 URL을 할당하여 팝업이나 페이지를 만들기
11. 플러그인 고유의 데이터를 저장하는 테이블 생성과 API, 관리
12. 플러그인 국제화 및 다국어 지원 확장

• 아래는 텍스트큐브의 코드 중 플러그인 작성시 도움이 되는 문서들입니다.

1. 접근 제어 시스템 (Access Control Objects)
2. Etag (브라우저 캐시 사용)
3. 자바스크립트 형식으로 제공해주는 텍스트큐브 변수들