사이트 패키지

1. 개요

사이트패키지는 Rb의 모든 확장요소들을 하나의 패키지로 묶어놓은 확장요소입니다. 레이아웃이나 모듈과 같은 확장요소는 물론 메뉴와 페이지 파일등의 데이터까지도 한번의 과정으로 설치할 수 있습니다.

2. 기본 구조

패키지는 Rb내의 모든 확장요소와 파일들을 포함할 수 있습니다. 따라서 패키지 배포용으로 사이트나 특정 서비스를 개발하였을 경우에 사용된 모든 데이터들을 패키지로 묶어야 합니다.다음과 같은 사이트를 만들었고 해당 사이트에 사용된 요소들을 패키징을 한다고 가정하겠습니다.

주의 Rb 자체에 기본으로 포함되어 있는 요소들은 포함하지 않아야 합니다.

위의 구조중에서 패키지에서 사용된 파일들만 압축하며 Rb 기본 패키지에 포함된 확장요소들은 제외합니다. 검정색 배경으로 처리된 부분은 패키지의 설치정보를 담고 있으며 반드시 포함되어야 합니다. (_settings 폴더는 패키지 설치과정에서 자동으로 삭제됩니다)

패키지에 사용된 확장요소들은 폴더명이 중복되지 않도록 해야 하므로 패키지 전용 확장요소들의 폴더명은 특정문자열을 포함시켜 네이밍합니다.
보기 rb_package_sevengo1.zip 에 사용된 전용 레이아웃일 경우 sevengo1 으로 레이아웃폴더 명칭을 사용함.

3. 기본 패키지 만들기

3-1. 주요파일의 이해

_settings/var.php

var.php 파일은 패키지의 설치정보를 담고 있습니다. 실행옵션에 해당되는 4개의 배열은 필요한 것만 포함시킵니다. 예를들어 메뉴생성을 지원하지 않는다면 해당배열은 주석처리합니다.

_settins/var.menu.php

이 파일은 관리자모드 - 사이트 - 메뉴 페이지에서 자동으로 다운로드 받을 수 있으며 메뉴 자동생성을 지원할 경우에만 포함시킵니다. 메뉴 자동생성을 지원하는 경우에는 rb/pages/사이트코드-menus 폴더를 패키지에 반드시 포함시켜야 합니다.

_settins/var.page.php

이 파일은 관리자모드 - 사이트 - 페이지 에서 자동으로 다운로드 받을 수 있으며 페이지 자동생성을 지원할 경우에만 포함시킵니다. 페이지 자동생성을 지원하는 경우에는 rb/pages/사이트코드-pages 폴더를 패키지에 반드시 포함시켜야 합니다.

_settings/run.php

정상적인 패키지일 경우 메뉴/페이지 자동생성 , 모듈 자동설치(DB테이블 셋팅포함) , 플러그인/스위치 등의 설치정보가 자동업데이트 됩니다. 그러나 경우에 따라서 추가적인 액션이 필요할 수 있는데 이 때 run.php 작성하면 패키지 설치과정에서 자동으로 실행됩니다. 추가액션이 없어도 되는 경우 이 파일은 포함시키지 않아도 됩니다.

_settings/readme.txt

readme.txt 파일에는 해당 패키지에 포함된 확장요소들에 대한 정보를 작성합니다. 위의 코드는 예제일 뿐이며 작성양식은 전적으로 개발자가 정의합니다.(HTML 태그 사용가능) 다만, 패키지 설치 모달창의 사이즈에 맞춰 인스톨러의 틀에 맞게 작성해 주어야 합니다.

4. 예제

패키지의 기본구조를 파악한 후에는 다음의 샘플을 다운로드 받아 직접 확인합니다. 특별히 _settings 폴더안에 있는 파일들의 구조를 눈여겨 보세요.
  1. 사이트 패키지 샘플 코드보기 다운로드

참고 테스트를 위해 위의 샘플 패키지를 다운로드 받아 Rb의 패키지 인스톨러로 설치를 하게 되면 다음의 확장요소들이 추가됩니다.
추가된 확장요소들을 삭제하려면 다음과 같이 처리해 주세요.

rb -+- layouts  -+- example (관리자모드 - 레이아웃 - 삭제 또는 FTP삭제)
    |
    +- modules  -+- example (관리자모드 - 모듈 - 삭제)
    |
    +- pages    -+- 사이트코드-menus (사이트나 메뉴 삭제시 자동삭제)
    |            +- 사이트코드-pages (사이트나 페이지 삭제시 자동삭제)
    |
    +- plugins  -+- example (관리자모드 - 시스템 도구 - 플러그인 - 삭제)
    |
    +- switches -+- start -+- example (관리자모드 - 시스템 도구 - 스위치  - 삭제)
    |            +- head  -+- example (관리자모드 - 시스템 도구 - 스위치  - 삭제)
    |            +- foot  -+- example (관리자모드 - 시스템 도구 - 스위치  - 삭제)
    |
    +- widgets  -+- example (관리패널 - 위젯코드 - 삭제 또는 FTP 삭제)

5. 패키징 방법

패키지 설치파일은 반드시 rb_package_패키지명.zip 이어야 합니다. 압축시 Rb 최상위 폴더를 기준으로 포함시킬 폴더와 파일들을 실제경로에 맞게 압축합니다.

주의 압축파일인 rb_package_패키지명.zip 의 압축을 풀었을때 패키지명 폴더가 생성되면 안되며 Rb 폴더구조와 동일하게 최상위에 풀려야 합니다. (샘플 패키지파일을 압축해제한 후 어떻게 풀리는지 확인하세요.)

위로