帝國(guó)CMS常用函數(shù)介紹(二次開發(fā)參考)

2024-07-09 22:54:24

字體：大中小

供稿：網(wǎng)友

點(diǎn)評(píng)：帝國(guó)CMS常用函數(shù)介紹(二次開發(fā)參考)，由于最近開始研究帝國(guó)的二次開發(fā)，特準(zhǔn)備了一些文檔。

一、esub()截取字段函數(shù)
語(yǔ)法：esub(字符串,截取字?jǐn)?shù),后綴)
說(shuō)明：后綴為截取字符后附帶內(nèi)容，此參數(shù)可以省略。
使用范例：
<?=esub('12345678',6)?>，返回結(jié)果為：123456
<?=esub('12345678',6,'...')?>，返回結(jié)果為：123456...

二、date()轉(zhuǎn)換時(shí)間格式函數(shù)
語(yǔ)法：date(時(shí)間格式,時(shí)間戳)
說(shuō)明：PHP本身函數(shù)，使用說(shuō)明可以參考：http://cn.php.net/manual/en/function.date.php
使用范例：
<?=date('Y-m-d H:i:s',1277865010)?>，返回結(jié)果為：2010-06-30 10:30:10

三、format_datetime()轉(zhuǎn)換時(shí)間格式函數(shù)2
語(yǔ)法：format_datetime(正常時(shí)間,時(shí)間格式)
說(shuō)明：和date()的區(qū)別是format_datetime是轉(zhuǎn)換正常時(shí)間，而date是轉(zhuǎn)換unix時(shí)間戳。
使用范例：
<?=format_datetime('2010-06-30 10:30:10','m/d')?>，返回結(jié)果為：06/30

四、通過ID取得欄目地址函數(shù)
語(yǔ)法：sys_ReturnBqClassname($r,9)
說(shuō)明：$r為含欄目ID的數(shù)組，變量名可任意命名。
使用范例：取得欄目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']?>

五、取得信息內(nèi)容頁(yè)地址函數(shù)
語(yǔ)法：sys_ReturnBqTitleLink($r)
說(shuō)明：$r為含“id,classid,newspath,filename,groupid,titleurl”字段內(nèi)容的數(shù)組，變量名可任意命名。
使用范例：取得信息ID=8的新聞頁(yè)面地址
<?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取得信息內(nèi)容頁(yè)地址的其他方法：
/e/public/InfoUrl/?classid=欄目ID&id=信息ID

六、提示信息函數(shù)1
語(yǔ)法：printerror($error,$gotourl,$ecms,$noautourl,$novar)
說(shuō)明：
$error：提示信息內(nèi)容，可以為語(yǔ)言包變量，也可以直接提示內(nèi)容。
$gotourl：提示信息轉(zhuǎn)向鏈接地址
$ecms：0為后臺(tái)提示信息、1為前臺(tái)提示信息、8為后臺(tái)提示信息(alert方式)、9為前臺(tái)提示信息(alert方式)
$noautourl：0為自動(dòng)轉(zhuǎn)向頁(yè)面，1為不自動(dòng)轉(zhuǎn)向頁(yè)面。此參數(shù)可省略，默認(rèn)為0
$novar：0為提示信息內(nèi)容采用語(yǔ)言包變量，1為提示信息內(nèi)容為直接提示內(nèi)容。此參數(shù)可以省略，默認(rèn)為0
使用范例：
printerror('DbError','http://www.phome.net',1)，前臺(tái)提示，提示信息內(nèi)容為語(yǔ)言包DbError變量?jī)?nèi)容，轉(zhuǎn)向帝國(guó)網(wǎng)站
printerror('數(shù)據(jù)庫(kù)出錯(cuò)','http://www.phome.net',1,0,1)，前臺(tái)提示，提示信息內(nèi)容為“數(shù)據(jù)庫(kù)出錯(cuò)”，轉(zhuǎn)向帝國(guó)網(wǎng)站
附加說(shuō)明：
此函數(shù)需結(jié)合$editor變量來(lái)確定目錄層次。默認(rèn)$editor變量為0。
當(dāng)程序文件在/e/path/目錄，$editor不用設(shè)置，也就是用默認(rèn)0。
當(dāng)程序文件在/e/path/path2/目錄，$editor=1。
當(dāng)程序文件在/e/path/path2/path3/目錄，$editor=2。
當(dāng)程序文件在/e/path/path2/path3/path4/目錄，$editor=3。

