iCMS 模板方法说明文档

iCMS 提供了丰富的模板方法，包括 调节器、块处理器 和 函数处理器，用于在模板中对数据进行处理和展示。以下是各类模板方法的详细说明。

1. 调节器 (tpl.modifier 开头)

调节器用于对模板变量进行处理，形式为 <!--{$变量|调节器}-->。调节器可以带参数，参数可以是模板自带的调节器，也可以是 PHP 函数。

2. 块处理器 (tpl.block 开头)

块处理器用于处理模板中的块内容，形式为 <!--{block}-->内容<!--{/block}-->。

3. 函数处理器 (tpl.function 开头)

函数处理器用于在模板中调用函数，形式为 <!--{function 参数}-->。

4. 模板输出清理 (tpl.output.clean)

5. 使用示例

5.1 调节器示例

<!-- 格式化日期 -->
<!--{$timestamp|date:'Y-m-d H:i:s'}-->

<!-- 截取字符串 -->
<!--{$str|cut:10:'...'}

<!-- 调用对象方法 -->
<!--{$object|call:'method':'arg1':'arg2'}-->

<!-- 将字符串转换为大写 -->
<!--{$str|upper}

<!-- 截取字符串 -->
<!--{$str|truncate:50:'...'}-->

<!-- 替换字符串 -->
<!--{$str|replace:'old':'new'}-->

5.2 块处理器示例

<!-- 缓存块内容 -->
<!--{cache id="key" time="3600"}-->
<div>缓存内容</div>
<!--{/cache}-->

<!-- 捕获块内容 -->
<!--{capture name="var"}-->
<div>捕获的内容</div>
<!--{/capture}-->
{$var}

<!-- 去除多余空格和换行 -->
<!--{strip}-->
<div>
    内容
</div>
<!--{/strip}-->

5.3 函数处理器示例

<!-- 创建数组 -->
<!--{array as="arr" key="value"}-->

<!-- 随机选择值 -->
<!--{rand values="1,2,3" as="random"}-->

<!-- 计数器 -->
<!--{counter start=1 skip=2}-->

<!-- 循环遍历值 -->
<!--{cycle values="1,2,3"}-->

<!-- 数学运算 -->
<!--{math equation="x + y" x=1 y=2}-->

6. 最佳实践

1. 调节器的使用：

   • 调节器可以链式调用，如 <!--{$str|cut:10|html2txt}-->。
   • 调节器的参数可以是变量或常量，如 <!--{$str|cut:$len}-->。

2. 块处理器的使用：

   • 块处理器适合用于缓存频繁渲染的内容，如列表页、详情页等。
   • 缓存时间应根据内容的更新频率合理设置。

3. 函数处理器的使用：

   • 函数处理器适合用于生成动态内容，如随机值、数组操作等。
   • 函数处理器的参数应尽量简洁，避免复杂的逻辑。

通过合理使用模板方法，开发者可以高效地处理模板中的数据，提升模板的可读性和可维护性。