==============帝國CMS呼叫php函式使用介紹=============

一、esub()擷取欄位函式
語法：esub(字串,擷取字數,字尾)
說明：字尾為擷取字元後附帶內容，此引數可以省略。
使用範例：
<?=esub('12345678',6)?>，返回結果為：123456
<?=esub('12345678',6,'...')?>，返回結果為：123456...


二、date()轉換時間格式函式
語法：date(時間格式,時間戳)
說明：PHP本身函式，使用說明可以參考：http://cn2.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/?欄目ID
(2)、/<?=$class_r[欄目ID]['classpath']?>

==============帝國CMS呼叫php函式使用介紹=============

五、取得資訊內容頁地址函式
語法：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']?>

==============帝國CMS呼叫php函式使用介紹=============

十三、獲取當前欄目ID(二級欄目時也是)<?php

$fcr=explode('|',$class_r[$GLOBALS[navclassid]][featherclass]);

$topbclassid=$fcr[0]?$fcr[0]:$GLOBALS[navclassid];//取得當前欄目的一級欄目ID

?>

=$topbclassid?>

十四、獲取當前父欄目ID<?php

$fcr=explode('|',$class_r[$GLOBALS[navclassid]][featherclass]);

$topbclassid=$fcr[2]?$fcr[2]:$GLOBALS[navclassid];//取得當前欄目的一級欄目ID

?>

=$topbclassid?>

十五、獲取當頂級欄目ID(三級欄目的頂級)<?php

$fcr=explode('|',$class_r[$GLOBALS[navclassid]][featherclass]);

$topbclassid=$fcr[1]?$fcr[1]:$GLOBALS[navclassid];//取得當前欄目的一級欄目ID

?>

=$topbclassid?>

註釋：

$fcr[0] 當前

$fcr[1] 頂級前

$fcr[2] 當前父欄目