Discuz X2任务开发

简单描述

由于公司的需求要在系统中添加任务管理，用户通过完成任务而获得一定的奖励，因此其设计过程需要考虑到：

1、由于任务都是在系统中相关功能块处做一些相关事情，比如说在做题系统中完成指定的试题[1]；在文章系统中发布3篇文章等等，说白了，完成任务就是在这些相关功能块的数据库表中更新一些数据。

2、由[1]的情况，需要对任务进行可扩展配置（How to do?），比如说配置第m单元到第n单元的试题，即配置时要配置相关功能块的数据库表的哪一些字段的值要达到某一个要求或许是总条数达到某一个值。

3、任务完成进度与任务是否完成以及任务访问地址的管理（该访问地址不存在，就需要自己开发）。

简单模型建立

想象一下，假如每一位访问者都要在试题库中做10试题，这很容易完成，我们只需要统计用户所做试题的总数超过10条就行了（条数>10），

 

问题的关键在于，每一个任务的完成要求字段的值（或许总数）所满足的要求不一样（字段不一样，值不一样，表不一样，统计字段不一样），

Discuz 任务管理

 

配置任务

source\class\task目录下存放每一个任务

文件名格式task_任务名.php，类名与文件名格式相同。

以task_promotion.php为例

if(!defined('IN_DISCUZ')) {
    exit('Access Denied');
}

class task_promotion {

    var $version = '1.0';
    var $name = 'promotion_name';
    var $description = 'promotion_desc';
    var $copyright = '<a href="http://www.comsenz.com" target="_blank">Comsenz Inc.</a>';
    var $icon = '';
    var $period = '';
    var $periodtype = 0;
    var $conditions = array(//任务完成的条件
        'num' => array(
            'title' => 'promotion_complete_var_iplimit',
            'type' => 'text',
            'value' => '',
            'default' => 100,
            'sort' => 'complete',
        ),
    );

    function preprocess($task) {//任务进度
        global $_G;

        $promotions = DB::result_first("SELECT COUNT(*) FROM ".DB::table('forum_promotion')." WHERE uid='$_G[uid]'");
        DB::query("REPLACE INTO ".DB::table('forum_spacecache')." (uid, variable, value, expiration) VALUES ('$_G[uid]', 'promotion$task[taskid]', '$promotions', '$_G[timestamp]')");
    }

    function csc($task = array()) {//任务是否完成
        global $_G;

        $num = DB::result_first("SELECT COUNT(*) FROM ".DB::table('forum_promotion')." WHERE uid='$_G[uid]'") - DB::result_first("SELECT value FROM ".DB::table('forum_spacecache')." WHERE uid='$_G[uid]' AND variable='promotion$task[taskid]'");
        $numlimit = DB::result_first("SELECT value FROM ".DB::table('common_taskvar')." WHERE taskid='$task[taskid]' AND variable='num'");
        if($num && $num >= $numlimit) {
            return TRUE;
        } else {
            return array('csc' => $num > 0 && $numlimit ? sprintf("%01.2f", $num / $numlimit * 100) : 0, 'remaintime' => 0);
        }
    }

    function sufprocess($task) {
        global $_G;

        DB::query("DELETE FROM ".DB::table('forum_spacecache')." WHERE uid='$_G[uid]' AND variable='promotion$task[taskid]'");
    }

}

可见source\class\task目录下的文件皆判断任务的完成状态，通方法csc判断任务是否完成！通常情况下还有任务的访问页面方法，前台调用该方法获得做任务的页面。

    function view() {
        return lang('task/avatar', 'avatar_view');
    }

source\admincp  admincp_tasks.php是管理任务的文件，将任务与配置到数据库中

