苹果CMS标签使用方法
苹果CMS V10模板标签支持基于 ThinkPHP 5(TP5)模板语法进行调用。在模板 HTML 文件中,可以使用 {} 包裹变量、条件判断、循环以及苹果CMS自身提供的标签,实现网站数据的动态调用。
一、PHP变量调用
在苹果CMS V10模板中,可以使用 {$变量名} 的形式调用PHP变量。例如调用网站名称:
{$maccms['site_name']}也可以使用点号语法访问数组中的元素:
{$maccms.site_name}以上两种写法都可以用于访问 maccms 数组中的 site_name 数据。
二、数组变量使用点号调用
苹果CMS V10模板标签支持使用点号代替传统PHP数组下标写法。例如:
{$maccms['site_name']}可以简写为:
{$maccms.site_name}这种写法在模板中更加直观,也比较适合频繁调用网站配置和数组数据。
三、列表标签的基本结构
苹果CMS V10的列表标签通常由开始标签和结束标签组成,中间放置需要循环输出的HTML内容。
例如使用 maccms:vod 标签调用影视数据:
{maccms:vod type="all" num="10"}
{/maccms:vod}其中:
{maccms:vod}:列表标签开始。type="all":设置影视数据的调用类型。num="10":设置调用的数据数量。{/maccms:vod}:列表标签结束。
实际使用时,可以在开始标签和结束标签之间加入HTML结构以及数据变量,从而生成影视列表。
四、列表内部变量
在列表标签内部,当前循环数据通常使用 $vo 开头的变量进行调用。变量对应的数据一般来自影视数据表中的字段。
例如调用影视名称和影视ID:
{$vo.vod_name}
{$vo.vod_id}常见的影视字段还包括影视图片、备注、主演、导演、年份等,具体可以根据当前调用的数据字段进行使用。
五、影视列表调用示例
例如,可以在 maccms:vod 标签中调用影视名称:
{maccms:vod type="all" num="10"}
<div class="vod-list">
<a href="{:mac_url_vod_detail($vo)}">
<span>{$vo.vod_name}</span>
</a>
</div>
{/maccms:vod}标签循环执行后,每条影视数据都会生成对应的HTML内容,$vo则代表当前正在循环处理的影视数据。
六、标签语法基本规律
苹果CMS V10模板开发时,可以简单理解为以下几种常见形式:
{$变量}:调用普通变量。{$数组.字段}:调用数组中的指定数据。{maccms:vod ...}{/maccms:vod}:循环调用影视数据。{$vo.字段}:调用当前列表循环中的数据字段。{:函数名(...)}:调用模板中支持的函数或方法。
七、使用模板标签时的注意事项
苹果CMS V10不同页面提供的数据对象可能有所不同,因此 $vo 后面的字段应根据当前标签实际返回的数据进行调用。不能简单认为所有页面都具有完全相同的字段。
另外,在复制模板标签时,应注意开始标签和结束标签是否完整。例如列表标签缺少结束标签,可能导致后续HTML结构或模板解析出现异常。
总结
苹果CMS V10模板标签以ThinkPHP 5模板语法为基础,在HTML中可以通过 {} 调用变量、数组、函数以及系统标签。普通变量可以使用 {$变量} 调用,数组支持使用点号语法访问,而影视列表则可以通过 maccms:vod 标签循环输出,循环内部通常使用 {$vo.字段} 调用当前数据。
