Docs

대시보드 위젯은 관리자페이지 대시보드 화면에 삽입되는 확장요소입니다. 복수의 관리자들은 자신만의 대시보드 위젯을 설정하여 관리자 페이지의 대시보드를 꾸밀 수 있습니다. 이 확장요소는 다른 요소들과 달리 대시보드 모듈에 속한 전용 위젯입니다.

위의 구조는 일반적인 대시보드 위젯 폴더구성이며 파일명은 위의 구조를 따라야 합니다. main.php , var.php 는 필수파일이며 나머지는 옵션입니다.

이 과정은 어떤 샘플도 없는 상태에서 대시보드 위젯을 개발해 가는 과정을 담고 있습니다.
대시보드 위젯에 대한 구조파악이 된 후에는 위젯 샘플을 다운로드 받아 개발하면 더 빠르게 개발할 수 있을 것입니다.

위젯폴더는 영문 대소문자를 포함하여 폴더명으로 사용가능한 모든 문자(한글제외)를 사용할 수 있으나 가능하면 영문소문자를 권장합니다. 다음과 같이 폴더와 파일들을 생성합니다.(파일은 반드시 UTF-8로 생성)

아래에서 단계별 샘플 위젯을 다운로드 받을 수 있으나 샘플을 다운로드 받기 전에 가능한 수차례 위젯 폴더구조를 직접 만들어 보시길 권해드립니다. 몇차례 위젯 폴더와 파일들을 만들어보면 구조를 이해하는데 도움이 될 것입니다.

이 페이지 하단에서 샘플파일을 다운로드 받아 압축을 푼 후 다음의 파일들을 확인해 보세요. 각각의 파일들에 대한 역할을 자세히 숙지하시기 바랍니다.

/mywidget/name.txt - 위젯 명칭을 입력합니다.

내 위젯

/mywidget/main.php - 위젯 메인파일입니다.

위는 시스템 환경에 대한 대시보드 위젯의 샘플 소스코드입니다.

/mywidget/main.css - 위젯 메인파일 전용 css 입니다.

대시보드는 위와같이 #rb-dashboard 로 접근할 수 있습니다.

/mywidget/var.php - 위젯 변수파일입니다.

위젯 변수파일은 필수파일이며 위의 3개 변수항목을 지정해 주어야 합니다. 더보기 링크가 있을 경우 지정해 주며 없을 경우는 공백으로 둡니다.

언어셋 파일구조

디폴트(DEFAULT)언어를 결정합니다.
기본이 되는 언어를 어떤 것으로 할지 정해야 합니다. 시스템 언어를 한국어로 설정했는데 사용된 위젯이 한국어를 지원하지 않는다면 해당 위젯은 정상적으로 출력되지 않을 것이기 때문입니다. 따라서 한국어든 영어든 일본어든 DEFAULT 언어셋을 지정한 후 타 언어셋을 추가해 주어야 합니다. 반드시 다음과 같이 언어폴더를 추가해야 합니다.

언어셋 파일 작성방법

언어셋 파일은 중복을 피하기 위해 반드시 다음과 같은 방식으로 작성해야 합니다. 언어셋 변수는 반드시 $lang 을 사용해야 합니다.

언어셋 호출방법

언어셋을 실제로 사용하기 위해서는 반드시 _LANG() 함수를 사용해야 하며 특수한 경우 변수 자체를 사용할 수도 있습니다.

언어셋 인클루드 방법

언어셋이 포함된 위젯일 경우 자동으로 인클루드되어 main.phpvar.php 에서 _LANG() 함수를 사용할 수 있습니다.

  1. 1. 샘플위젯1 코드보기 다운로드
  2. 2. 샘플위젯2 코드보기 다운로드
  3. 3. 샘플위젯3 코드보기 다운로드

대시보드 설치파일은 반드시 rb_dashboard_위젯폴더명.zip 이어야 합니다. 개발한 대시보드 위젯폴더가 mywidget 일 경우 우선 mywidget.zip 으로 압축한후 rb_dashboard_위젯폴더명.zip으로 파일명을 변경합니다. (주의) 압축파일인 rb_dashboard_위젯폴더명.zip 의 압축을 풀었을때 mywidget 폴더가 생성되면 안되며 mywidget 폴더내의 파일들이 최상위에 풀려야 합니다. 대시보드 위젯폴더는 Rb에 설치되는 과정에서 자동으로 생성됩니다.


Back to Top