discuz知识总结

Discuz!系统常用函数及变量：

常用函数：

showmessage()函数 ：该函数就是我们最常见的页面提示跳转，比如登陆、退出、个人信息修改提交等等。

效果演示：

 

函数原型 ：

1. showmessage($message, $url_forward = '', $extra = '', $forwardtype = 0)

复制代码

函数解释 ：在我们Discuz!的php文件中，可以通过这个函数还指定跳转页面，自定义跳转时候的提示信息。
其中有四个参数，第一个是必填参数，后三个为可选参数，可选就是说使用时候可以不用填写，当然填写也不会有错；
第一个参数是跳转时候的提示信息，比如“您的修改已提交，正在为您跳转”；
第二个参数是要跳转的页面的url，就是指定他要跳转到哪个页面，可以是绝对URL，也可以使相对地址，比如：“index.php”就是跳转到首页。
第三个和第四个参数，可选的，对于我们站长来说，基本用不到，可以不用深究。通常使用两个参数即可。

范例 ：showmessage('您的修改已提交，正在为您返回首页', 'index.php');

sendpm()函数 ：该函数用于发送短消息（包括私人消息、系统消息、提醒消息等）。

函数原型：

1. sendpm($toid, $subject, $message, $fromid = '');

复制代码

函数解释：同样在Discuz!的php文件中，我们可以使用该函数发送短消息。
其中有四个参数，前三个为必填参数，最后一个为可选参数；
第一个参数是接收短消息的用户UID；
第二个参数是短消息的标题；
第三个参数是短消息的正文内容；
第四个参数是发送短消息的用户UID；
需要注意：当第一个参数$toid为0时，消息类型为公共消息，$fromid为0时，消息类型为系统消息，$message这个消息内容的参数，不支持HTML，但是支持Discuz!代码。

sendmail函数 ：该函数用于发送电子邮件，前提是论坛系统的邮件必须配置成功，能正常发送邮件。

函数原型：

1. sendmail($email_to, $email_subject, $email_message, $email_from = '')

复制代码

该函数同样有四个参数，其中前三个为必填参数，最后一个为可选参数；
第一个参数是接收电子邮件的用户邮箱（看准了，是电子邮箱）；
第二个参数是电子邮件的标题；
第三个参数是电子邮件的正文内容；
第四个是发送邮件的邮箱；
注意，第四个参数发送邮件的电子邮箱，可选，默认留空则为系统发送的邮件；
这个发送电子邮件的函数不常用到，可以根据自己特殊需求来制作特殊功能时候使用，比如：N天未登录邮件唤醒；

$db对象的各个MYSQL功能函数：
这些MYSQL相关函数，对于初级站长来说比较难，因为涉及php的一些知识，如果不了解这些，请慎用；
下面主要说一下最常用的SQL语句执行函数：$db->query($sql);
$db->query($sql)，通常只指定一个参数，那就是SQL语句，比如：

1. $db->query("SELECT * FROM cdb_mytable");

复制代码

这样就执行了SELECT * FROM cdb_mytable这条SQL语句。
其他更对相关函数，有一定基础的站长，可以参考include/db_mysql.class.php这个文件。

模版中使用的常用JS函数：

showPrompt()函数：
函数效果 ：就像积分变动提醒一样那种漂亮的提示横条，我的Infonitce插件也用到这个函数；

函数范例 ：

1. <span οnclick="showPrompt(null, null, '哈哈', 2000);">[点击我看看是什么效果]</span>

复制代码

函数解释 ：就我们需要的这种功能来说，只需要你关心里面最后两个参数，很明显，“哈哈”这个参数就是提示信息内容，“2000”就是提示信息停留的时间，单位是毫秒！
函数效果演示 ：

 

showDialog函数 ：用于弹出提示窗口

函数原型：

1. showDialog(msg, mode, t, func, cover)

复制代码

第一个参数：弹出窗口里面提示信息的内容；
第二个参数：这个窗口的类型，可选值有：info、notice、alert、confirm等；具体区别参照下图：

 

 


第三个参数：是弹出窗口的标题；
第四个参数：是点击“确定”后执行的函数，非必须，根据自己需要使用函数；
第五个参数：是否带遮罩层（就是弹出窗口后，背景页面是否变成暗色不可用），0为不遮罩，1为遮罩；

函数范例 ：

1. <a οnclick="showDialog('你是坏蛋！', 'notice', '通知信息', null, 0)" href="javascript:;">点击我看看</a>

复制代码

更多JS常用函数，参考： http://bbs.7dps.com/jstour.php

Discuz!系统全局变量篇：

$discuz_userss：当前用户的用户名；
$discuz_uid：当前用户的UID；
$bbname：论坛名称；
$boardurl：论坛地址；
$adminid：论坛管理组的数字ID编号，如：1是管理员，2是超版，3是版主；
$version：论坛的版本号；
$groupid：用户组ID编号；

更多Discuz!系统全局变量参考： http://qun.qq.com/air/#12893286/bbs/view/cd/1/td/2

为Discuz!添加一个属于自己的缓存文件：

首先，我们要知道Discuz!封装的函数writetocache，用来写入缓存的，在include/cache.func.php文件中定义的。
函数原型：writetocache($script, $cachenames, $cachedata = '', $prefix = 'cache_')

那么，要写自己的缓存文件，要用这个函数，首先我们必须调用这个定义函数的文件，如下：

1. require_once DISCUZ_ROOT.'./include/cache.func.php';

复制代码

然后就可以直接使用函数，例如：

writetocache($script, $cachenames, $cachedata = '', $prefix = 'cache_')

Discuz!系统中的模板函数：

大家肯定都注意到，Discuz!系统的可访问页面的php文件底部，一般都会有下面这么一句：

1. include template(xxx);

复制代码

这个就是调用模板文件的一个方法（函数），里面的参数“xxx”就是模板文件的文件名，比如：intro.htm文件，那就是：

1. include template(intro);

复制代码

注意 ，里面的参数只填写模版文件的文件名，不需要填写模版文件的扩展名（.htm）。

那么，模板文件放在哪里呢？可以放在自己当前风格模板目录下，也可以放在系统默认模板目录：templates/default。

在新内核插件中，你也会看到这样的写法：

1. include template(’xxx’, 'xxxx’, 'xxxxx');

复制代码

第一个参数，是模板文件名；
第二个是插件的唯一标识符；
第三个是模板文件存放的目录；

范例如下 ：

1. include template(’tguide’, 'drc_tguide’, './plugins/drc_tguide/templates');

复制代码

模板文件中，如何调用其他系统的模板文件呢？比如，我要做的页面，需要头部和尾部与论坛一致，那么看下面(intro.htm)：

1. {template header}
2. 这里是自己模版文件内容区域
3. {template footer}

复制代码

{template header}这种是在模板文件（.htm）中调用其他模版文件的方法，像上面一样，在开头和结尾分别调用系统的头部和尾部文件，即可实现自己的页面与论坛保持一致的感觉。

然后呢，在模板文件中，可以直接使用对应php文件中的变量，或者系统的全局变量；