七、提示信息函數(shù)2 (直接提示內(nèi)容)
語(yǔ)法：printerror2($error,$gotourl,$ecms,$noautourl)
說(shuō)明：
$error：直接提示信息的內(nèi)容。
$gotourl：提示信息轉(zhuǎn)向鏈接地址
$ecms：0為默認(rèn)提示信息方式、9為彈出提示信息方式(alert方式)。此參數(shù)可省略，默認(rèn)為0
$noautourl：0為自動(dòng)轉(zhuǎn)向頁(yè)面，1為不自動(dòng)轉(zhuǎn)向頁(yè)面。此參數(shù)可省略，默認(rèn)為0
使用范例：
printerror2('添加完畢','http://www.phome.net')，提示信息內(nèi)容為“添加完畢”，轉(zhuǎn)向帝國(guó)網(wǎng)站
附加說(shuō)明：
此函數(shù)不需要結(jié)合其他變量，可以在任意目錄層次使用。不支持使用語(yǔ)言包變量。

八、設(shè)置系統(tǒng)COOKIE變量函數(shù)
語(yǔ)法：esetcookie($var,$val,$life,$ecms)
說(shuō)明：
$var：為變量名
$val：為變量值
$life：為COOKIE有效時(shí)間，單位秒，0為不保存。此參數(shù)可省略，默認(rèn)為不保存。
$ecms：0為設(shè)置前臺(tái)COOKIE變量，1為設(shè)置后臺(tái)COOKIE變量。此參數(shù)可省略，默認(rèn)為0。
使用范例：
esetcookie('mybody','帝國(guó)')，定義前臺(tái)“COOKIE前綴+mybody”變量，變量?jī)?nèi)容為“帝國(guó)”
esetcookie('mybody','帝國(guó)',0,1)，定義后臺(tái)“COOKIE前綴+mybody”變量，變量?jī)?nèi)容為“帝國(guó)”
附加說(shuō)明：
此設(shè)置COOKIE函數(shù)會(huì)給變量名加上COOKIE前綴，你可也可以直接用PHP本身的setcookie來(lái)定義。

九、取得系統(tǒng)COOKIE變量函數(shù)
語(yǔ)法：getcvar($var,$ecms)
說(shuō)明：
$var：為變量名
$ecms：0為設(shè)置前臺(tái)COOKIE變量，1為設(shè)置后臺(tái)COOKIE變量。此參數(shù)可省略，默認(rèn)為0。
使用范例：
getcvar('mlusername')，取得前臺(tái)登陸會(huì)員的用戶名
getcvar('loginusername',1)，取得后臺(tái)登陸管理員的用戶名
附加說(shuō)明：
此取得COOKIE函數(shù)是取得變量名加上COOKIE前綴的變量，你可也可以直接用PHP本身的$_COOKIE['變量名']來(lái)取得。

十、取得IP地址函數(shù)
語(yǔ)法：egetip()
使用范例：
<?php
$ip=egetip();
echo $ip;
?>

十一、動(dòng)態(tài)頁(yè)面顯示分頁(yè)函數(shù)
語(yǔ)法：page1($num,$line,$page_line,$start,$page,$search)
說(shuō)明：
$num：總記錄數(shù)
$line：每頁(yè)顯示數(shù)量
$page_line：每頁(yè)顯示分頁(yè)鏈接數(shù)
$start：預(yù)設(shè)變量，設(shè)置0即可。
$page：當(dāng)前頁(yè)碼(0為起始頁(yè)碼)
$search：鏈接附加參數(shù)

十二、通過欄目ID取得欄目名和欄目別名方法：
欄目名：<?=$class_r[欄目ID]['classname']?>
欄目別名：<?=$class_r[欄目ID]['bname']?>

上一篇：帝國(guó)CMS擴(kuò)展SQL程序編寫介紹

下一篇：帝國(guó)下載地址使用直接地址不用跳轉(zhuǎn)的修改方法