티스토리 뷰

Oz & Nz/Web

[SCRAP] XE 템플릿 스크립트 문법

Auditories 2010. 1. 5. 20:20


[SCRAP] XE 템플릿 스크립트 문법

 

XE의 스킨은 특수한 템플릿 언어를 사용합니다. 따라서 스킨을 제작하면서 자신이 원하는 내용을 넣기 위해 본 내용을 숙지해야 합니다.
PHP언어와 비슷하지만 약간 다른 모습을 가지고 있습니다.

변수

변수는 PHP와 동일하게 사용되며, XE 내부에서 사용되는 여러가지 변수를 그대로 이용할 수 있습니다. 단, 출력시에는 {...}문을 사용합니다.

{$document_srl}

위의 문장은 $document_srl이라는 변수를 출력하도록 만듭니다. 아울러 여러가지 출력함수를 매칭시켜 화면출력을 시킬 수도 있습니다.

{$oDocument->getTitleText()}

그러나 {...}안에 출력될 수 없는 문장등을 기재하면 안됩니다.
각 스킨별로 어떤 변수를 쓸수 있는지에 대해서 미리 이해하는 것이 필요하기 때문에 배포본에 함께 동봉된 다른 스킨들이 어떤 변수를 쓰고 있는지 숙지하시기 바랍니다.

제어문

스킨에 간단한 제어문을 사용할 수 있습니다.

조건문

<!--@if(조건식)--> <!--@elseif(조건식)--> <!--@else-->

위의 문장등을 이용하여 조건에 맞추어 스킨 출력을 제어합니다. 조건문에 의한 실행 블록(block)을 정의하기 위하여 반드시

<!--@end-->

위와 같이 end문을 반드시 기입해야 합니다. 예를 들어 newest_document 위젯의 스킨에서 다음과 같은 조건문 처리가 가능합니다.

<!--@if(count($widget_info->document_list) > 0)--> .... 문서정보 출력... <!--@else--> 최근 문서가 없습니다. <!--@end-->

조건식(Condition Expression)안의 내용은 PHP로 곧바로 해석되기 때문에 PHP에서 가능한 여러가지 연산자를 쓸 수 있습니다.

<!--@if($logged_info && $logged_info->is_admin)-->

위의 조건문은 스킨에서 현재 유저가 로긴을 했는지, 그리고 관리자인지 검사하는 것을 보입니다.

반복문

배열등을 처리하기 위하여 foreach문장을 사용할 수 있습니다. 반복문 역시 end로 해당 블록을 반드시 명시해야 합니다.

<!--@foreach($widget_info->document_list as $oDocument)--> <!--@end-->

foreach의 조건식 역시 PHP의 foreach에 사용되는 것과 동일하게 해석되므로, Key와 Value를 분리하기 위해 다음과 같이 쓸 수도 있습니다.

<!--@foreach($widget_info->document_list as $key => $oDocument)--> <!--@end-->

간단한 PHP문 사용

템플릿 파일에서 {@...}문을 이용하면 간단한 PHP문장을 해석하도록 해줍니다. 예를 들어,

{@$is_logged=Context::get('is_logged')}

위와 같이 사용할 수 있습니다.(예문은 현재 로그인했는지 확인하는 XE 기본 문항을 스킨에 쓸수 있도록 해준 것입니다.
그러나 {@...}을 사용할때 안에 들어가는 것은 한문장으로 해석가능한 완전한 PHP문이어야 합니다. 예를 들어,

{@$test = 364; $test=$test*$test}

위와 같이 PHP상에선 별 문제없어보이는 식이지만 이미 하나의 문장이 아니기 때문에 에러를 일으킵니다.(사이트가 보이지 않는 등의 치명적인 문제를 일으키기도 합니다.)

여러 문장을 입력할 경우 아래와 같이 작성하시는 것을 추천합니다.

{@
    $test = 364;
    $test=$test*$test
}

파일의 분할

공통적으로 사용되는 템플릿 파일들을 나누어 관리할 수 있습니다.

<!--#include('파일경로')-->

주의: 위의 include문은 php의 include와 다르게 작동됩니다. 어디까지나 분할된 템플릿 파일을 include한다는 사실에 유의하십시오. 일반 PHP 파일은 include 해도 PHP로 해석되지 않습니다.

CSS/자바스크립트와의 연결

CSS나 자바스크립트를 사용하기 위하여 다음과 같이 <!--%import(경로)-->문법을 이용합니다.

<!--%import("js/blog.js")-->

위의 예제는 js/blog.js파일을 현재의 스킨과 연결시키기 위해 사용된 문장입니다. 한편으로 이 문장은

{@Context::addJsFile("js/blog.js")}

과 동일한 실행결과를 가집니다.

<!--%import("css/common.css")-->

위의 예제는 css/common.css파일을 현재의 스킨과 연결시키기 위해 사용된 문장입니다. 한편으로 이 문장은

{@Context::addCSSFile("css/common.css")}

과 동일한 실행결과를 가집니다.

주의: 이렇게 import된 JS파일은 선언된 위치와 상관없이 HTML의 <HEAD>안에 자동으로 삽입됩니다.

XML JS Filter 적용

XML JS Filter를 사용은 CSS나 자바스크립트를 연결하는 방법과 동일합니다.

<!-%import("filter/insert.xml")-->

 

원문 : http://xe.xpressengine.net/wiki/18180861


저작자표시 비영리 변경금지
공지사항
최근에 올라온 글
최근에 달린 댓글
Total
Today
Yesterday
링크
TAG more
«   2025/02   »
일 월 화 수 목 금 토
1
2 3 4 5 6 7 8
9 10 11 12 13 14 15
16 17 18 19 20 21 22
23 24 25 26 27 28
글 보관함