Discuz! X2插件制作之后台常用函数
2013-08-20 10:06
351 查看
当您在编写后台时,需要对几个常用后台显示函数进行详细的了解
下面的函数讲解按照重要性、常用性进行排序
目录
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 标签的格式定义,如 class="partition"
$tdstyle <array> - TD 标签的格式定义,如 class,colspan 等
$tdtext <array> - TD内显示的内容
$return 是否返回值
复制代码
此函数多用于循环中,用来逐行创建一个有规律的数据列表如:论坛版块列表等
使用方法举例 ./source/admincp/admincp_forums.php
showtablerow('', array('class="td25"', 'class="td28"'), array(
'<input type="checkbox" class="checkbox" name="delete[]" value="'.$mod[uid].'"'.($mod['inherited'] ? ' disabled' : '').' />',
'<input type="text" class="txt" name="displayordernew['.$mod[uid].']" value="'.$mod[displayorder].'" size="2" />',
"<a href=\"".ADMINSCRIPT."?mod=forum&action=members&operation=group&uid=$mod[uid]\" target=\"_blank\">$mod[username]</a>",
$modgroups[$mod['groupid']],
cplang($mod['inherited'] ? 'yes' : 'no'),
));
复制代码
showsubmit()创建提交按钮
返回值:无
$name - 定义提交按钮的name值
$value - 定义按钮的文字值
$before - 根据此按钮之前的属性来输出样式
$after - 根据此按钮之后的属性来输出样式
$floatright - 是否有浮动
$entersubmit - 是否使用回车定义按钮提交动作
showhiddenfields()创建隐藏表单域
复制代码
返回值:无
参数:
$hiddenfields <array> 以数组形式传入,循环输出隐藏表单域
showsubmenu()二级导航栏显示
复制代码
返回值:无
参数:
$title - 二级导航的当前栏标题
$menus <array> - 多个子导航
复制代码
使用方法举例:
后台-用户-会员管理
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 系列版本的后台开发需求
下面的函数讲解按照重要性、常用性进行排序
目录
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 标签的格式定义,如 class="partition"
$tdstyle <array> - TD 标签的格式定义,如 class,colspan 等
$tdtext <array> - TD内显示的内容
$return 是否返回值
复制代码
此函数多用于循环中,用来逐行创建一个有规律的数据列表如:论坛版块列表等
使用方法举例 ./source/admincp/admincp_forums.php
showtablerow('', array('class="td25"', 'class="td28"'), array(
'<input type="checkbox" class="checkbox" name="delete[]" value="'.$mod[uid].'"'.($mod['inherited'] ? ' disabled' : '').' />',
'<input type="text" class="txt" name="displayordernew['.$mod[uid].']" value="'.$mod[displayorder].'" size="2" />',
"<a href=\"".ADMINSCRIPT."?mod=forum&action=members&operation=group&uid=$mod[uid]\" target=\"_blank\">$mod[username]</a>",
$modgroups[$mod['groupid']],
cplang($mod['inherited'] ? 'yes' : 'no'),
));
复制代码
showsubmit()创建提交按钮
返回值:无
$name - 定义提交按钮的name值
$value - 定义按钮的文字值
$before - 根据此按钮之前的属性来输出样式
$after - 根据此按钮之后的属性来输出样式
$floatright - 是否有浮动
$entersubmit - 是否使用回车定义按钮提交动作
showhiddenfields()创建隐藏表单域
复制代码
返回值:无
参数:
$hiddenfields <array> 以数组形式传入,循环输出隐藏表单域
showsubmenu()二级导航栏显示
复制代码
返回值:无
参数:
$title - 二级导航的当前栏标题
$menus <array> - 多个子导航
复制代码
使用方法举例:
后台-用户-会员管理
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 系列版本的后台开发需求
相关文章推荐
- Discuz! X2插件制作之后台常用函数
- Discuz! X2.5 插件制作之后台常用函数详解 [复制链接]
- wordpress基础插件开发5-后台常用HTML总结
- 后台程序开发常用jQuery插件
- Discuz!X 后台常用函数 showsetting 实例之 select 篇
- asp判断函数一览及网页制作常用技巧
- 用tagcloud插件制作的超炫酷“云标签”(3D旋转和平铺),附前后台代码及标签配置页面
- 【转】Wordpress后台相关的常用插件
- asp制作中常用到的函数库集合第1/8页
- sublime text3--制作网页常用插件
- jQuery SuperSlide插件制作72个种常用的网页特效
- Wordpress后台相关的常用插件
- discuz后台开发常用函数
- jQuery插件制作之全局函数
- jquery 神一样的插件制作 10几种常用网页特效 只有4.5K大小
- jqGrid表格插件常用方法及函数留档
- 制作php留言板常用的函数
- WordPress插件制作教程(六): 插件函数之动作(Actions)函数
- 如何快速制作脚本,不用插件也能用按键精灵后台发送消息
- dz插件开发(一) 从常用的常量 变量 函数开始