PHPCMS經常使用及其調用方法

一、可視化編輯器的調用方法
須要用到editor函數，editor($textareaid = 'content', $toolbar = 'phpcms', $width = 500, $height = 400)

$textareaid 爲文本框 id
$toolbar 爲工具按鈕樣式，目前有 phpcms 和 introduce 兩種能夠選擇，通常較大的內容編輯框用 phpcms，而簡要介紹則用 introduce
$width 指定編輯器的寬度
$height 指定編輯器的高度

例如：在文章模塊發佈文章時的內容編輯採用可視化編輯器的代碼以下

<textarea name="article[content]" id="content" cols="60" rows="4"></textarea>
<?=editor("content","phpcms",550,400)?>

二、驗證碼的調用方法

在模板中調用驗證碼
<input name="checkcodestr" type="text" size="15">
<img src="{PHPCMS_PATH}checkcode.php" id="checkcode"  style="cursor:pointer;" alt="驗證碼,看不清楚?請點擊刷新驗證碼" align="absmiddle"/>

驗證驗證碼是否正確的php代碼
checkcode($checkcodestr, $PHPCMS['enableadmincheckcode'], $PHP_REFERER);

該函數原型以下：
checkcode($checkcode, $enable = 1, $forward = '')
$checkcode 爲用戶輸入的值，$enable 爲當前驗證碼是否啓用，$forward 指定當用戶輸入的驗證碼錯誤後的跳轉地址

三、模板調用方法

前臺

include template($mod, $file);
$mod 爲模板所屬的模塊，$file 爲模板去後綴 .html 後的文件名

後臺

include admintpl($file);
$file 爲模板去後綴 .tpl.php 後的文件名

四、生成html的方法

首先把建立html的php程序存放到模塊目錄的 include/createhtml/ 目錄下，而後經過 createhtml($filename, $mod_root="") 函數來調用並生成html
$filename 爲 include/createhtml/ 目錄下去了 .inc.php 後的文件名，$mod_root 爲當前模塊目錄的物理路徑，可省略

例如如下代碼能夠生成文章ID號爲1的文章html頁：
$articleid = 1;
createhtml('show') ;

關於生成html的詳細方法參見文章模塊代碼（./module/article/）

五、給標題進行顏色和是否加粗的控制調用方法

首先應該在標題所在的數據表中建立一個 style 字段來存放樣式值，而後在模板中標題的輸入框旁邊插入如下代碼：
添加信息時：<?=style_edit($inputname, '')?>
編輯信息時：<?=style_edit($inputname, $style)?>

系統將根據 $inputname 變量的值建立一個隱藏表單，和標題同樣，該表單值會隨着表單的提交而發送給php，應該把該值存放到 style 字段。

在顯示標題時，須要使用如下代碼：
$title = style($title, $style)；

六、後臺子菜單調用方法

相似如下代碼
$submenu = array
(
array("管理首頁", "?mod=".$mod."&file=".$file."&channelid=".$channelid."&action=manage"),
array("添加欄目", "?mod=".$mod."&file=".$file."&channelid=".$channelid."&action=add"),
array("合併欄目", "?mod=".$mod."&file=".$file."&channelid=".$channelid."&action=join"),
array("欄目數據修復", "?mod=".$mod."&file=".$file."&channelid=".$channelid."&action=repair")
);
$menu = adminmenu("欄目管理",$submenu);

七、操做提示信息調用方法

showmessage($msg, $url_forward = '')；

$msg 爲提示信息，$url_forward 爲跳轉地址

八、用戶組選擇框的調用方法

showgroup($type = 'select', $name = 'groupid', $checked = '', $perline = 5)

$type 可選值爲 select 、 checkbox 、radio ，分別能夠產生下拉菜單、複選框、單選按鈕
$name 爲要建立的表單名
$checked 爲選定的值
$perline 當顯示類型爲單選或者複選時用來控制每行的顯示個數

此方法在按用戶組設置權限時須要用到

九、模板選擇下拉框調用方法

showtpl($module = 'phpcms', $type = 'index', $name = 'templateid', $templateid = 0, $property = '')

$module 爲要調用的模板所屬的模塊
$type 爲模板類型名，好比首頁模板類型爲 index
$name 爲下拉框表單名
$templateid 被選定的模板名
$property 表單附加屬性，好比js或者id能夠在這裏寫

十、風格選擇下拉框調用方法

showskin($name = 'skinid', $skinid = '', $property = '')

$name 爲下拉框表單名
$skinid 爲選定的風格名
$property 表單附加屬性，好比js或者id能夠在這裏寫

十一、頻道選擇下拉框調用方法

