行云海CMS(XYHCMS)模板中可用函数大全|使用方法

2014-11-08 模板制作 阅读

函数

XYHcms模板中可用函数大全|使用方法

模板中可用函数大全

XYHcms模板可以使用的函数包括两部分  
 1、php系统中的函数(只选择一部分常用的讲解,其他略)  
2、XYHcms自带的函数

模板中使用函数,只针对模板标签中字段值。形式如

{标签字段|函数名=###,参数2,.....,参数n}
{标签字段|函数名=参数2,.....,参数n}

注:字段对应函数参数位置处,用###代替即可,如果在第一个参数位置,可以省略不写,其他参数位置不能省略(上面两个格式等同)
 
   例子:

<!--内容页 获取标题前20个字符串 -->
{$content.title|str2sub=###,20}

<!--内容页 将发布时间转成 2014年4月1日 的样式显示-->
{$content.publishtime|date='Y年m月d日',###}

YYCMS函数指南

str2sub函数 | 返回指定长度的字符串

str2sub(str, num, flag, sp)

参数说明:
 [1] str 表示要截取的字符串。必需;
 [2] num 表示返回的字符串长度。必需[数字];
 [3] flag 表示是否显示省略符。可选[0|1];
 [4] sp 表示省略符。可选["..."];

例子:

<yang:list typeid='1' limit='6'>
   <a href="{$list.url}">{$list.title|str2sub=###,20}</a>
   <p>{$list.description|str2sub=100}</p><br/>
</yang:list>

注解:获取栏目id为1的6条记录,标题只显示20个字符,摘要只显示100个字符


get_picture函数 | 返回指定尺寸大小的图片地址(需要后台缩略图支持)

get_picture(str, width, height, rnd)

参数说明:
 [1] str 表示要截取的字符串。必需[图片地址];
 [2] width 表示返回的图片宽度。为0时,返回原始图片地址。可选[数字];
 [3] height 表示返回的图片高。可选[数字];
 [4] rnd 表示随机数。可选;

例子:

<yang:list typeid='1' limit='6'>
   <a href="{$list.url}">{$list.title}</a>
   <img src="{$list.litpic|get_picture=60,60}" /><br/>
</yang:list>

注解:获取栏目id为1的6条记录,缩略图尺寸为60X60


date函数 | 用于格式化时间或日期(php自带)

date(format,timestamp)

注:由于获取的日期时间字段,一般都是时间戳形式,必须转换后,才能显示为我们看得懂的正常的日期

参数说明:
 [1] format 表示返回的日期格式。必需;
 [2] timestamp 表示要转换的时间戳。必需;

什么是时间戳(Timestamp)?
时间戳是自 1970 年 1 月 1 日(00:00:00 GMT)以来的秒数。它也被称为 Unix 时间戳(Unix Timestamp)。

格式化日期
date() 函数的第一个参数规定了如何格式化日期/时间。它使用字母来表示日期和时间的格式。这里列出了一些可用的字母:
d - 月中的天 (01-31)
m - 当前月,以数字计 (01-12)
Y - 当前的年(四位数)
H - 小时(00 到 23)
i - 分钟数(00 到 59)
s - 秒数(00 到 59)

您可以在PHP  参考手册中,找到格式参数中可以使用的所有字母。

例子:

<yang:list typeid='1' limit='6'>
   <li><a href="{$list.url}">{$list.title} {$list.publishtime|date='Y-m-d H:i:s',###}</a></li>
</yang:list>

注解:获取栏目id为1的6条记录,发布日期格式为 2014-04-01 10:22:50 这种显示样式