킴스큐Rb 개발자를 위한 기초적인 가이드를 제시해 드립니다.
477 52 18
평가 :
분류 : 활용서
주제 : 킴스큐
개설일자 : 2011년 02월 01일
라이선스 : 비영리,재배포허용
개설자
세븐고님
포인트 : 167,752
등급 : 엑스퍼트 (24)
공동 작성자
공동 작성자가 없습니다.
작성자를 추천해 주세요
7 9
  • 노트
  • 킴스큐Rb 개발자를 위한 기초 활용노트

패키지 구성방법

관리자 | 2011.02.01 20:49 | 조회 6727

마켓에 올리기 위한 상품의 패키지 구성방법입니다.

패키지는 모듈/위젯/레이아웃/기타 4개로 구분될 수 있습니다.

 

 

 

 

모듈패키지 구성방법

 

 

패키지로 묶으려는 모듈의 폴더명이 mymodule 이라면 먼저 rb_module_mymodule 폴더를 바탕화면에 만듭니다.

 

 

이때 폴더명은 반드시 rb_module_ 로 시작되어야 하며 모듈폴더명인 mymodule 로 끝나야 합니다.

조합하면 rb_module_mymodule 이 됩니다.

그런다음 rb_module_mymodule 폴더안에 모듈폴더인 mymodule 을 넣습니다.

 

 

이렇게 rb_module_모듈폴더명 폴더안에 모듈폴더를 넣었다면 rb_module_모듈폴더명을 압축합니다.

압축은 반드시 zip 압축이어야 합니다.

다음과 같이 rb_module_모듈폴더명을 마우스 오른쪽 버튼으로 클릭한 후 rb_module_모듈폴더명.zip 으로 압축하기를 선택하시면 됩니다.

 


위의 압축예제는 "알집" 을 이용한 것이며 다른 압축프로그램을 사용할 경우에는 반드시 압축을 풀었을때 모듈폴더(mymodule) 폴더가 나오도록 압축하면 됩니다.

 

만약 윈도우즈 자체의 압축을 사용하려면 다음과 같이 진행합니다.

rb_module_모듈폴더명 폴더를 만들 필요없이 모듈폴더(mymodule) 를 마우스 오른쪽 버튼으로 클릭한 후 "보내기" 선택 후 "압축(ZIP)폴더" 를 선택합니다.

 



그러면 다음과 같이 파일명을 변경할 수 있는 상태로 mymodule.zip 이 만들어집니다.

 

이렇게 만들어진 mymodule.zip 의 이름을 rb_module_mymodule.zip 으로 변경하면 모듈패키지 작업이 완료됩니다.

 




중요한 점은 어떻게 압축을 하던지 압축된 패키지를 풀었을때 반드시 모듈폴더가 나와야 한다는 것입니다.

즉, 모듈패키지로 묶은 rb_module_mymodule.zip 을 풀었을때 mymodule 폴더나 나와야만 정상적인 모듈패키지이며 그렇지 않을 경우 마켓에서 정상적으로 작동되지 않게 됩니다.


[주의사항] 패키지를 묶기전에 모듈전용 DB테이블이 사용된 모듈이라면 _stting 폴더안의 db.table.php 가 db.table.php.done 으로 되어있는지 반드시 확인하고 db.table.php.done 이라면 꼭 db.table.php 로 변경한 후에 패키지를 묶어주세요.

 

모듈패키지를 만들었다면 실제로 정상적으로 등록이 되는지 확인할 필요가 있습니다.

정상적인 패키지여부는 마켓>패키지설치>모듈 페이지에서 할 수 있습니다.

 

모듈패키지 설치페이지에서 rb_module_mymodule.zip 을 등록해 봅니다.

이때, mymodule 이 이미 설치된 모듈이라면 설치가 되지 않으므로 반드시 "모듈관리" 페이지에서 해당모듈을 삭제 후 등록해야 합니다.

