函数
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 这种显示样式