====== Z-BlogPHP 模板语言基本语法 ======


 模板文件结构及可用标签请参考：[[template]]。

===== 0.模板名(类别) =====
<code>{* Template Name:xxx *} </code>
放在模板文件第一行，xxx表示模板名。

模板名和模板类型同时出现
<code>{* Template Name:xxx * Template Type:yyyy *} </code>
放在模板文件第一行，xxx表示模板名，yyyy表示模板类型
类型有：list,single,article,page,category,tag,author,date,404,search
^ 类型      ^ 意义        ^
| list      |  列表页面      |
| single    |  单页面（含文章与页面）|
| article   |  文章          |
| page      |  页面          |
| category  |  分类列表      |
| tag       |  标签列表      |
| author    |  作者列表      |
| date      |  日期列表      |
| search    |  搜索          |
| 404       |  404           |
| index     |  首页(非列表页)  |
| none      |  未分类(不显示)  |

示例1
<code>{* Template Name:文章模板 * Template Type:single *} </code>
示例2
<code>{* Template Name:作者列表模板 * Template Type:list,author *} </code>
<note warning>{*后有一个空格，*}之前也有一个空格，中间如有*的话，两边都要有空格</note>

==== 1.7.0以后支持template.json配置 ====
template.json示例：
<code>
{
    "id": "主题ID",
    "templates": [
        {
            "filename": "index",
            "type": "list",
            "name": "列表自动模板"
        },
        {
            "filename": "single",
            "type": "single",
            "name": "文章/单页自动模板"
        }
    ]
}
</code>

<note important>1.7.0版本之后,在模板页面中标注了模板类型或是配置了template.json,选择模板时就会启用白名单过滤机制!</note>


===== 1.加载指令 =====

==== 嵌入模板 ====
<code php>{template:hearder}</code>
即嵌入模板文件''hearder.php''的文件内容。这里''hearder''只是举例，''{template:abc}''即可嵌入''abc.php''文件内容。
==== 嵌入模块内容 ====
<code php>{module:xxxxxx}</code>
xxxxxx为模块的filename，这里所说的filename即在模块编辑时看到的**文件名**。

===== 2.访问并输出变量或定义变量 =====
==== 直接输出 ====
<code php>{$abc}</code>
如输出文章（$article）对象的Title属性值：
<code php>{$article.Title}</code>
注意：''$article''等在特定页面是作为特定实体对象存在的，如在文章页需要使用''getlist''等获取文章列表时请勿使用article作为别名。
==== 定义变量并赋值 ====
只定义赋值，并不输出内容
<code php>{$now=time()}

{$abc="my name"}</code>
若要输出变量内容，代码同上一条所述
<code php>{$now}

{$abc}</code>
<note important>注意：某些JS语法会跟模板变量冲突，可尽量通过引用方法引入JS文件避免该类冲突。
如''if(margin != undefined){$li.css("margin-right", margin+'px');}'' 将被模板解析为<php>if(margin != undefined)<?php echo $li->css("margin-right", margin+'px'); ?> </php> </note>
===== 3.引用系统常量 =====
指的是系统各项配置值，如站点域名：
<code php>{#ZC_BLOG_HOST#}</code>
这是zblog传统的常量型,和asp版语法基本一致

===== 4.if判断语句 =====

<code php>{if $i==1}

{elseif $i==2}

{else}

{/if}</code>

===== 5.foreach和for遍历语句 =====
==== foreach ====

<code php>
{foreach $articles as $post}
  <p>{$post.Title}</p>
{/foreach}
</code>
==== for ====
<code php>
{for $i  =  1 ;  $i  <=  10 ;  $i ++}
  <p>这是第{$i}次？</p>
{/for}
</code>
===== 6.函数调用 =====
==== 直接输出 ====

如，直接输出当前时间
<code php>{time()}</code>

==== 返回数组 ====
举例，输出[[zblogphp:development:functions:getlist|GetList]]()的返回数组
<code php>
{foreach GetList() as $post}
{$post.***}
{/foreach}
</code>


更多由Z-BlogPHP提供的可用函数请参考：[[zblogphp:development:functions:首页]]

===== 7.注释 =====

<code php>{* 这里是注释 *}</code>

===== 8.直接运行PHP代码 =====

<code php>{php}
  global $actions;
  print_r($actions);
  echo '12345';
{/php}</code>


<note important>注意：zbp模板不能直接使用<?php ?>和<? ?>标签，只能用{php}包含php代码。</note>