39228702. zbXE 템플릿 스크립트 문법3922272009-03-02T09:04:06Zhttp://zbxe.springnote.com/pages/3922872007-07-31T03:23:33Z<div id="toc" style="BORDER-RIGHT: tan 1px solid; PADDING-RIGHT: 10px; BORDER-TOP: tan 1px solid; PADDING-LEFT: 10px; PADDING-BOTTOM: 0px; BORDER-LEFT: tan 1px solid; PADDING-TOP: 2px; BORDER-BOTTOM: tan 1px solid; BACKGROUND-COLOR: #fffffa;"><span class="Apple-style-span" style="font-weight: bold;">목차</span>
<hr />
<ol>
<li><a href="#toc_0" class="external" title="toc_0">변수</a></li>
<li><a href="#toc_1" class="external" title="toc_1">제어문</a>
<ol>
<li><a href="#toc_2" class="external" title="toc_2">조건문</a></li>
<li><a href="#toc_3" class="external" title="toc_3">반복문</a></li>
</ol>
</li>
<li><a href="#toc_4" class="external" title="toc_4">간단한 PHP문 사용</a></li>
<li><a href="#toc_5" class="external" title="toc_5">파일의 분할</a></li>
<li><a href="#toc_6" class="external" title="toc_6">CSS/자바스크립트와의 연결</a></li>
<li><a href="#toc_7" class="external" title="toc_7">링크</a></li>
</ol>
</div>
<p>XE의 스킨은 zb4와 다르게 PHP로 다시 변환되는 특수한 템플릿 언어를 사용합니다. 따라서 스킨을 제작하면서 자신이 원하는 내용을 넣기 위해 본 내용을 숙지해야 합니다.</p>
<p> </p>
<h3>변수<span class="Apple-style-span" style="vertical-align: super;"><a href="#toc_0" class="anchor" title="toc_0" id="toc_0" >#</a></span></h3>
<p>변수는 PHP와 동일하게 사용되며, XE 내부에서 사용되는 여러가지 변수를 그대로 이용할 수 있습니다. 단, 출력시에는 {...}문을 사용합니다.</p>
<p> </p>
<ol class="code">
<li>{$document_srl}</li>
</ol>
<p> </p>
<p>위의 문장은 $document_srl이라는 변수를 출력하도록 만듭니다. 아울러 여러가지 출력함수를 매칭시켜 화면출력을 시킬 수도 있습니다.</p>
<p> </p>
<ol class="code">
<li>{$oDocument->getTitleText()}</li>
</ol>
<p> </p>
<p>그러나 <em class="underline" style="">{...}안에 출력될 수 없는 문장등을 기재하면 안됩니다.</em></p>
<p> </p>
<p>각 스킨별로 어떤 변수를 쓸수 있는지에 대해서 미리 이해하는 것이 필요하기 때문에 배포본에 함께 동봉된 다른 스킨들이 어떤 변수를 쓰고 있는지 숙지하시기 바랍니다.</p>
<p> </p>
<h3>제어문<sup class="tocAnchorContainer"><a href="#toc_1" class="anchor" title="toc_1" id="toc_1" >#</a></sup></h3>
<p>스킨에 간단한 제어문을 사용할 수 있습니다.</p>
<p> </p>
<h4>조건문<span class="Apple-style-span" style="vertical-align: super;"><a href="#toc_2" class="anchor" title="toc_2" id="toc_2" >#</a></span></h4>
<p> </p>
<ol class="code">
<li><!--@if(조건식)--></li>
<li><!--@elseif(조건식)--></li>
<li><!--@else--></li>
</ol>
<p> </p>
<p>위의 문장등을 이용하여 조건에 맞추어 스킨 출력을 제어합니다. 조건문에 의한 실행 블록(block)을 정의하기 위하여 반드시</p>
<p> </p>
<ol class="code">
<li><!--@end--></li>
</ol>
<p> </p>
<p>위와 같이 end문을 반드시 기입해야 합니다. 예를 들어 newest_document 위젯의 스킨에서 다음과 같은 조건문 처리가 가능합니다.</p>
<p> </p>
<ol class="code">
<li><!--@if(count($widget_info->document_list) > 0)--></li>
<li> .... 문서정보 출력...</li>
<li><!--@else--></li>
<li> 최근 문서가 없습니다.</li>
<li><!--@end--></li>
</ol>
<p> </p>
<p>조건식(Condition Expression)안의 내용은 PHP로 곧바로 해석되기 때문에 PHP에서 가능한 여러가지 연산자를 쓸 수 있습니다.</p>
<p> </p>
<ol class="code">
<li><!--@if($logged_info && $logged_info->is_admin)--></li>
</ol>
<p> </p>
<p>위의 조건문은 스킨에서 현재 유저가 로긴을 했는지, 그리고 관리자인지 검사하는 것을 보입니다.</p>
<p> </p>
<h4>반복문<sup class="tocAnchorContainer"><a href="#toc_3" class="anchor" title="toc_3" id="toc_3" >#</a></sup></h4>
<p> </p>
<p>배열등을 처리하기 위하여 foreach문장을 사용할 수 있습니다. 반복문 역시 end로 해당 블록을 반드시 명시해야 합니다.</p>
<p> </p>
<ol class="code">
<li><!--@foreach($widget_info->document_list as $oDocument)--></li>
<li><!--@end--></li>
</ol>
<p> </p>
<p>foreach의 조건식 역시 PHP의 foreach에 사용되는 것과 동일하게 해석되므로, Key와 Value를 분리하기 위해 다음과 같이 쓸 수도 있습니다.</p>
<p> </p>
<ol class="code">
<li><!--@foreach($widget_info->document_list as $key => $oDocument)--></li>
<li><!--@end--></li>
</ol>
<p> </p>
<p> </p>
<h3>간단한 PHP문 사용<span class="Apple-style-span" style="vertical-align: super;"><a href="#toc_4" class="anchor" title="toc_4" id="toc_4" >#</a></span></h3>
<p> </p>
<p>템플릿 파일에서 {@...}문을 이용하면 간단한 PHP문장을 해석하도록 해줍니다. 예를 들어,</p>
<p> </p>
<ol class="code">
<li>{@$is_logged=Context::get('is_logged')}</li>
</ol>
<p> </p>
<p>위와 같이 사용할 수 있습니다.(예문은 현재 로그인했는지 확인하는 XE 기본 문항을 스킨에 쓸수 있도록 해준 것입니다.</p>
<p>그러나 {@...}을 사용할때 안에 들어가는 것은 한문장으로 해석가능한 완전한 PHP문이어야 합니다. 예를 들어,</p>
<p> </p>
<ol class="code">
<li>{@$test = 364; $test=$test*$test}</li>
</ol>
<p> </p>
<p>위와 같이 PHP상에선 별 문제없어보이는 식이지만 이미 하나의 문장이 아니기 때문에 에러를 일으킵니다.(사이트가 보이지 않는 등의 치명적인 문제를 일으키기도 합니다.)</p>
<p> </p>
<p>※ 내부적으로 {@...}안의 문장은 PHP의 <a href="http://www.php.net/manual/kr/function.eval.php" class="external" title="eval() 함수">eval() 함수</a>를 이용하여 파싱됩니다.</p>
<p> </p>
<p> </p>
<h3>파일의 분할<sup class="tocAnchorContainer"><a href="#toc_5" class="anchor" title="toc_5" id="toc_5" >#</a></sup></h3>
<p> </p>
<p>공통적으로 사용되는 템플릿 파일들을 나누어 관리할 수 있습니다.</p>
<p> </p>
<ol class="code">
<li><!--#include('파일경로')--></li>
<li><!--#include("파일경로")--></li>
</ol>
<p> </p>
<p><span class="Apple-style-span" style="font-weight: bold;">주의</span>: <span class="apple-style-span" style="text-decoration: underline;">위의 include문은 php의 include와 다르게 작동됩니다.</span> 어디까지나 분할된 템플릿 파일을 include한다는 사실에 유의하십시오. 일반 PHP 파일은 include 해도 PHP로 해석되지 않습니다.</p>
<p> </p>
<p> </p>
<h3>CSS/자바스크립트와의 연결<span class="Apple-style-span" style="vertical-align: super;"><a href="#toc_6" class="anchor" title="toc_6" id="toc_6" >#</a></span></h3>
<p> </p>
<p>CSS나 자바스크립트를 사용하기 위하여 다음과 같이 <span class="Apple-style-span" style="font-weight: bold;"><!--%import(경로)--></span>문법을 이용합니다.</p>
<p> </p>
<ol class="code">
<li><!--%import("js/blog.js")--></li>
</ol>
<p> </p>
<p>위의 예제는 js/blog.js파일을 현재의 스킨과 연결시키기 위해 사용된 문장입니다. 한편으로 이 문장은</p>
<p> </p>
<ol class="code">
<li>{@Context::addJsFile("js/blog.js")}</li>
</ol>
<p> </p>
<p>과 동일한 실행결과를 가집니다.</p>
<p> </p>
<ol class="code">
<li><!--%import("css/common.css")--></li>
</ol>
<p> </p>
<p>위의 예제는 css/common.css파일을 현재의 스킨과 연결시키기 위해 사용된 문장입니다. 한편으로 이 문장은</p>
<p> </p>
<ol class="code">
<li>{@Context::addCSSFile("css/common.css")}</li>
</ol>
<p> </p>
<p>과 동일한 실행결과를 가집니다.</p>
<p> </p>
<p>주의: 이렇게 import된 JS파일은 선언된 위치와 상관없이 HTML의 <HEAD>안에 자동으로 삽입됩니다.</p>
<p> </p>
<p> </p>
<h3>링크<sup class="tocAnchorContainer"><a href="#toc_7" class="anchor" title="toc_7" id="toc_7" >#</a></sup></h3>
<p><a href="http://www.zeroboard.com/?mid=skin_tip&category=&search_target=user_id&search_keyword=wind6cpu" class="external" title="'아야 어디가'님의 '레이아웃을 처음부터 만들고 싶은...' 강좌 시리즈">'아야 어디가'님의 '레이아웃을 처음부터 만들고 싶은...' 강좌 시리즈</a></p>
<p> </p>
<p> </p>
http://blog.nzeo.com/http://gony.myid.net/83