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

发布时间：2011-09-07 21:59:15 作者：佚名我要评论
帝国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)，前台提示，提示信息内容为“数据库出错”，转向帝国网站
附加说明：
此函数需结合$editor变量来确定目录层次。默认$editor变量为0。
当程序文件在/e/path/目录，$editor不用设置，也就是用默认0。
当程序文件在/e/path/path2/目录，$editor=1。
当程序文件在/e/path/path2/path3/目录，$editor=2。
当程序文件在/e/path/path2/path3/path4/目录，$editor=3。

七、提示信息函数2 (直接提示内容)
语法：printerror2($error,$gotourl,$ecms,$noautourl)
说明：
$error：直接提示信息的内容。
$gotourl：提示信息转向链接地址
$ecms：0为默认提示信息方式、9为弹出提示信息方式(alert方式)。此参数可省略，默认为0
$noautourl：0为自动转向页面，1为不自动转向页面。此参数可省略，默认为0
使用范例：
printerror2(‘添加完毕’,’http://www.phome.net’)，提示信息内容为“添加完毕”，转向帝国网站
附加说明：
此函数不需要结合其他变量，可以在任意目录层次使用。不支持使用语言包变量。

八、设置系统COOKIE变量函数
语法：esetcookie($var,$val,$life,$ecms)
说明：
$var：为变量名
$val：为变量值
$life：为COOKIE有效时间，单位秒，0为不保存。此参数可省略，默认为不保存。
$ecms：0为设置前台COOKIE变量，1为设置后台COOKIE变量。此参数可省略，默认为0。
使用范例：
esetcookie(‘mybody’,’帝国’)，定义前台“COOKIE前缀+mybody”变量，变量内容为“帝国”
esetcookie(‘mybody’,’帝国’,0,1)，定义后台“COOKIE前缀+mybody”变量，变量内容为“帝国”
附加说明：
此设置COOKIE函数会给变量名加上COOKIE前缀，你可也可以直接用PHP本身的setcookie来定义。

九、取得系统COOKIE变量函数
语法：getcvar($var,$ecms)
说明：
$var：为变量名
$ecms：0为设置前台COOKIE变量，1为设置后台COOKIE变量。此参数可省略，默认为0。
使用范例：
getcvar(‘mlusername’)，取得前台登陆会员的用户名
getcvar(‘loginusername’,1)，取得后台登陆管理员的用户名
附加说明：
此取得COOKIE函数是取得变量名加上COOKIE前缀的变量，你可也可以直接用PHP本身的$_COOKIE[‘变量名’]来取得。

十、取得IP地址函数
语法：egetip()
使用范例：
<?php
$ip=egetip();
echo $ip;
?>

十一、动态页面显示分页函数
语法：page1($num,$line,$page_line,$start,$page,$search)
说明：
$num：总记录数
$line：每页显示数量
$page_line：每页显示分页链接数
$start：预设变量，设置0即可。
$page：当前页码(0为起始页码)
$search：链接附加参数

十二、通过栏目ID取得栏目名和栏目别名方法：
栏目名：<?=$class_r[栏目ID][‘classname’]?>
栏目别名：<?=$class_r[栏目ID][‘bname’]?>

Tag：帝国CMS 常用函数

帝国CMS根据内容正文字段[newstext]批量获取描述简介字段[smalltext]的

这篇文章主要介绍了帝国CMS根据内容正文字段[newstext]批量重新生成简介字段[smalltext]的方法,需要的朋友可以参考下 2023-06-26
帝国CMS 7.2和7.5适用的火车头采集免登陆发布模块配置方法详解(亲测可

帝国cms7.2版本开始增加了金刚模式，登录发布有难度。亲测可用的帝国CMS 7.2/7.5适用免登陆新闻发布模块插件配合火车采集器，可以解决这类问题。堪称完美 2022-04-21
帝国cms高危SQL注入漏洞(盲注)系统自带RepPIntvar过滤函数使用方法

帝国cms开发的时候要注意一些危险的注入漏洞,防止被黑,RepPIntvar为系统自带函数可以起到过滤字符的作用，下面就为大家介绍一下使用方法 2021-07-26
帝国cms后台启用SESSION验证增加安全性

帝国cms后台启用SESSION验证所有的登录信息都是保存在服务器端的，尤其是公共场所登录用默认的cookies是不安全的 2021-07-26
帝国CMS7.2版升级到7.5版的详细步骤方法(已测)

最近需要将老版本的帝国cms将7.2升级到7.5版本，参考这篇文章完美升级，特分享一下给需要的朋友 2020-08-02
帝国cms常用标签调用方法(灵动标签和万能标签的调用方法)

整理了一些常用的帝国CMS调用，灵动标签和万能标签的调用方法举例,包括幻灯片、标题、一级栏目、二级栏目、带模版的友情链接（下拉菜单）、判断内容页字段为空时是如何调用 2020-02-04
帝国cms网站地图sitemap.xml的制作方法

这篇文章主要介绍了帝国cms网站地图sitemap.xml的制作方法,需要的朋友可以参考下 2020-02-04
帝国CMS数据更新中心设置教程(更新网站细节)

在使用帝国cms的时候有时候需要把前台数据都更新一下，那么就可以参考下面的文章了，要不漏掉了部分就达不到更新的目地了 2020-02-04
帝国CMS后台登录界面及后台界面修改方法

今天接到网友询问怎么修改后台登录界面及后台界面，特把方法分享出来需要的朋友可以参考下 2020-02-04
帝国cms7.5在线表单提交制作方法

最近仿站团队接到很多仿站客户订单，这里面有一个这样的功能，表单提交，今天花时间写个教程给大家,需要的朋友可以参考下 2020-02-02