mymodule 모듈을 삭제한 후 rb_module_mymodule.zip 을 등록하면 다음과 같이 모듈 설치대기리스트에 등록이 됩니다. 이렇게 진행이 되었다면 정상적인 모듈패키지로 검증이 되었다 할 수 있습니다.

 


모듈폴더명에 대한 권고사항

 

모듈폴더는 mobiles 폴더내에서 중복이 되어서는 안됩니다.

따라서 bbs나 comment , memeber 등 이미 기본모듈로 포함되어 있거나 중복되기 쉬운 단어는 피해야 합니다.

모듈 설치과정에서 중복된 모듈폴더가 존재한다면 모듈설치가 차단이 되므로 겹칠 문제는 없지만 사용자들로 하여금 번거로움을 줄 수 있으므로 가급적 모듈폴더명은 중복을 피할 수 있는 단어로 만들어 주시기 바랍니다.

 

 

모듈을 마켓에 등록할 경우에는 다음과 같이 설정합니다.

 

속성/테마 : (적절한 테마를 선택합니다)

 

설치위치 :

 

 

 

 

 

 

위젯패키지/레이아웃패키지 구성방법

 

 

 

위젯과 레이아웃패키지를 만드는 방법은 모듈과 동일합니다.

다만 패키지명은 다음과 같이 만들어 주어야 합니다.

 

- 위젯패키지 : rb_widget_위젯폴더.zip

- 레이아웃패키지 : rb_layout_레이아웃폴더.zip

 

모듈패키지와 마찬가지로 위젯,레이아웃 패키지의 압축을 풀었을때 반드시 위젯폴더와 레이아웃폴더가 맨처음에 나오도록 패키지를 묶어야 합니다.

위젯과 레이아웃도 폴더명이 중복될 수 없으므로 모듈과 같이 폴더명이 중복되지 않도록 폴더명선택시 중복을 피할 수 있는 패턴으로 만들어 주시기 바랍니다.

 

 

위젯이나 레이아웃을 마켓에 등록할 경우에는 다음과 같이 설정합니다.

 

위젯을 등록하는 경우 :

 

속성/테마 : (적절한 테마를 선택합니다)

 

설치위치 : (위젯분류가 있을 경우 포함시킵니다)

 

레이아웃을 등록하는 경우 :

 

속성/테마 : (적절한 테마를 선택합니다)

 

설치위치 :

                (pc모드용인지 모바일모드용인지 선택합니다)

 

 

 

 

 

 

 

게시판테마 패키지 구성방법

 

 

 

게시판테마명이 mytheme 일 경우 rb_bbstheme_(PC/MOBILE)_mytheme.zip 으로 압축합니다.

PC모드용 테마일 경우: rb_bbstheme_PC_mytheme.zip

모바일용 테마일 경우 : rb_bbstheme_MOBILE_mytheme.zip

 

이때 주의하실 점은 rb_bbstheme_(PC_MOBILE)_mytheme.zip 파일의 압축을 풀었을때 반드시 mytheme 가 최상위에 나와야 한다는 것입니다.

 

rb_bbstheme_PC_mytheme.zip 압축을 풀었을때 정상적인 경우

다음과 같이 mytheme 폴더가 최상위에 생성되어야 합니다.

 

 

다음은 패키지를 잘 못 묶었을 경우 압축을 풀었을때 테마폴더내의 파일들이

최상위로 풀리는 잘못된 예입니다.

 



 

패키지를 정상적으로 구성했다면 마켓등록시에 다음과 같이 등록해 주어야 정상적인 원격설치가 가능합니다.

 

속성/테마 :

 

 

PC모드용 게시판테마 :

설치위치 :

 

모바일모드용 게시판테마 :

설치위치 :

 

 

 

 

 

 

기타패키지 구성방법

 

 

기타패키지는 모듈,위젯,레이아웃 이외의 확장요소들을 패키지로 묶은 것으로  기본패키지와는 다른 방식으로 동작합니다.

모듈,위젯,레이아웃 패키지는 이미 동일한 명칭(폴더명)으로 등록이 되어 있다면 중복을 막기위해 설치과정에서 차단이 되지만 기타패키지는 "덧씌우기" 로 진행이 됩니다.

 

