플러그인
1. 개요
플러그인은 레이아웃 또는 특정 영역에 삽입되는 외부의 라이브러리 입니다. bootstrap이나 jQuery가 해당됩니다.
2. 기본경로 및 공통변수
- 플러그인의 위치 :
$g['path_plugin'](ex) ./plugins/- 플러그인 변수파일 :
- ./_var/plugin.var.php
3. 기본구조
4. 기본 플러그인 만들기
외부에서 제공하는 라이브러리를 다운로드 받은 후, 위 폴더구조(플러그인폴더/버전폴더/관련파일들)로 만드시면 Rb에서 사용할 수 있는 플러그인이 됩니다.
참고 플러그인을 추가하면 플러그인 폴더안에 size.txt 파일(플러그인 사이즈정보 캐시 - 삭제시 재생성됨)이 생성됩니다.
외부에서 다운로드 받은 소스코드에 버전폴더가 없을 경우에는 ?
버전이 없는 소스코드일 경우, 임의로 버전폴더를 만들어 주어야만 사용할 수 있습니다.
5. 에디터 플러그인 만들기
Rb에는 기본 위지위그 에디터로 summbernote 가 포함되어 있습니다. 여기에 ckeditor 등을 추가하려면 Rb의 구조에 맞게 다음과 같은 파일 추가가 필요합니다.
5-1. Summernote 서머노트
서머노트(Summernote)는 부트스트랩(Bootstrap) 기반에서 돌아가는 심플하고 강력한 위지윅 에디터 입니다.
plugins/summernote/import.php - 글쓰기 양식을 정의합니다.
plugins/summernote/filter.php - 입력된 글을 저장하기 전에 필터합니다.
5-2. CKEditor CK에디터
CKEditor는 대표적인 오픈소스 위지윅 에디터 입니다.
plugins/ckeditor/import.php - 글쓰기 양식을 정의합니다.
plugins/ckeditor/filter.php - 입력된 글을 저장하기 전에 필터합니다.
5-3. 다른 에디터 추가
외부에서 제공하는 다양한 위지위그 에디터들을 추가하려면 위와같이 플러그인 폴더안에 import.php , filter.php , rb-edit-style.css 파일을 추가해야 합니다. 각각의 에디터별로 데이터를 가공하는 방식이 다르기 때문에 위와같은 치환이 필요하며 이 과정은 직접 해당 에디터의 처리방식을 확인해야 합니다.
6. 예제
7. 패키징 방법
플러그인 설치파일은 반드시 rb_plugin_플러그인폴더명_버전.zip 이어야 합니다. 개발한 플러그인폴더가 myplugin 이고 그 안에 1.0.0 이라는 버전폴더가 있을 경우 우선 버전폴더를 1.0.0.zip 으로 압축한후 rb_plugin_플러그인폴더명_버전.zip으로 파일명을 변경합니다.
주의 압축파일인 rb_plugin_플러그인폴더명_버전.zip 의 압축을 풀었을때 버전폴더가 생성되면 안되며 버전폴더내의 파일들이 최상위에 풀려야 합니다. 플러그인 폴더와 버전폴더는 Rb에 설치되는 과정에서 자동으로 생성됩니다.
복수의 버전을 포함한 플러그인이나 플러그인 폴더안에 파일들이 포함된 플러그인을 패키징하려면?
myplugins 이라는 플러그인 폴더안에 version1 , version2 , version3 등의 복수 버전이 있을경우 이 플러그인을 한번에 패키징해야 할 경우가 있습니다. 이 경우에는 설치파일을 반드시 rb_plugin_플러그인폴더명.zip 으로 패키징해야 합니다. 이때 패키징할 폴더는 버전 폴더들이 들어있는 플러그인 폴더인 myplugins 이 됩니다.
주의 압축파일인 rb_plugin_플러그인폴더명.zip 의 압축을 풀었을때 myplugins 폴더가 생성되면 안되며 myplugins 폴더내의 버전 폴더들과 파일들(있을경우)이 최상위에 풀려야 합니다.