Discuz! X2插件制造之后台常用函数

2012-10-14

Discuz! X2插件制作之后台常用函数当您在编写后台时，需要对几个常用后台显示函数进行详细的了解?下面的函

Discuz! X2插件制作之后台常用函数

当您在编写后台时，需要对几个常用后台显示函数进行详细的了解?
下面的函数讲解按照重要性、常用性进行排序?
目录?

1 showsetting()表单显示?
2 cpmsg()提示消息?
3 showformheader()创建表单头?
4 showformfooter()创建表单尾?
5 showtableheader()创建表格头?
6 showtablefooter()创建表格尾?
7 showtablerow()创建列表式页面的行?
8 showsubmit()创建提交按钮?
9 showhiddenfields()创建隐藏表单域?
10 showsubmenu()二级导航栏显示?
11 shownav()面包屑导航栏显示及二级导航栏标题

复制代码

showsetting()表单显示
返回值：无?
参数：?

$setname - 指定输出标题，如:setting_basic_bbname, 自动匹配描述文字为：setting_basic_bbname_comment，comment形式文字可以在./source/language/lang_admincp.php语言包中添加?
$varname - 指定表单的name值，如settingnew[bbname]?
$value - 指定表单默认值\变量?
$type - 表单样式?
radio单选?
text文本、password密码、number数字?
file上传文件?
filetext 上传文件或在线文件切换型表单?
textarea 多行文本?
select 选择框?
mradio 高级单选模式?
mcheckbox 高级多选模式?
binmcheckbox 二进制数值多选模式?
mselect 高级选择框模式?
color 颜色选择?
calendar 日期选择?
multiply多表单型，daterange时间范围?
其他未在上述样式中出现的$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()函数进行收尾工作?

showtablerow()创建列表式页面的行
返回值：有?
参数：?

$trstyle - 此行 tr 标签的格式定义，如 style="margin-top: 10px; margin-right: 0px; margin-bottom: 10px; margin-left: 0px; padding-top: 10px; padding-right: 0px; padding-bottom: 5px; padding-left: 10px; background-color: #c9caf8; color: #333333; font-size: 14px; line-height: 21px; background-position: 0px 0px; border: 1px solid #cccccc;">
1. showtablerow('', array('name="delete[]" value="'.$mod[uid].'"'.($mod['inherited'] ? ' disabled' : '').' />',
2. ? ?? ???'<input type="text" name="displayordernew['.$mod[uid].']" value="'.$mod[displayorder].'" size="2" />',
3. ? ?? ???"<a href="".ADMINSCRIPT."?mod=forum&action=members&operation=group&uid=$mod[uid]" target="_blank">$mod[username]</a>",
4. ? ?? ???$modgroups[$mod['groupid']],
5. ? ?? ???cplang($mod['inherited'] ? 'yes' : 'no'),
6. ));
复制代码

showsubmit()创建提交按钮
返回值：无?
1. $name - 定义提交按钮的name值?
2. $value - 定义按钮的文字值?
3. $before - 根据此按钮之前的属性来输出样式?
4. $after - 根据此按钮之后的属性来输出样式?
5. $floatright - 是否有浮动?
6. $entersubmit - 是否使用回车定义按钮提交动作?
7. showhiddenfields()创建隐藏表单域
复制代码
返回值：无?
参数：?
1. $hiddenfields <array> 以数组形式传入，循环输出隐藏表单域?
2. showsubmenu()二级导航栏显示
复制代码
返回值：无?
参数：?
1. $title - 二级导航的当前栏标题?
2. $menus <array> - 多个子导航
复制代码

使用方法举例：?
后台-用户-会员管理?
1. showsubmenu('nav_members', array(
2. ? ?? ???array('search', 'members&operation=search', 1),
3. ? ?? ???array('clean', 'members&operation=clean', 0),
4. ? ?? ???array('nav_repeat', 'members&operation=repeat', 0),
5. ));
复制代码
shownav()面包屑导航栏显示及二级导航栏标题
返回值：无?
参数：?
1. $header - 导航起点?
2. $menu - 子导航标题?
3. $nav - 面包屑导航第三层
复制代码

使用方法举例：?
后台-运营-电子商务?
1. shownav('extended', 'nav_ec', 'nav_ec_config');
复制代码

以上列举的均为最常用后台函数，仔细了解这些函数的使用已经能够满足您对 Discuz! X 系列版本的后台开发需求
?
海口论坛 http://www.souhaikou.com
海口微博 http://t.souhaikou.com

热点排行

编程

Discuz! X2插件制造之后台常用函数