즉, 이미 존재하는 폴더나 파일들은 덧씌우고 그렇지 않을 경우 생성을 해주게 됩니다.

 

패키지는 rb_etc_최초폴더명.zip 으로 만듭니다.

"최초폴더명" 은 기타패키지의 압축을 풀었을때 나오는 처음폴더의 명칭입니다.

만약 최초폴더가 없고 여러개의 파일이나 폴더로 구성된 패키지라면 rb_etc_임의의명칭.zip 으로 만들면 됩니다.

 

기타패키지는 주로 업데이트나 특정소스 추가시에 사용될 수 있습니다.

예를들어 mymodule 을 배포(혹은 판매)한 후 파일이 추가되거나 변경되었을 때 변경내용을 기타패키지로 제공할 수 있습니다.

 

 

 

기타패키지를 마켓에 등록할 경우에는 다음과 같이 설정합니다.

 

속성/테마 : (적절한 테마를 선택합니다)

 

설치위치 :

(패키지의 압축을 풀었을때 생성되는 최상위폴더의 경로를 선택 또는 입력합니다)

 

 

 

 

사이트패키지 구성방법

 

 

사이트패키지는 모듈이나 레이아웃 위젯과 달리 사이트를 구성한 메뉴,페이지,게시판 등을 자동으로 셋팅해 줄 수 있습니다.

킴스큐를 이용하여 웹사이트를 구축할 경우 사이트의 종류나 성격에 따라서 별도의 추가모듈이나 위젯 혹은 기타 페이지들을 위한 파일들이 필요할 수 있습니다.

이러한 추가 요소들을 하나의 패키지로 묶어 구성할 수 있습니다.

 

1) 사이트패키지 구성방법

 

ㄱ. 킴스큐를 이용해 웹사이트를 구축이 완료(메뉴구성,페이지구성,게시판구성,추가레이아웃,추가모듈,추가위젯 등)되면 관리자모드 > 마켓 > 패키지설치 > 패키지 페이지에 접속합니다.


4677

 

 

ㄴ. "이 사이트를 패키지로 만들기" 버튼을 클릭합니다.


4679

 

 

ㄷ. 기본적인 패키지 구성이 완료되면 킴스큐 폴더안에 다음과 같이 _package 라는 폴더가 생성됩니다.

 

 

4678

 

 

ㄹ. _package 폴더안에는 다음과 같이 구성이 됩니다.

 

4676

- rb : 패키지용 추가폴더/파일

- dumb_bbs.dat : 게시판 구성파일

- dump_menu.dat : 메뉴 구성파일

- dump_page.dat : 페이지 구성파일

- dump_site.dat : 사이트 구성파일

- package.rule.php : 패키지 규칙

- readme.txt : 패키지 안내문

 

패키지를 구성하면서 새로 추가된 레이아웃,모듈,위젯,기타 파일이나 폴더들을 rb 폴더안에 실제 경로에 맞춰 복사해 줍니다.

(킴스큐 패키지에 포함되어 있는 파일들은 제외하고 패키지에 추가로 사용된 파일들만 복사합니다)

새로 추가된 모듈이 있을 경우 해당모듈에서 신규로 DB테이블 생성이 된다면 반드시 해당모듈의 _setting 폴더안에서 db.table.php.done 파일을 db.table.php 로 변경합니다.

package.rule.php 파일을 열어서 패키지의 명칭과 추가된 요소들을 정의해 줍니다.

readme.txt 파일에 패키지에 대한 안내문을 가급적 자세히 기술해 줍니다.

 

ㅁ. 이상의 작업이 모두 완료되었다면 패키지를 압축합니다.

 

패키지명은 반드시 rb_package_코드명.zip 이어야 하며 패키지파일의 압축을 풀었을때 반드시 _package 폴더가 최상위에 나와야 합니다.

 

4680

rb_package_sevengo 폴더안에는 _package 폴더가 들어있어야 합니다.

 

2) 패키지 마켓 등록방법

 

