帝国CMS常用函数介绍(二次开发参考)

一、esub()截取字段函数
语法：esub(字符串,截取字数,后缀)
说明：后缀为截取字符后附带内容，此参数可以省略。
使用范例：
<?=esub("12345678",6)?>，返回结果为：123456
<?=esub("12345678",6,"...")?>，返回结果为：123456...


二、date()转换时间格式函数
语法：date(时间格式,时间戳)
说明：PHP本身函数，使用说明可以参考：http://cn.php.net/manual/en/function.date.php
使用范例：
<?=date("Y-m-d H:i:s",1277865010)?>，返回结果为：2010-06-30 10:30:10


三、format_datetime()转换时间格式函数2
语法：format_datetime(正常时间,时间格式)
说明：和date()的区别是format_datetime是转换正常时间，而date是转换unix时间戳。
使用范例：
<?=format_datetime("2010-06-30 10:30:10","m/d")?>，返回结果为：06/30


四、通过ID取得栏目地址函数
语法：sys_ReturnBqClassname($r,9)
说明：$r为含栏目ID的数组，变量名可任意命名。
使用范例：取得栏目ID=2的栏目地址。
<?php
$cr["classid"]=2;
$classurl=sys_ReturnBqClassname($cr,9);
echo $classurl;
?>

通过ID取得栏目地址的其他方法：
(1)、/e/public/ClassUrl/?classid=栏目ID
(2)、/<?=$class_r[栏目ID]["classpath"]?>


五、取得信息内容页地址函数
语法：sys_ReturnBqTitleLink($r)
说明：$r为含“id,classid,newspath,filename,groupid,titleurl”字段内容的数组，变量名可任意命名。
使用范例：取得信息ID=8的新闻页面地址
<?php
$nr=$empire->fetch1("select id,classid,newspath,filename,groupid,titleurl from {$dbtbpre}ecms_news where id="8" limit 1");
$titleurl=sys_ReturnBqTitleLink($nr);
echo $titleurl;
?>

通过ID取得信息内容页地址的其他方法：
/e/public/InfoUrl/?classid=栏目ID&id=信息ID

六、提示信息函数1
语法：printerror($error,$gotourl,$ecms,$noautourl,$novar)
说明：
$error：提示信息内容，可以为语言包变量，也可以直接提示内容。
$gotourl：提示信息转向链接地址
$ecms：0为后台提示信息、1为前台提示信息、8为后台提示信息(alert方式)、9为前台提示信息(alert方式)
$noautourl：0为自动转向页面，1为不自动转向页面。此参数可省略，默认为0
$novar：0为提示信息内容采用语言包变量，1为提示信息内容为直接提示内容。此参数可以省略，默认为0
使用范例：
printerror("DbError","http://www.phome.net",1)，前台提示，提示信息内容为语言包DbError变量内容，转向帝国网站
printerror("数据库出错","http://www.phome.net",1,0,1)，前台提示，提示信息内容为“数据库出错”，转向帝国网站