[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
