discuz後臺開發經常使用函數

時間 2019-11-08

原文原文鏈接

showsetting()表單顯示

返回值：無
參數：

$setname - 指定輸出標題，如:setting_basic_bbname, 自動匹配描述文字爲：setting_basic_bbname_comment，comment形式文字能夠在./source/language/lang_admincp.php語言包中添加
$varname - 指定表單的name值，如settingnew[bbname]
$value - 指定表單默認值\變量
$type - 表單樣式
1. radio單選
2. text文本、password密碼、number數字
3. file上傳文件
4. filetext 上傳文件或在線文件切換型表單
5. textarea 多行文本
6. select 選擇框
7. mradio 高級單選模式
8. mcheckbox 高級多選模式
9. binmcheckbox 二進制數值多選模式
10. mselect 高級選擇框模式
11. color 顏色選擇
12. calendar 日期選擇
13. multiply多表單型，daterange時間範圍
14. 其餘未在上述樣式中出現的$type均獨立輸出

$disabled - 是否不可修改
$hidden - 是否隱藏
$comment - 強制描述文字
$extra - 表單擴展屬性
$setid - 用於拼接表單外層Div的id

使用方法舉例：
以文本形式輸出表單(站點名稱 text)：

showsetting('setting_basic_bbname', 'settingnew[bbname]', $setting['bbname'], 'text');

以單選形式輸出表單(顯示受權信息連接 radio)：

showsetting('setting_basic_boardlicensed', 'settingnew[boardlicensed]', $setting['boardlicensed'], 'radio');

以多行文本形式輸出表單(網站第三方統計代碼 textarea)：

showsetting('setting_basic_stat', 'settingnew[statcode]', $setting['statcode'], 'textarea');

以高級單選形式輸出表單(新用戶註冊驗證 mradio)

showsetting('setting_access_register_verify', array('settingnew[regverify]', array(
array(0, $lang['none'], array('regverifyext' => 'none')),
array(1, $lang['setting_access_register_verify_email'], array('regverifyext' => '')),
array(2, $lang['setting_access_register_verify_manual'], array('regverifyext' => ''))
)), $setting['regverify'], 'mradio');

以高級多選形式輸出表單('容許新用戶註冊 mcheckbox)

showsetting('setting_access_register_status', array('settingnew[regstatus]', array(
array('open', $lang['setting_access_register_open']),
array('invite', $lang['setting_access_register_invite'], 'showinvite'),
$_G['setting']['connect']['allow'] ? array('connect', $lang['setting_access_register_connect'], 'showconnect') : array(),
)), $regstatus, 'mcheckbox');

cpmsg()提示消息

返回值：無
參數：

$message - lang_admincp_msg.php 語言包中須要輸出的key
$url - 提示信息後跳轉的頁面，留空則返回上一頁
$type - 特殊提示信息時指定頁面的提示樣式，可選參數：succeed、error、download、loadingform
$values - 爲語言包中的變量關鍵詞指定值，以數組形式輸入
$extra - 消息文字擴展
$halt - 是否輸出「Discuz! 提示」標題

使用方法舉例：
成功提示信息

cpmsg('tasks_installed', 'action=tasks&operation=type', 'succeed');

錯誤提示信息，並傳遞變量(cachethreaddir爲要傳遞如語言包中的變量關鍵詞)

cpmsg('cachethread_dir_noexists', '', 'error', array('cachethreaddir' => $settingnew['cachethreaddir']));

showformheader()建立表單頭

返回值：無
參數:

$action - 表單action的一部分，程序會自動添加 admincp.php?action= 這些內容
$extra - 表單附加屬性，能夠是樣式等
$name - 表單的name和id
$method - 表單提交方式

使用方法舉例，合併版塊表單：

showformheader('forums&operation=merge');

showformfooter()建立表單尾

無返回值、無參數
用於接上showformheader()函數進行收尾工做

showtableheader()建立表格頭

返回值：無
參數：

$title - 若是輸入title則顯示標題，class爲header，不然僅顯示一個table頭
$classname - 定義此輸出表格的CSS樣式
$extra - 表格擴展屬性
$titlespan - 表格列數

使用方法實例：

showtableheader('forums_edit_posts', 'nobottom');

showtablefooter()建立表格尾

用於接上showformheader()函數進行收尾工做php

showtablerow()建立列表式頁面的行

返回值：有
參數：

$trstyle - 此行 tr 標籤的格式定義，如
$tdstyle - TD 標籤的格式定義，如 class，colspan 等
$tdtext - TD內顯示的內容
$return 是否返回值

此函數多用於循環中，用來逐行建立一個有規律的數據列表如：論壇版塊列表等
使用方法舉例 ./source/admincp/admincp_forums.php

showtablerow('', array('class="td25"', 'class="td28"'), array(
'',
'',
"$mod[username]",
$modgroups[$mod['groupid']],
cplang($mod['inherited'] ? 'yes' : 'no'),
));

showsubmit()建立提交按鈕

返回值：無

$name - 定義提交按鈕的name值
$value - 定義按鈕的文字值
$before - 根據此按鈕以前的屬性來輸出樣式
$after - 根據此按鈕以後的屬性來輸出樣式
$floatright - 是否有浮動
$entersubmit - 是否使用回車定義按鈕提交動做

showhiddenfields()建立隱藏表單域

返回值：無
參數：

$hiddenfields 以數組形式傳入，循環輸出隱藏表單域

showsubmenu()二級導航欄顯示

返回值：無
參數：

$title - 二級導航的當前欄標題
$menus - 多個子導航

使用方法舉例：
後臺-用戶-會員管理

showsubmenu('nav_members', array(
array('search', 'members&operation=search', 1),
array('clean', 'members&operation=clean', 0),
array('nav_repeat', 'members&operation=repeat', 0),
));

shownav()麪包屑導航欄顯示及二級導航欄標題

返回值：無
參數：

$header - 導航起點
$menu - 子導航標題
$nav - 麪包屑導航第三層

使用方法舉例：
後臺-運營-電子商務

shownav('extended', 'nav_ec', 'nav_ec_config');

以上列舉的均爲最經常使用後臺函數，仔細瞭解這些函數的使用已經可以知足您對 Discuz! X 系列版本的後臺開發需求

相關標籤/搜索

每日一句

每一个你不满意的现在，都有一个你没有努力的曾经。