패키지를 마켓에 등록할때는 설치위치를 반드시 기본값으로 지정해 주어야 합니다.

그외의 입력사항들은 모듈이나 위젯, 레이아웃 등의 기타 확장요소들과 동일합니다.


4675


사이트패키지는 웹사이트의 구성 전체가 변경될 수 있으므로 마켓에 패키지를 등록하기 전에 반드시 자체검증을 거쳐 정상적으로 동작하는지 확인해야 합니다.

 

 

 

 

twitter facebook
  • 노트(52)
  • 목차
  • 분류별
  • 펼쳐보기
  • 포토(2)
  • 동영상(0)
소셜링크 모듈 사용시 보내진 SNS 아이콘 출력방법
소셜링크를 사용할 경우 게시물이나 댓글등록시 SNS 사이트로도 동시에 보낼 수가 있습니다.그런데 보낸내용을 아이콘으로 출력하려면 테마에서 별도로 출력용 코드를 적용해 주어야 합니다..
세븐고님 , 열람 : 3832 ㆍ2011.12.22 5 3+1
1.1 이후버젼에서 외부라이브러리(jquery 등) 자동 임포트방법
1.1 이후 버젼부터는 레이아웃의 폴더구조가 다음과 같이 구조화되었습니다. layouts -+- 레이아웃 -+- _action -+- 액션파일들 ..
세븐고님 , 열람 : 4762 ㆍ2011.12.21 9 3+1
1.1 이후버젼에서 모듈내 테마의 사용자액션 사용방법
1.1 이후버젼에서는 모듈내에 포함되어 있는 테마에서 사용자액션을 사용할 수 있습니다.모듈구의 구조를 보면 보통 다음과 유사하게 되어 있습니다. modules -+- 모듈 -+- ..
세븐고님 , 열람 : 4142 ㆍ2011.12.21 3 3
PHP입문 가이드
PHP 에 입문하고자 하는 분들에게 작은 분량이지만 꼭 필요한 것들만 모아서 정리해 드리고자 합니다. 여기에 올려드린 내용이 PHP의 전부는 아니지만 처음부터 끝까지 자신의 것으..
관리자님 , 열람 : 6770 ㆍ2011.02.01 13 1
(02) 변수/상수/배열/함수/객체
변수/상수/배열/함수/객체.. 를 접하기 전에 먼저 각각의 용어에 대한 이해가 필요합니다. 함수라는 단어는 보통 중학교 수학시간에 처음으로 접하게 되는데 "y는 x에 대한..
관리자님 , 열람 : 6575 ㆍ2011.02.01 4 4
(01) PHP 이렇게 시작하라
PHP뿐만 아니라 모든 언어들을 배울때 입문자들이 범하는 실수중에 하나가 무작정 "책" 부터 사는 것입니다. 물론 요즘과 같이 인터넷이 발달되지 않았던 시절에는 정보를 접하기 어..
관리자님 , 열람 : 6971 ㆍ2011.02.01 10 4+2
마켓등록
지금까지 여러분이 만든 모듈,위젯,레이아웃을 마켓에 등록하려면 먼저 "판매자등록" 을 해야합니다. 판매자 등록을 하시면 운영진의 심사후 이용약관에 따라 문제가 없을시 정식판매자로..
관리자님 , 열람 : 4814 ㆍ2011.02.01 0 1+2
드리는 말씀
앱스토어나 안드로이드 마켓에서 흔히 말하는 "대박앱" 이 나올때 마다 해당앱의 기발한 아이디어에 놀라곤 합니다. 우리는 보통 사용자의 니즈를 읽는데 들이는 시간보다 오직 개발자체..
관리자님 , 열람 : 2992 ㆍ2011.02.01 5 1
패키지 구성방법
마켓에 올리기 위한 상품의 패키지 구성방법입니다. 패키지는 모듈/위젯/레이아웃/기타 4개로 구분될 수 있습니다. 모듈패키지 구성방법 패키지로 ..
관리자님 , 열람 : 6728 ㆍ2011.02.01 4 2
마켓 이용약관
제1조 목적본 약관은 레드블럭(이하 회사라 함)가 운영하는 디지털 컨텐츠 전자상거래 서비스인 큐마켓 서비스(이하 본 서비스라 함)를 이용하여 디지털 컨텐츠를 거래하는 회원 간 또는..
관리자님 , 열람 : 2617 ㆍ2011.02.01 0 0
개발 참고자료
이 곳은 개발자 여러분들께 유용한 자료들을 올려드리는 공간으로 사용됩니다. 자료가 준비되고 확보될때마다 이 곳을 통해서 공유해 드리도록 하겠습니다.
관리자님 , 열람 : 5562 ㆍ2011.02.01 0 0
DB테이블 내역서
킴스큐Rb를 설치했을때 기본으로 셋팅되는 테이블들에 대한 정보입니다. 기본으로 사용되는 필수테이블은 31개이며 게시판모듈에서 5개가 생성되어 총 36개의 테이블이 생성됩니다. ..
관리자님 , 열람 : 6813 ㆍ2011.02.01 9 1+1
파일디렉토리 구조도
버젼에 따라서 실제구조와 차이가 날 수 있습니다. 크게 보시려면 아래의 첨부파일을 다운로드 받으셔서 보세요.
관리자님 , 열람 : 6449 ㆍ2011.02.01 8 1
실전 레이아웃제작
레이아웃은 사용자페이지의 틀을 구성하는 디자인요소입니다. 과거 프로그램들은 헤더/풋터/메뉴/사이드 등의 요소를 분리하여 프로그램에 붙여주는 형식으로 구성된 경우가 많았습니다. ..
관리자님 , 열람 : 7098 ㆍ2011.02.01 7 0
(5) 전용변수/함수 처리
레이아웃 제작하면서 해당 레이아웃에서만 사용하려는 변수나 함수가 있다면 _main.php 를 추가합니다. 다음은 _main.php 를 추가한 레이아웃입니다. _main.p..
관리자님 , 열람 : 4901 ㆍ2011.02.01 1 0
(4) CSS/자바스크립트 관리
레이아웃의 공통 css 및 js 파일은 _main.css 와 _main.js 입니다. 이 두 파일은 어떠한 경우라도 레이아웃 폴더안에 존재해야 합니다. 그런데 메인레아웃인..
관리자님 , 열람 : 4957 ㆍ2011.02.01 0 0
(3) 이미지/미디어파일 관리
레이아웃을 만들면 대부분 해당 레이아웃에서 사용되는 이미지파일이나 플래쉬파일들을 같이 만들기 마련입니다. 이러한 미디어파일들은 레이아웃 폴더 밑의 image 폴더에 담아두게 되는..
관리자님 , 열람 : 4748 ㆍ2011.02.01 0 0
(2) 메인/서브레이아웃 만들기
레이아웃은 메인레이아웃(main.php) 와 서브레이아웃으로 구분됩니다. 메인레이아웃은 반드시 존재하야 하는 레이아웃으로 레이아웃의 최소단위입니다. 그러나 레이아웃 작업을..
관리자님 , 열람 : 13786 ㆍ2011.02.01 1 7+1
(1) 레이아웃폴더 만들기
레이아웃을 만들기 위해서는 먼저 레이아웃 폴더를 만들어야 합니다. mylayout 이라는 폴더를 만들어 보겠습니다. 그리고 이 레이아웃의 이름을 "나의처음레이아웃" 이라 하겠습..
관리자님 , 열람 : 6163 ㆍ2011.02.01 3 0
레이아웃제작 방법론
레이아웃을 제작하기에 앞서 짚어볼 것들이 있습니다. 다음은 레이아웃을 만들기 전에 먼저 생각해봐야할 사항들입니다. 1. 메뉴를 자동으로 출력할 것인가? 2. 서브 레이아..
관리자님 , 열람 : 5993 ㆍ2011.02.01 4 1
처음페이지이전 10 페이지123다음 10 페이지마지막페이지