第二章 简单标签简介

1.主要用于输出变量和做一些基本的操作

格式: 如:

2.支持默认值输出

如果输出的模板变量没有值,但是我们需要在显示的时候赋予一个默认值的话,可以使用default语法,格式: 这里的default不是函数,而是系统的一个语法规则,例如: 默认值支持Html语法。

3.支持对模板变量使用函数

仅仅是输出变量并不能满足模板输出的需要,内置模板引擎支持对模板变量使用调节器和格式化功能,其实也就是提供函数支持,并支持多个函数同时使用。用于模板标签的函数可以是PHP内置函数或者是用户自定义函数。
模板变量的函数调用格式为: 说明:
(1){ 和 $ 符号之间不能有空格,后面参数的空格就没有问题
(2)###表示模板变量本身的参数位置
(3)支持多个函数,函数之间支持空格
(4)支持函数屏蔽功能,在配置文件中可以配置禁止使用的函数列表

使用例子1: 注意函数的定义和使用顺序的对应关系,通常来说函数的第一个参数就是前面的变量或者前一个函数调用的返回结果,如果你的变量并不是函数的第一个参数,需要使用定位符号,例如: 使用例子2:站内搜索结果标题中的关键词变红加粗,$SearchWord表示搜索词

4.直接使用函数

并且还提供了在模板文件中直接调用函数的快捷方法,这种方式更加直接明了,而且无需通过模板变量:
格式: 例如:

5.系统函数

函数名称 函数说明 实例
频道函数
ChannelName(ChannelID) 获取指定频道ID的频道名称;ChannelID:频道ID,下同 {:ChannelName(1)}
ChannelUrl(ChannelID) 获取指定频道ID的频道Url  
ChannelSName(ChannelID) 获取指定频道ID的简短名称  
ChannelContent(ChannelID,count,suffix) 获取指定频道ID的频道内容;count:输出最大字符数,默认为全部、suffix: 附加后缀字符  
ChannelSContent(ChannelID, count,suffix) 获取指定频道ID的简短内容;count,suffix:同上  
ChannelPicture(ChannelID) 获取指定频道ID的频道图片Url  
ChannelModelName(ChannelID) 获取指定频道的频道模型名称  
PageSize(ChannelID) 获取指定频道分页大小  
ChannelParent(ChannelID) 获取指定频道父频道ID  
ChannelIcon(ChannelID) 获取指定频道图标  
ChannelStyle(ChannelID) 获取指定频道样式  
ChannelF1(ChannelID) 获取指定频道F1  
ChannelF2(ChannelID) 获取指定频道F2  
ChannelF3(ChannelID) 获取指定频道F3  
频道辅助函数
HasChild(ChannelID) 指定频道ID是否有子频道(1:有,0:无) {:HasChild(20)}
TopHasChild(ChannelID) 指定频道ID的最顶层频道是否有子频道(1:有,0:无) {:TopHasChild(20)}
HasParent(ChannelID) 指定频道ID是否有父频道(1:有,0:无) {:HasParent(20)}
TopChannelID(ChannelID) 获取指定频道ID的最顶层频道ID {:TopChannelID(20)}
频道属性标记
LabelName(LabelID) 获取属性标记名称;LabelID:属性标记ID {:LabelName(1)}
信息函数
InfoTitle(InfoID) 获取指定id的信息标题 {:InfoTitle(1)}
InfoSContent(InfoID, count = 0, suffix='...') 获取指定ID的信息简短内容;count:输出最大字符数,默认为全部、suffix: 附加后缀字符  
InfoContent(InfoID, count = 0, suffix='...') 获取指定ID的信息详细内容;count:输出最大字符数,默认为全部、suffix: 附加后缀字符 InfoContent(1, 10)
InfoPicture(InfoID) 获取指定ID的信息图片  
InfoAttachment(InfoID) 获取指定ID的信息附件  
LinkUrl(InfoID) 获取指定ID的信息外部Url  
InfoTime(InfoID) 获取指定ID的信息发布时间  
InfoUrl(InfoID) 获取指定ID的信息Url  
InfoCount(ChannelID) 获取指定ID的频道的信息条数  
InfoF1(InfoID) 获取指定ID的信息f1字段  
InfoF2(InfoID) 获取指定ID的信息f2字段  
InfoF3(InfoID) 获取指定ID的信息f3字段  
InfoF4(InfoID) 获取指定ID的信息f4字段  
InfoF5(InfoID) 获取指定ID的信息f5字段  
友情链接
LinkClassName(LinkClassID) 获取友情链接分类名称  
LinkName(LinkID) 获取友情链接名称  
LinkClassID(LinkID) 获取友情链接所属分类ID  
LinkType(LinkID) 获取友情链接类型  
LinkLogo(LinkID) 获取友情链接Logo  
LinkUrl(LinkID) 获取友情链接Url  
LinkDescription(LinkID) 获取友情链接描述  
幻灯片
BannerGroupName(BannerGroupID) 获取幻灯片分组名称  
BannerName(BannerID) 获取幻灯片名称  
BannerGroupID(BannerID) 获取幻灯片所属分组ID  
BannerImage(BannerID) 获取幻灯片图片  
BannerThumbnail(BannerID) 获取幻灯片缩略图  
BannerUrl(BannerID) 获取幻灯片Url  
BannerDescription(BannerID) 获取幻灯片描述  
专题
SpecialName(SpecialID) 获取专题名称  
SpecialDescription(SpecialID) 获取专题描述  
自定义标签
TagName(TagID) 获取自定义标签名称  
TagDescription(TagID) 获取自定义标签描述  
TagContent(TagID) 获取自定义标签内容  
广告
AdName(AdID) 获取广告名称  
AdContent(AdID) 获取广告内容  
AdDescription(AdID) 获取广告描述  
AdUrl(AdID) 获取广告Url  
AdTime(AdID) 获取广告发布的时间  
会员
MemberLoginUrl() 用户登录Url地址  
MemberLogoutUrl() 用户退出Url地址  
MemberRegUrl() 用户注册Url地址  
CheckMemberUrl() 用户登录验证Url地址  
CheckMemberUrl() 登录验证  
MemberUrl() 会员后台Url  
MemberForgetUrl() 忘记密码  
Url地址函数
HomeUrl() 获取网站首页Url地址 {: HomeUrl()}
WapHomeUrl() 手机网站首页地址,当在电脑站中获取手机网站首页地址时使用  
LanguageUrl(mark=”cn”) 语言切换Url地址 LanguageUrl(“cn”)
SitemapUrl() 网站地图Url地址  
OrderUrl(InfoID=false) 获取指定id的订购地址  
ResumeUrl(JobID=false) 获取指定职位id的投递简历Url地址 ResumeUrl(1)
InfoSearchAction($ChannelId = 0) 信息检索Url地址  
SubscibeUrl($MailClassID) 邮件订阅Url地址,$MailClassID:订阅邮箱分类  
FeedbackUrl() 反馈表单提交Url  
其它函数
Left(str, len, suffix) 获取字符串str左边len个字符,当len小于字符串的长度时,显示后缀suffix。 Left("helloworld",2,"…")  输出:he…
DefaultPicture($url, $default='1.jpg') 当图片为空时,显示默认图片,默认图片存放在模版目录/Public/Images/nopic(en或cn).jpg
当模版目录默认图片不存在时,取/Public/Images/nopic/$default(en或cn).jpg
 
get_single_value($id, $tableName, $FieldName) 通过ID字段获取指定表的指定字段。支持的表有:
频道表Channel、信息表Info、专题表Special、幻灯片表Banner、频道模型表Channel_Model、友情链接表Link、广告表Ad、留言板Guestbook、频道属性标记表Label
get_single_value($InfoID,"info","InfoTitle")
获取信息标题,等价于InfoTitle($InfoTitle)
注意:除了可以调用系统函数外,PHP库函数也可以直接在模版中使用。