函數
XYHcms模板中可用函數大全|使用方法
模板中可用函數大全
XYHcms模板可以使用的函數包括兩部分
1、php系統(tǒng)中的函數(只選擇一部分常用的講解,其他略)
2、XYHcms自帶的函數
模板中使用函數,只針對模板標簽中字段值。形式如
{標簽字段|函數名=###,參數2,.....,參數n}
{標簽字段|函數名=參數2,.....,參數n}
注:字段對應函數參數位置處,用###代替即可,如果在第一個參數位置,可以省略不寫,其他參數位置不能省略(上面兩個格式等同)
例子:
<!--內容頁 獲取標題前20個字符串 --> {$content.title|str2sub=###,20} <!--內容頁 將發(fā)布時間轉成 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() 函數的第一個參數規(guī)定了如何格式化日期/時間。它使用字母來表示日期和時間的格式。這里列出了一些可用的字母:
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條記錄,發(fā)布日期格式為 2014-04-01 10:22:50 這種顯示樣式