channel_select($module = '', $name = 'channelid', $defaultalt = "', $channelid = 0, $property = "')

$module 指定頻道所屬模塊，若是不指定則生成全部頻道的下拉選擇
$name 下拉表單名
$defaultalt 默認選中的提示信息，好比可寫「請選擇頻道」
$channelid 選中的頻道id
$property 表單附加屬性，好比js或者id能夠在這裏寫

十二、欄目選擇下拉框調用方法

category_select($name = 'catid', $defaultalt = "', $catid = 0, $property = "')

$name 爲下拉表單名
$defaultalt 默認選中的提示信息，好比可寫「請選擇欄目」
$catid 選中的欄目id
$property 表單附加屬性，好比js或者id能夠在這裏寫

在調用此函數前應該先加載 ./include/tree.class.php 並實例化 tree 類建立好一個 $tree 對象
此函數默認產生當前頻道的欄目下拉框

1三、專題選擇下拉框調用方法

special_select($channelid = 0, $name = 'specialid', $defaultalt = "請選擇專題", $specialid = 0, $property = '')

$channelid 指定專題所屬的頻道
$name 爲下拉表單名
$defaultalt 默認選中的提示信息，好比可寫「請選擇專題」
$specialid 選中的專題id
$property 表單附加屬性，好比js或者id能夠在這裏寫

1四、專題子分類選擇下拉框調用方法

special_type_select($specialid, $name = 'special_typeid', $defaultalt = "請選擇子類", $typeid = 0, $property = '')

$specialid 指定專題id
$name 爲下拉表單名
$defaultalt 默認選中的提示信息，好比可寫「請選擇子分類」
$typeid 選中的子分類id
$property 表單附加屬性，好比js或者id能夠在這裏寫

1五、附屬分類調用方法

type_select($typeids, $name = 'typeid', $defaultalt = "類別", $typeid = 0, $property = '')

$typeids 當前頻道或者模塊所選用的全部子分類id，能夠是數組，也能夠是逗號分割開的數字字串
$name 爲下拉表單名
$defaultalt 默認選中的提示信息，好比可寫「請選擇分類」
$typeid 選中的分類id
$property 表單附加屬性，好比js或者id能夠在這裏寫

1六、url規則選擇下拉框調用方法

urlrule_select($name, $fileext = 'html', $type = 'cat', $urlruleid = 0, $property = '')

$name 爲下拉表單名
$fileext 可選值爲 html 和 php
$type 可選值爲 cat、item、special
$urlruleid 選中的url規則id
$property 表單附加屬性，好比js或者id能夠在這裏寫

1七、單網頁選擇下拉框調用方法

page_select($channelid = 0, $property = '')

$channelid  指定單網頁所屬頻道id
$property 表單附加屬性，好比js或者id能夠在這裏寫

1八、模塊配置保存方法

每一個模塊都應該有本身的配置信息，能夠本身根據須要來創建配置表單，保存的時候統一根據
module_setting($module, $setting)
來進行配置保存

$module 爲配置所屬的模塊
$setting 爲模塊配置所組成的數組

參見：./admin/setting.inc.php

1九、在可複製模塊中調用欄目管理的方法

添加欄目：?mod=phpcms&file=category&action=add&channelid=1
管理欄目：?mod=phpcms&file=category&action=manage&channelid=1
合併欄目：?mod=phpcms&file=category&action=join&channelid=1

其中 channelid 參數應該爲當前頻道 ID

20、在可複製模塊中調用專題管理的方法

添加專題：?mod=phpcms&file=special&action=add&channelid=1
管理專題：?mod=phpcms&file=special&action=manage&channelid=1
合併專題：?mod=phpcms&file=special&action=join&channelid=1

其中 channelid 參數應該爲當前頻道 ID

2一、在可複製模塊中調用附屬分類管理的方法

url： ?mod=phpcms&file=type&action=setting&channelid=1

其中 channelid 參數應該爲當前頻道 ID

2二、在獨立模塊中調用欄目管理的方法

請自行參考 ./product/admin/category.inc.php

2三、在獨立模塊中調用附屬分類管理的方法

url： ?mod=phpcms&file=type&action=setting&module=product

其中 module 參數應該爲當前模塊名

2四、自定義字段功能的調用方法

phpcms自定義字段功能是經過給數據表增長前綴爲 my_ 的字段來實現的，適用於全部帶信息發佈的模塊和頻道，下面講一下調用方法：
在頻道或者模塊的導航中作一個連接，例如文章模塊調用url爲：

?mod=phpcms&file=field&action=manage&channelid=1&tablename=phpcms_article_1

注意：tablename 爲要定義字段的數據表名，這個參數不能少

那麼在發表文章的程序中顯示自定義字段表單應該這樣獲得：

require PHPCMS_ROOT.'/admin/include/field.class.php';
$field = new field('phpcms_article_1');

$fieldform = $field->get_form('tablerow'); // tablerow 爲css樣式名

文章發表時自定義自段的內容應該這樣保存：

$field->update('articleid=1'); // articleid=1 這個表示更新 articleid 爲 1 的文章的自定義自段內容

前臺顯示自定義自段內容的方法和顯示標題 title 相似

2五、獲得欄目下級欄目信息得調用方法

subcat($keyid, $catid = 0, $type = 'menu');

$keyid 能夠是 頻道id ， 也能夠是模塊英文名
$catid 爲欄目ID
$type 可選值爲 menu 或 list，分別表示導航和列表

2六、獲得當前位置得方法

前臺：catpos($catid, $s = '>>');
後臺：admin_catpos($catid, $s = '>>');

2七、發送郵件的方法

require PHPCMS_ROOT.'/include/mail.inc.php';

if(sendmail("[email=zhongshenghui@163.com,phpcms@163.com]zhongshenghui@163.com,phpcms@163.com[/email]", "郵件主題", "郵件內容", "測試<locoybb@126.com>"))
echo "發送成功";
else echo "失敗";

函數原型：sendmail($mail_to, $mail_subject, $mail_body, $mail_from = '')

$mail_to：能夠是 user@example.com 
user@example.com, anotheruser@example.com 
User <user@example.com> 
User <user@example.com>, Another User anotheruser@example.com 
$mail_from：能夠是 user@example.com 或 User user@example.com

2八、日期選擇的調用方法

date_select($name, $value = '', $format = 'yyyy-mm-dd')$name 是表單名$value 是表單的默認值，例如：2006-12-16$format 日期格式，通常這個參數不用指定