zeroboardXE Manual

3. Template Handler

Thu, 28 Aug 2008 09:31:55 +0900

Template Handler
1. 템플릿 문법

Template Handler^#

http://doc.zeroboard.com/classTemplateHandler.html (class 구조)

제로보드XE는 몇 가지 특별한 기능을 사용하기 위해서 자체 Template 엔진을 이용합니다.
smarty등의 Template 엔진처럼 정해진 문법으로 작성된 템플릿 파일을 PHP 파일로 컴파일 후에 include만 하기 때문에 효율적으로 동작하게 됩니다.

클래스 파일 위치 : ./classes/template/TemplateHandler.class.php
동작방법
- 인자로 넘겨받은 template_path, template_filename을 이용하여 템플릿 파일을 찾음
- 해당 템플릿 파일이 있다고 판단되면 컴파일된 파일을 찾음
  (컴파일된 파일의 위치 : ./files/cache/template_compiled/{md5(path+filename}.compiled.php)
- 컴파일된 파일이 없으면 source template file을 읽은후 parsing, 파일로 저장
- compiled template file을 include
템플릿 파일로 변수 할당하기
- 템플릿을 지정하기 전에 Context::set('변수이름', $변수) 와 같은 방법으로 context setting을 하게 되면 템플릿에서는 {$변수이름}과 같이 세팅된 변수를 사용할 수 있습니다.

템플릿 문법^#

변수의 내용 출력 및 함수의 결과물 출력
{와 $ 사이의 space character나 개행문자등이 없이 붙어 있어야 합니다.
1. {$변수이름}
  {$변수이름[key]}

함수 또는 변수의 설정
{와 $ 사이에 @ 를 붙이면 결과를 return하지 않습니다.
이 특징을 이용해서 변수설정이나 함수의 실행, php코드 사용을 할 수 있습니다.
1. {@ $a = 1}
  {@ print $a}
조건절의 사용 (if)
1. 
  ...
  
  ...
2. 
3. ...

조건절의 사용 (switch)
이 문법에는 문제가 있으니 사용에 주의해주시기 바랍니다. 개선토록 하겠습니다.

...
...

switch문은 아래와 같은 예외적인 문법을 제공합니다.

'@break@case(...)' => 'break; case(...) :'

'@break@default' => 'break; default :'

...


...

...

foreach, for등의 반복문 사용
1. 
  {$key} - {$val}
  
2. 
  {$i}

다 른 template 파일 include
template 파일 내에서 다른 template파일을 include할 수 있습니다.
이때 경로를 지정하지 않으면 현재의 template file의 위치에서 찾고 없으면 ROOT부터 찾아나갑니다.

css 파일 import
css파일을 사용하고자 할때 아래 문법을 이용하면 html 태그의 <head> .. </head> 사이에 link code가 추가 됩니다.
이때 경로를 지정하지 않으면 현재의 template file의 위치에서 찾고 없으면 ROOT부터 찾아나갑니다.
1.

js 파일의 import
js파일을 사용하고자 할때 아래 문법을 이용하면 html 태그의 <head> .. </head> 사이에 <script type="text/javascript" src="js파일"></script> 코드가 추가됩니다. 이때 경로를 지정하지 않으면 현재의 template file의 위치에서 찾고 없으면 ROOT부터 찾아나갑니다.
1.
xml js filter파일의 import
xml js filter를 사용하고자 할때 아래 문법을 이용하면 지정된 필터를 컴파일하고 해당 문서에 필터를 적용하게 됩니다.
이때 경로를 지정하지 않으면 현재의 template file의 위치에서 찾고 없으면 ROOT부터 찾아나갑니다.
1.

주석
HTML에 출력하지 않도록 감출 수 있습니다.
1.

기타 경로에 대한 처리 template에서 이미지 태그의 src값이 http:// 나 / 로 시작하지 않는다면 해당 템플릿이 요청된 path에서 찾도록 합니다. 작업PC에서 스킨등의 작업을 하고 그대로 서버에 올리면서 테스트하실 수 있습니다.

댓글알리미 모듈(tccommentnotify)

Sat, 23 Aug 2008 18:39:42 +0900

이 페이지에서는 1.0.5에 추가될 댓글알리미 모듈(tccommentnotify)에 대해 설명합니다.

댓글알리미 모듈(tccommentnotify)

댓글알리미 모듈은 댓글알리미 모듈이 설치된 zbXE나 텍스트큐브에서 작성된 자신의 글에(홈페이지 주소가 정확히 기재되어 있어야 함. 로그인 후 작성했다면, 회원정보에 홈페이지 주소가 정확해야 함.) 댓글이 달릴 경우 댓글 알리미에서 그 내용을 볼 수 있고, 링크를 통해서 다시 그 페이지로 이동할 수 있습니다.

12. 댓글알림 애드온(tccommentnotify)

Sat, 23 Aug 2008 18:36:11 +0900

이 페이지에서는 1.0.5에서 추가될 댓글알림 애드온(tccommentnotify)에 대해 설명할것 입니다.

댓글알림 애드온

댓글알림 애드온은 zbXE 1.0.5버전부터 추가된 댓글 알리미 모듈이 정상적으로 댓글을 수집할 수 있게 해줍니다.

이 애드온을 사용으로 설정 하면, 댓글 알리미가 설치된 zbXE나 텍스트 큐브 등으로 만들어진 사이트에서 자신이 작성한 글에 댓글이 달렸을 때, 댓글 알리미 모듈에서 확인할 수 있게 됩니다.

사용법은 일반적인 애드온 사용법과 동일합니다.

관리형 모듈 > 애드온으로 접속하여서 댓글알리미 애드온을 사용으로 설정합니다. 설정 방법은 미사용이라는 글자가 있을 경우 그 글자를 클릭하시면 됩니다. 아래 그림과 같으면, 사용중 입니다.

다. 메뉴관리를 통한 메뉴 생성

Sat, 23 Aug 2008 17:56:33 +0900

메뉴관리 : 홈페이지의 주메뉴와 서브메뉴를 만들 수 있는 공간이며, 만들어진 메뉴에 게시판이나 페이지,링크걸기등을 할 수 있다.

zbXE는 메뉴관리에 메뉴를 생성하고 설정을 잡아주면 생성된 메뉴 그대로 홈페이지에 적용되기때문에
이전에 일일이 텍스트로 입력하여 메뉴를 만들고, 운영중에 메뉴가 수정되면 일일이 바꿔주었던 그런 시간소모적인 작업이 더이상
필요하지 않게 되었습니다.
그래서 사용법만 숙지하시면 기본형 사이트는 30분만이라도 뚝딱하고 만들수가 있습니다. ^^

새로운 메뉴 생성

관리자페이지 접속 -> 좌측 " 메뉴 " 클릭 -> 생성 클릭
생성을 클릭했을때 나오는 화면

메뉴 하나가 하나의 사이트를 만들 수 있다고 생각하면 된다.
따라서 메뉴관리에서 "생성"으로 만들게 되는 메뉴의 제목은 사이트명으로 지정해 주면 나중에 혼동을 예방 할 수 있다.
새롭게 만들어진 메뉴를 설정 할 수 있는 화면이다.

⑴ 해당 메뉴(사이트명)을 변경 할 수 있다.
⑵ 메뉴를 추가 할 수 있다. (4번에서 자세한 설명을...)
     - 메뉴 옮기기 부분에 체크를 하면 마우스로 만들어진 메뉴를 드래그앤드롭으로 메뉴위치를 조정 할 수 있다.
⑶ 만들어진 메뉴의 하위메뉴가 있을경우 모두 펼침상태로 만들거나, 모두 닫힘 상태로 만들 수 있으며
     만들어진 메뉴의 캐시파일을 새롭게 재 생성 할 수 있다.
     캐시파일 재생성이란 메뉴설정값은 따로 저장이 되는데 이 값이 제대로 갱신이 되지 않으면, 새롭게 변경한 값들이
     제대로 출력이 안 될 수 있다.
     그럴경우 캐시파일 재생성을 눌러서 새롭게 변경된 값의 캐시파일을 만들어 정상적인 결과물을 확인 할 수 있다.
메뉴를 추가해 보자.

⑴ 메뉴명 : 메뉴명을 입력한다. 홈페이지에 직접 사용될 메뉴명을 입력해야 한다.
                 이곳에 입력하는 메뉴명이 홈페이지에서 최종적으로 보여지는 메뉴명이다.
                 (게시판이나, 페이지를 만들경우 꼭 메뉴명과 동일하게 만들지 않아도 된다.)
⑵ 연결url : 미리 게시판이나 , 페이지가 만들어져 있다면 " mid찾기 " 를 통해서 원하는 게시판이나 페이지를 해당 메뉴에 연결 할 수 있다.
                   연결URL을 통해서 처리 될 수 있는 것들...
                    a. 게시판(목록형,웹진형,갤러리형)
                    b. 페이지
                    c. 블로그
                    d. 링크 ( http://jobdahan.net 이라고 입력하면 해당 사이트로 이동한다.)
                    e. 기타 모듈 - 모듈id값을 연결해 주면 된다.
⑶ 새창열기 : ⑵ 연결url 에서 설정되어진 값을 새창으로 열게 할것인지 설정하는 부분이다.
⑷ 펼침 : 해당 메뉴에 하위메뉴가 있을수 있는데 하위메뉴가 있을경우 펼쳐진 상태로 보이게 하는 옵션이다.
  ⑸ 이미지버튼 : 해당 메뉴를 이미지버튼으로 처리할 수 있다. (현재 활성화된 기능이 아님)  ⑹ 그룹제한 : 화면에서 보시는바와 같이 기본적으로 설치후 "정회원", "준회원","관리그룹"이란 3개의 그룹이 만들어 진다.
                      이러한 그룹은 추가,수정,삭제가 가능하다.
                      본 그룹제한은 연결될 메뉴의 모듈권한설정과 잘 조정을 하면 다양한 형태의 접근 기능을 활용 할 수 있다.
⑺ 저장 : 설정이 제대로 되었으면 저장 버튼을 눌러서 메뉴 생성을 완료하자.
기본메뉴 셋팅을 위한 메뉴 정리 Home

회사소개               // 회사 소개 클릭시 인사말이 처음 나오도록 함.
    - 인사말             // page 모듈사용
    - 연혁                // page 모듈 사용
    - 현황                //  page 모듈 사용
    - 주요실적        //  갤러리 모듈 (게시판 하나에서 해당 게시판을 리스트형으로 할것인지 갤러리 형으로 할것인지 설정이 가능함)
    - 오시는길          //  page 모듈 사용
사업분야              // 하위메뉴가 없는 형태. page 모듈 사용
Recruit                // recruit 메뉴를 클릭하면 모집요강이 나오도록 함.
    - 모집요강        // page 모듈 사용
    - 온라인접수       // 목록형 게시판 모듈 사용 고객센터              // 고객센터 클릭시 공지사항이 나오도록 함.
     - 공지사항        //  목록형 게시판 모듈 사용
     - 비지니스 동향 // 웹진형 게시판 모듈 사용
     - 고객문의         // 목록형 게시판 모듈 사용
     - FAQ               //  page 모듈 사용
Sitemap             // page 모듈 사용
------------------------------------------------------------------------------
  이정도의 메뉴를 구성해보자.
현재 zbXE에서 제공되고 있는 기본 모듈을 실제 연결해 보기 위해 임의적으로 메뉴를 설정한것이며
위와 같은 메뉴구성은 자신이 만들고자 하는 사이트의 형태와 기능에 따라 각자 지정해 주면 된다.
기본 메뉴 세팅해 보기

일단 연결url 이나 기타 설정엔 신경을 쓰지 말고 메뉴명만 입력하도록 한다.
위 설명에서 만들어진 메뉴를 확인하고 제목을 클릭하면 해당 메뉴에 대한 설정 화면을 다시 확인 할 수 있다.
⑴ 설정변경을 원하는 메뉴 제목클릭

⑵ 추가 버튼 클릭하고 메뉴명 입력한 다음 저장하기

위 그림의 1번 2번 순서대로 입력을 하고 저장을 하면 메뉴가 만들어 진다.
첫번째 메뉴로 Home 메뉴를 만들었다.

⑶ 두번째 메뉴로 회사소개를 home메뉴와 동일하게 만든 다음 회사 소개 하위 메뉴로 인사말을 만든다.

위 그림에서 보듯이 두번째 메뉴인 회사소개를 만들고 회사소개를 클릭하면 위 그림2번에서 처럼 메뉴명에 회사소개라고 나온다.
이때 하단 부분 3번을 보면 하부메뉴추가가 나온다.

즉, 하부메류를 추가하고 싶은 메뉴를 메뉴트리에서 먼저 선택을 하고 하부메뉴추가를 클릭하면 해당 메뉴에 대한 하부 메뉴가 생성되는 것이다.

위 그림에서 볼 수 있듯이 상위메뉴명 : 회사소개 가 되어 있고 그 아래 메뉴명으로 인사말이 되어 있는 것을 확인 할 수 있다

⑷주메뉴와 주메뉴에 대한 서브메뉴를 만들면 아래와 같은 형태가 된다.

이제 이렇게 만들어진 메뉴에 연결할 대상을 한번 만들어 보자.
연결대상의 속성은 위 메뉴정리 할 때 주석형태로 부연 설명을 해두었다.

나. 관리자페이지 접속 및 간단소개

Sat, 23 Aug 2008 17:44:57 +0900

정상적으로 설치를 완료 한 뒤 이젠 본격적으로 zbXE를 구경해 볼까요?

zbXE의 핵심부분인 관리자 페이지에 접속을 하고, 관리자페이지를 간략하게 살펴보도록 하겠습니다.

관리자 페이지 접속 방법

자신의 도메인 주소에 /?module=admin 이라고 덧붙혀 입력하면 아래와 같은 로그인 창을 확인 할 수 있습니다다.
⑴ http://aaa.com/zbxe/admin (rewrite mod 지원시)
⑵ http://aaa.com/zbxe/?module=admin (rewrite mod 미 지원시)
ex > http://자신의 도메인주소 /?module=admin

2. 관리자 페이지 간단 소개

⑴ zeroboard XE 로고를 클릭하면 관리자페이지 처음으로 오게됩니다.
현재 위에 보이는 화면.

⑵ logout : 관리자 페이지는 보안유지가 필수입니다. 접속한뒤 사용을 마치고 나서는 반드시 로그아웃을 하시기 바랍니다.

     ⑶ 주요관리 메뉴
         가. 서비스형 모듈 :
              게시판 ,통합검색, 라이프팟 연동,회원, 외부페이지,페이지,스프링노트연동과 같은 모듈들을 컨트롤 할 수 있는 공간입니다.
              홈페이지에 게시판을 달거나 , 페이지를 만들어 꾸밀때 이곳을 이용해야 하죠.
              zbXE관리자 페이지에서 가장 많이 이용하게 되는부분중 하나일것입니다.
              검색을 해도 검색결과가 없을경우 서비스형 모듈의 통합검색에서 검색할 대상을 지정해 주었는지 확인해 보셔야 합니다.^^

         나. 관리형 모듈 :
              애드온, 레이아웃,메뉴,위젯 등을 관리 하는 메뉴입니다.
              zbXE로 처음 홈페이지를 만들때 관리형 모듈의 "메뉴"   부분을 가장 먼저 만들게 됩니다.
              애드온은 홈페이지에 zbXE의 부가적인 기능이라고 생각하시면 되겠습니다.
              레이아웃은 쉽게 생각해서 홈페이지 스킨이라고 생각하시면 되겠습니다.
              위젯은 zbXE의 특정기능만 뽑아내서 보여주거나, 특정기능을 사용할 수있게 해주는것입니다.


         다. 기능성모듈 :
              댓글,문서,위지윅에디터,첨부파일, 엮인글을 확인 할수 있습니다.

         라. 부가모듈 :
              기본카운터, 제로보드 데이터 이전, 한국 우편번호, 포인트 시스템, 설문조사, 레퍼러통계, 스팸필터등이 있습니다.

         마. 기본모듈 :
              오류표시, 모듈 이 현재 있습니다.
              중요!
           기존에 zbXE를 사용하다가 새로운 버전이 나와서 업데이트 할때 반드시 모듈 부분을 확인해 주시기 바랍니다.
           기존에 제공되던것에서 변경된것이 있으면 모듈 부분을 클릭해 보면
           설치, 업데이트 란 메시지가 보일때가 있습니다.
           그럴때는 업데이트 설치를 먼저 누르고, 다음으로 업데이트를 눌러서 변경사항을 반영시켜 주어야
           해당기능을 정상적으로 이용하실수 있습니다.

이상으로 간단하게 zbXE 관리자 페이지를 살펴 보았습니다.

관리자 페이지의 세부적인 매뉴얼은 별도로 작성된 매뉴얼 페이지를 이용하시기 바랍니다.

본 매뉴얼은 매뉴얼 시작하기전에도 말씀드렸다 시피 전체적인 흐름을 알려드리기 위한 매뉴얼 입니다.^^

다음 진행사항은 메뉴관리에 대해서 살펴볼것입니다.
본 메뉴얼의 순차적인 설명에 있어 포인트가

매뉴관리 -> 레이아웃관리 -> 모듈설정(게시판설정,페이지설정)-> 메뉴연동

임을 확인 하시고 다음 매뉴얼을 확인해 보죠.

이젠 슬슬 사이트 만들기 시동을 걸어 볼까요 ^^

가. 다운로드 및 설치하기

Sat, 23 Aug 2008 17:41:53 +0900

http://www.zeroboard.com/zbxe_download 다운로드 게시판

zbXE 공식 사이트에서 제공되는 zbXE 프로그램은 크게 두가지 형태의 파일 유형으로 제공이 됩니다.

아래 두종류의 파일 형태중 자신이 사용하기 편한 형태의 파일을 다운 받아 설치 준비를 하면 됩니다.

zip 파일 형태 : zbxe.1.0.5.zip

- 우리가 알고 있는 알집(http://www.altools.co.kr/product/alzip_intro.aspx)과 같은 압축 프로그램으로 압축을 푼 뒤 자신의 계정에 업로드 하면 됩니다.
tar 파일 형태 : zbxe.1.0.5.tgz

- 다운을 받은뒤 ftp 프로그램으로 서버에 해당 파일을 그대로 업로드 한 뒤 서버 계정에 접속하여 압축파일을 풉니다.
자신의 계정에 업로드 하는 방법
- 홈페이지 서비스를 하기 위해선 호스팅계정이나 자신의 서버에 계정이 있어야 합니다.
- 이러한 계정에 접속하기 위해선 아이디와 패스워드가 필요합니다.
- 호스팅 신청시 ftp로 계정 접속이 가능한 아이디와 패스워드를 알려 주는데 이를 이용하여 ftp 접속을 합니다.
- 설명의 편의를 위해 알ftp로 접속하는 방법을 설명을 하겠습니다.

⑴ 사이트 이름 : 알ftp에서 현재 계정 접속을 구분하기 위해 자신이 알맞은 이름을 정해줍니다. (아무거나 정해줘도 상관없음)

      ⑵ ftp주소 : 자신의 도메인 주소를 적습니다. (무료 호스팅에서 제공받은 2차 도메인 역시 마찮가지로 적습니다.)
      ⑶ 사용자 ID : 호스팅 계정 아이디는 입력합니다. ( 모르면 호스팅 회사에 물어보자. -.-;;)
      ⑷ 비밀번호 : 호스팅 계정 비밀번호를 입력합니다. (역시 모르면 호스팅 회사에 물어보자. )

위 순서대로 접속해서 파일을 업로드 하면 아래와 같이 자신의 계정에 파일이 올려진것을 확인 할 수 있습니다.

참고로 전 tar 파일 형태를 알ftp로 업로드 하고 서버에서 압축을 푸는 방법으로 진행하고 있습니다.

ftp접속과 DB접속은 개념이 다르다.
대부분의 호스팅 회사가 사용자계정정보와 DB계정 정보를 동일하게 제공하는데(머리아프니까...간단하게..)
간혹 다르게 제공하는 곳도 있습니다.
그럴경우 자신의 ftp접속시 사용되는 아이디와 패스워드와 , DB 접속을 위한 정보를 확실히 알아 두어야 합니다.
DB에 관해 얕은 지식으로 인해 본 메뉴얼에선 Mysql 기준으로 설명을 하겠습니다.

알ftp에서 위 설명과 같이 접속을 할 수 있듯이, 사용자 DB에서 접속이 가능합니다.
쉽게 생각해서 알ftp로 접속하여 html파일이나 이미지 같은것을 올릴 수 있다고 생각하면 되고,
DB는 게시판과 같은 프로그램을 통해서 저장되는 내용을 관리하는 것이라 생각하면 됩니다.
Mysql접속은 접속 프로그램이 따로 있죠.
손쉽게 구할 수 있는 putty 라는 프로그램을 통해서 어떻게 접근하는지 설명을 하기로 하겠습니다.
mysql -u zbxemenual -p zbxemenual
passwd : ********

위에껄 설명을 하면
mysql -u 유저명 -P 디비명
passwd : 디비접근 패스워드
이렇게 생각하면 됩니다.

자세한 내용은 아래에서...

4. 계정에 업로드 된 tar 파일 압축 풀기 및 퍼미션 조정

- 설명의 편의를 위해 putty라는 프로그램을 이용합니다.
(http://download.zdnet.co.kr/pds/detail_view.html?id=6226 에서 다운로드 하면 된다.-프리웨어)

- 다운받아 실행을 하면 아래와 같은 화면이 뜬다.
다운 받으면 이렇게 생긴 아이콘을 확인 할 수 있는데 더블클릭하면 된다.

     ⑴ 자신의 도메인이나 아이피를 적습니다.
     ⑵ 자신의 호스팅 계정에서 지원되는 protocol을 확인한뒤 선택해 줍니다.
         telnet이나 ssh를 접근 허용해 주는 곳이 요즘은 많기 때문에 자신이 신청한 호스팅회사에 문의하거나 자신의 호스팅상품 사양을 확인하면 됩니다.
         (텔렛, ssh 지원 - 이런식으로 되어 있습니다.)

⑶ open 버튼을 누릅니다.
⑷ 경고창이 하나 뜨는데 ..그냥 예 누르면 됩니다. ㅡㅡ;;

⑸ 아래와 같은 putty 로긴 화면을 접할 수 있을 것입니다..

        아이디 입력후 엔터 ^^

⑹ 이젠 패스워드를 입력하자. (너무 자세하게 설명하는가 ? 그래도 가끔 이런걸 물어오시는 분들이 있다. )

⑺ 아이디와 패스워드가 정확하게 맞았다면 아래와 같은 화면을 볼 수 있을 것입니다.

    ⑻ 이젠 이렇게 접속 하였을때 우리는 몇가지 명령을 처리하고 빠져 나갈것입니다.
       이러한 프로그램이 익숙하지 않은 사람에겐 이런 프로그램 만지는것 조차 낯설기때문에 딱 필요한것만 하고 나가죠. ㅡ.ㅡ;;

       ls 라고 입력한뒤 엔터를 치면 아래와 같이 보입니다.
     (ls명령어는 해당 위치의 폴더 및 파일 정보를 확인 할 수 있다.)
     알ftp로 계정에 업로드 시켜 놓은 zbxe.버전.tgz 가 보입니다
     zbxe.버전.tgz는 앞서도 설명했듯이 zbxe 프로그램을 압축해서 제공하는 압축파일명이다.
     따라서 버전에 따라 이 이름은 달라 질 수 있다.
     (본 메뉴얼과 자신이 받은 파일이 이름이 틀리다고 질문하지 마시길... ^^)

    ⑼ ls 명령으로 해당 위치에 압축파일이 있음을 확인을 했는데 알 ftp접속 화면과 비교해서 확인해 볼까요?. (친절도 하셔라...ㅡ.ㅡ;;)
        putty접속으로 zbxe.버전.tgz 파일과
        알ftp 접속으로 zbxe.버전.tgz 파일을 확인 할 수 있습니다.
       즉, 접속 프로그램이 다르다는것이지 현재 동일한 계정의 동일한 위치를 보고 있는 것입니다.

   ⑽ ls 명령 다음엔 뭘할까 ? 이젠 위에서 확인한 zbxe.버전.tgz 압축파일을 압축을 풀어 보겠습니다.
       압축을 풀어 주는 명령은 아래와 같이 입력하고 엔터 치면 된답니다.
       tar xvfz zbxe.버전.tgz

   ⑾ 압축이 좌~악 하고 풀리죠?
      압축이 풀리고 나서 다시 ls 명령으로 확인해 보면.
       zbxe 라는 새로운 폴더가 하나 생겼을 것이다.

⑿ zbxe설치시 퍼미션을 조정해 주라고 하는 부분이 있는데 이젠 그 퍼미션 조정을 끝으로 1차 작업을 마칩니다.
chmod 707 zbxe

     즉, ls 해서 위에서와 같이 zbxe 폴더가 있는것이 확인되었기에 chmod 707 zbxe 명령으로 퍼미션이 조정 가능한 것입니다.
     위 명령어를 해석하면
     " 현재 위치의 zbxe 폴더 퍼미션을 707로 변경하라 " 라는 뜻입니다.

⒀ 이젠 모든 작업이 끝났다. 해당 서버계정에서 나가기만 하면 된다.
나갈려고 할때는 간단히 exit 라고 입력한뒤 엔터 치면 된다.

그럼 putty 화면이 사라질 것이다.

지금까지 작업을 마치고 알ftp로 다시 자신의 계정에 접근해 보자.
아래 그림과 같이 zbxe라는 노란 폴더가 보일 것이다.

5. zbXE 본격적으로 설치하기. (mysql 기준으로 설명)

- zbXE 를 설치하기 위해선 기본적으로 환경적인 부분이 뒷받침 되어야 합니다.
- 설치 환경 알아 보기 [바로가기]

     ⑴  초기 설치 화면 접근은
           -  http://자신의 도메인/zbxe  이다. 이렇게되는 것은 지금껏 설명한 과정을 따라한 분이라면 동일합니다.
           - 즉, 자신의 계정 홈디렉토리에 zbxe라는 폴더가 만들어져 있는것이다. (위에서 알ftp화면까지 캡쳐해서 보여주고 있다.)

자~ 이제 시작해 볼까!

"라이센스에 동의합니다" 라는 버튼을 클릭한다. zbXE는 GNU라이센스를 따릅니다.

      ⑵ 필수 설치 조건을 확인 해 볼까요?

      위 화면처럼 모든 부분에 "가능" 으로 출력이 되면 설치를 진행하면 됩다.
      두번째 나오는 퍼미션 부분이 위에서 설명한 chmod 707 zbxe로 처리한 부분이 되겠죠.
필수 설치조건은 호스팅계정의 서버 설정과 관계 되는 부분이기때문에 혹시 이부분에서 문제가 생기는 분들은
   호스팅회사에 문의하시길....

⑶ 사용하려는 DB를 선택하라는 화면이 나옵니다.
          - mysql

        - mysql_innodb
          - sqlite2
          - sqlite3_pdo
        DB에 대한 지식이 짧아 두개의 차이점을 잘 모른다. 그냥 mysql을 선택하고 설치를 진행하겠습니다.

    ⑷  DB 및 관리자 정보를 입력합다.
         - DB 아이디 : 자신의 DB 아이디를 입력합다.
         - DB 비밀번호 : 자신의 DB 비밀번호를 입력합다.
         - DB 데이터베이스 : DB명을 입력해줍니다.
         - 테이블 머릿말 : 기본 xe라고 되어 있는데 그냥두어도 상관없습니다.
        중요 : 여기서 DB아이디 나 DB 비밀번호, DB 데이터베이스 는 이미 정해져 있는 것들입니다.

자신이 마음대로 적어 주는것이 아니라 호스팅계정 신청시 발급받은 정보를 정확히 입력해야 설치가 가능하죠.

보통 호스팅 업체에서 ftp접속 정보를 DB접속 정보와 동일하게 사용하는 경우가 많습니다.

예를들어 ftp접속을
아이디 : zbxe

패스워드 : 1234 라고 부여 받았다고 할때.

그럼 DB접속 정보는

                 - DB 아이디 :  zbxe
                 - DB 비밀번호 : 1234
                 - DB 데이터베이스 : zbxe

이런식으로 되는경우가 많습니다.

    위 그림에서 환경설정 부분의 time zone은 zbxe를 설치하는 사용자마다 자신의 국가별 시간을 설정할 수 있는기능입니다.
    우리나라는 zbXE설치화면에서 디폴트로 보이는 Korea Standard Time을 선택하면 됩니다.
    GMT(Greenwich Mean Time) - 그리니치 천문대 관측 기준... 우리나라는 9시간 차이 ^^

⑸ 설치가 정상적으로 완료되면 아래와 같은 안내 창이 뜹니다.
얼마나 뿌듯한가? 사실 과정은 얼마 안되는데 혹시나 순차적으로 따라하시는 분들을 위해 하나하나 설명하다 보니 좀 길어졌네요^^

어쨌든 정말 감사하죠 ^^

⑹ 확인을 누르면 아래 그림과 같이 설치가 된 화면이 나오게 됩니다. 기본적으로 게시판이 하나가 셋팅되어 보여지게 됩니다.

어슬픈 설명이 오히려 혼동만 가중시킨것은 아닌지 모르겠네요.

아무튼 위 화면을 접하고 있는 수많은(?) 분들은 만세 한번 부르고 다음 메뉴얼로 넘어가보죠^^
설치가 제대로 안되시는 분은 메뉴얼을 순차적으로 계속 확인해 주기 바라며, 문제점은 검색과 질문으로 해결되길 바랍니다.

--

zbxe 정식버전용 매뉴얼 작성완료된 페이지

7. 개발시 주의사항/팁

Sat, 23 Aug 2008 17:40:18 +0900

공통
애드온

이 페이지는 XE관련 프로그래밍에서 일어날 수 있는 여러가지 주의점과 팁을 기재합니다.

공통^#

XE는 크로스브라우징에 대응하기 위하여 자바스크립트와 관련해 x.js의 서브셋을 사용합니다.
- x.js의 사용법과 예제에 대해 알아보기 위해 x.js 공식사이트를 방문하시기 바랍니다.
prototype.js와 같은 추가 라이브러리 사용시 기본 JS파일들과 충돌할 수 있습니다.
excuteQuery는 항상 배열을 반환하지 않습니다. (list_count 미지정시 select 갯수가 한 개라면 $output->data는 해당 데이터에 대한 인스턴스 한개만 리턴합니다.)
- 항상 배열로 반환되는 함수를 사용하기 위해서는 executeQueryArray() 함수를 사용합니다. (1.0.3 이후. 9월 5일 기준 미배포 버전)
echo나 print_r로 log를 출력하게 만들면 상황에 따라서 큰 오류가 일어납니다. 대부분의 경우엔 func.inc.php안에 구현된 debugPrint 함수를 사용하여 디버깅하시기 바랍니다.
0.2.4 버전부터는 이전보다 구조가 많이 변경되어 모듈, 애드온, 플러그인, 위젯 등이 호환이 안됩니다. 따라서 제작자 분들께서는 이에 맞추어 다시 제작해 주시기 바랍니다.

애드온^#

XE의 애드온은 모든 모듈의 여러부분에 삽입되어 지므로 <?php ... ?> 앞뒤에 공백문자가 오지 않도록 주의하시기 바랍니다.
- before_display_content 호출시 오작동이 일어남.
XE 코어는 애드온 프로그래밍시 생길 수 있는 예외상황을 별도로 처리하지 않습니다. 따라서 현재 호출된 상황을 체크하는 루틴이 잘 짜여 있어야 다른 부분과 충돌하지 않습니다.
잘못된 애드온 코딩으로 인하여 사이트가 심각한 오류에 빠진 경우 files/cache/activated_addons.cache.php 파일을 편집하여 다시 업로드 하시면 됩니다.

1. zbXE 다운로드/업로드

Sat, 23 Aug 2008 17:39:09 +0900

zbXE다운로드/업로드 방법
안정화 버전과 개발버전의 차이
파일명에 따른 파일 내용
배포 파일 다운로드
.zip파일과 .tgz 파일

zbXE다운로드/업로드 방법^#

zbXE를 설치 하기 위해서는 FTP를 이용해 업로드 하는 방법과 SVN을 이용하는 방법 2가지가 있습니다. zbXE를 설치하려는 서버가 SVN을 지원하는 경우 zbXE파일들을 바로 서버로 보낼 수 있습니다.

다운로드하기 : 제로보드XE 다운로드 게시판
FTP를 이용한 업로드 : FTP로 업로드 참조
SVN으로 전송하기 : SVN으로 전송하기 참조

안정화 버전과 개발버전의 차이^#

zbXE는 안정화 버전 과 선행 버전 의 두가지 버전으로 제공이 됩니다.

안정화 버전 : 공식(정식) 배포버전 입니다. 모든 테스트 과정을 거쳐서 안정적으로 작동된다고 판단되는 버전입니다.
선행 버전 : 이전 버전의 버그 수정, 새로운 기능의 추가 및 성능 최적화 등 개발이 진행중인 버전으로서 아직 완벽하 게 테스트되지 않은 버전입니다.

어떤 버전을 이용해야 할까?

안정적인 웹사이트 구축을 원해! → 안정화 버전

새로운 추가기능과 버그 수정을 빨리 이용하고 싶어~! → 선행 버전

파일명에 따른 파일 내용^#

zbXE는 최대 6개 정도의 파일을 제공하고 있습니다.

zbxe.버전.zip : 전체 파일이 zip으로 압축되어 있습니다. 내 컴퓨터에서 압축을 해제하여 계정에 올리는 방법으로 사용합니다. 파일의 수가 매우 많기 때문에, 오류가 나지 않도록 주의하셔야 합니다.
파일명의 일부분에 버전번호를 포함하고 있습니다.

zbxe.버전.tgz : 계정에 올린 후, 리눅스 셸로 압축을 해제할 수 있는 파일로서, 파일의 버전명도 함께 포함하고 있습니다

zbxe.버전.changed.zip : 이전 버전에서 최신 버전으로 수정된 파일만 변경합니다. (단, 사용시 바로 직전버전에서 업그레이드 합니다.)

zbxe.버전.alpha.zip : 선행버전시에 배포되는 파일로, 새로운 기능이나 버그 등을 수정 후 개발자들이 제한된 환경에서 테스트를 거쳤을 뿐 다양한 환경에서 올바르게 동작함을 보장하지 못할 수 없을 때 배포됩니다. 파일의 버전명을 표시하고 있습니다.

zbxe.버전.alpha.tgz : 선행버전시에 배포되는 파일로, 계정에 올린 후, 리눅스 쉘로 압축을 해제할 수 있는 파일로서, 파일의 버전명도 함께 포함하고 있습니다.

zbxe.버전.alpha.changed.zip : 선행버전시에 배포되는 파일로, 이전 정식버전에서 선행버전으로 수정된 파일만 변경합니다. (단, 사용시 바로 직전 버전에서 업그레이드 합니다.)

배포 파일 다운로드^#

zbXE는 제로보드 공식 홈페이지에서 다운로드할 수 있습니다.

zbXE는 오픈소스로 제공되기 때문에, 제로보드 공식 홈페이지 이외의 사이트에서도 zbXE를 수정하여 배포 할 수도 있습니다.

이 경우 버그 수정 등의 기술 지원은 해당 배포자를 통해 이루어져야 합니다.

제로보드 공식 사이트에서는 공식 사이트에서 배포하는 버전에 대한 업그레이드 및 기술지원만 이루어집니다.

.zip파일과 .tgz 파일^#

zbXE는 .zip과 .tgz 의 두 가지 압축 형태로 제공됩니다.

리눅스 셸 명령어를 이용하실 수 있는 분들은 .tgz 파일을 다운로드 받으셔서 계정에 올린 후 압축을 푸시는 것이 편리합니다.

일반적인 윈도우 환경에서 세팅을 하시려면 .zip 파일을 받으셔서 압축을 푸신 후에 모든 파일을 FTP를 통해 업로드하시면 됩니다.

tgz 파일을 이용하는 방법은 계정에 올리기 에서 확인하실 수 있습니다.

01. 사용자 환경 확인

Sat, 23 Aug 2008 17:35:13 +0900

zbXE는 설치형 프로그램입니다.
zbXE 설치환경을 확인해보세요.
지원 브라우저를 확인하세요.

zbXE는 설치형 프로그램입니다.^#

따라서 설치를 할 수 있는 계정이나 서버가 필요합니다.

계정을 구할 수 있는 방법은 호스팅업체를 통해 유/무료로 계정 제공을 받을 수 있습니다.

혹은 자신의 컴퓨터를 직접 서버로 구축하여 운영할 수도 있지만 이럴 경우 늘 컴퓨터를 켜두어야 한다든지 하는 문제점들이 있을 수 있습니다.

계정정보 게시판에서 계정을 제공하는 업체/개인등에 대해서 확인해 보세요.

zbXE 설치환경을 확인해보세요.^#

각 호스팅사나 계정 제공 홈페이지에 zbXE의 설치가능 여부가 명시되어 있을 수 있습니다.

그러한 명시가 없다면 아래 사항을 확인해 주세요. 대개 제공 서비스의 상세 내용에 기재되는 내용이지만, 만약 기재되지 않은 경우엔 각 서비스 제공업체의 고객센터 등에 문의하시기 바랍니다.

zbXE는 아래와 같은 환경에서 설치/작동합니다.

PHP 4.x 또는 PHP 5.x (단 PHP 5.2.2는 PHP의 버그로 인하여 설치가 불가능합니다)
- XML 라이브러리 (필수)
- ICONV (선택. 다만 특정 기능에서 이상현상을 보일 수 있습니다)
- GD (필수. 이미지 변환 기능을 위해 필수입니다)
  - zbXE 1.1.0 이후 버전에서는 PHP 5.2 이상에서 지원될 예정입니다.

DATABASE
- MySQL 4.1 이상 : UTF-8을 사용하기 위해 MySQL은 4.1 이상만 지원합니다. (4.0 불가능)
- Sqlite2 or Sqlite3 : Sqlite를 사용하기 위해서는 PHP에 Sqlite extension이 설치되어 있어야 합니다.
- Cubrid
- PostgreSQL

설치 환경을 직접 확인하는 방법은 02. 사용환경을 참고하세요.

지원 브라우저를 확인하세요.^#

zbXE는 웹표준을 준수하며 IE6, IE7, Firefox (windows/linux), Opera (windows/linux), Safari (windows, mac)등의 다양한 브라우저에서 확인을 하면서 개발을 하고 있습니다.

다만 Opera의 경우 브라우저 자체 문제로 글을 입력할 수 없는 등의 문제가 있습니다.

일반적으로 사용되는 브라우저를 이용하시면 큰 문제 없이 제로보드XE를 사용하실 수 있습니다.

관리시에는 Firefox로 하시면 더 빠르고 수월하게 관리하실 수 있습니다.

zeroboardXE Manual

3. Template Handler

Template Handler#

템플릿 문법#

댓글알리미 모듈(tccommentnotify)

댓글알리미 모듈(tccommentnotify)

12. 댓글알림 애드온(tccommentnotify)

댓글알림 애드온

다. 메뉴관리를 통한 메뉴 생성

나. 관리자페이지 접속 및 간단소개

가. 다운로드 및 설치하기

7. 개발시 주의사항/팁

공통#

애드온#

1. zbXE 다운로드/업로드

zbXE다운로드/업로드 방법#

안정화 버전과 개발버전의 차이#

파일명에 따른 파일 내용#

배포 파일 다운로드#

.zip파일과 .tgz 파일#

01. 사용자 환경 확인

zbXE는 설치형 프로그램입니다.#

zbXE 설치환경을 확인해보세요.#

지원 브라우저를 확인하세요.#

Template Handler^#

템플릿 문법^#

공통^#

애드온^#

zbXE다운로드/업로드 방법^#

안정화 버전과 개발버전의 차이^#

파일명에 따른 파일 내용^#

배포 파일 다운로드^#

.zip파일과 .tgz 파일^#

zbXE는 설치형 프로그램입니다.^#

zbXE 설치환경을 확인해보세요.^#

지원 브라우저를 확인하세요.^#