$applyperm = $_G['gp_grouplimit'] == 'special' && is_array($_G['gp_applyperm']) ? implode("\t", $_G['gp_applyperm']) : $_G['gp_grouplimit'];
        $_G['gp_starttime'] = strtotime($_G['gp_starttime']);
        $_G['gp_endtime'] = strtotime($_G['gp_endtime']);
        $reward = $_G['gp_reward'];
        $prize = $_G['gp_prize_'.$reward];
        $bonus = $_G['gp_bonus_'.$reward];
        if(!$_G['gp_name'] || !$_G['gp_description']) {
            cpmsg('tasks_basic_invalid', '', 'error');
        } elseif(($_G['gp_endtime'] && $_G['gp_endtime'] <= TIMESTAMP) || ($_G['gp_starttime'] && $_G['gp_endtime'] && $_G['gp_endtime'] <= $_G['gp_starttime'])) {
            cpmsg('tasks_time_invalid', '', 'error');
        } elseif($reward && (!$prize || ($reward == 'credit' && !$bonus))) {
            cpmsg('tasks_reward_invalid', '', 'error');
        }
        $data = array(
            'relatedtaskid' => $_G['gp_relatedtaskid'],
            'available' => 0,
            'name' => $_G['gp_name'],
            'description' => $_G['gp_description'],
            'icon' => $_G['gp_iconnew'],
            'tasklimits' => $_G['gp_tasklimits'],
            'applyperm' => $applyperm,
            'scriptname' => $_G['gp_script'],
            'starttime' => $_G['gp_starttime'],
            'endtime' => $_G['gp_endtime'],
            'period' => $_G['gp_period'],
            'periodtype' => $_G['gp_periodtype'],
            'reward' => $reward,
            'prize' => $prize,
            'bonus' => $bonus,
        );
        $taskid = DB::insert('common_task', $data, 1);

        if(is_array($task_conditions)) {
            foreach($task_conditions as $taskvarkey => $taskvars) {
                if($taskvars['title']) {
                    $comment = lang('task/'.$_G['gp_script'], $taskvars['title'].'_comment');
                    $comment = $comment != $taskvars['title'].'_comment' ? $comment : '';
                    //if block add by com.zaodao  Jayson.Xie 
                    if($comment == ""){
                        $comment = $taskvars['description'];
                    }
                    $data = array(
                        'taskid' => $taskid,
                        'sort' => $taskvars['sort'],
                        'name' => lang('task/'.$_G['gp_script'], $taskvars['title']),
                        'description' => $comment,
                        'variable' => $taskvarkey,
                        'value' => is_array($_G['gp_'.$taskvarkey]) ? addslashes(serialize($_G['gp_'.$taskvarkey])) : $_G['gp_'.$taskvarkey],
                        'type' => $taskvars['type'],
                    );
                    DB::insert('common_taskvar', $data);
                }
            }
        }

        cpmsg('tasks_succeed', "action=tasks", 'succeed');

    }

数据库中分别用两个表来管理任务

common_task  任务表，记录任务与通用配置信息

 

【关键点】 common_taskvar  个性化配置信息与任务完成条件的记录（完成条件的每一个字段在该表中用一条记录来存储，因此当判断一个任务是否完成就从该表中取出字段，再到相应的表中去查询、统计以确定是否完成）

 

其中字段variable即使记录完成条件中所需要的字段名，

比如文章数目要达到5，就让表中记录variable=‘文章名’,value='5'

description字段是一个注解，显示在

在系统的前台，判断一个用户是否完成，只需要调用scs()方法即可。

注，在discuzX2中，不能配置完成条件的description属性值，系统自带的是 在语言包文件夹下获取的，只需在source\admincp  admincp_tasks.php中添加如下代码即可，

                    if($comment == ""){
                        $comment = $taskvars['description'];
                    }

在每个该段代码的地方都给加上，

在配置完成条件的时候，就可以用description字段。

var $conditions = array(
        'danyuan' => array(
            'title' => '完成的题目数大于或等于此设置，才算完成任务！',
            'type' => 'text',
            'value' => '',
            'default' => 100,
            'sort' => 'complete',
            'description' => 'ssssssssss',
        ),
    
    );