Discuz!7.0 論壇任務開發流程與文檔

Discuz!7.0是康盛創想(Comsenz)公司于2008年12月份發布的一款論壇BBS建站產品。Discuz!7.0論壇任務開發文檔本期就為大家介紹下。

//note 任務名稱 $task_name = $tasklang['gift_name']; //note 任務描述 $task_description = $tasklang['gift_desc']; //note 任務圖標，圖標文件需上傳到論壇 images/tasks 目錄，這里填寫圖標文件名即可。留空則使用默認圖標。圖標尺寸最好是 64X64 。

Discuz! 任務系統預留了安裝、升級、卸載等多個接口，便于插件作者設計新的任務類型。

一、任務設計流程：

o 熟練使用 Discuz! 論壇系統后，對希望完善或補充的個性化功能進行評估，進而提出任務的功能需求。

o 對任務做一個概括性的設計，例如：完成任務的條件，需要使用什么參數，配置哪些選項、數據結構如何設計等等。

o 編寫相應程序代碼，實現所需的功能并進行代碼測試、兼容性測試和代碼改進。

o 編寫任務說明書，其中包括：任務適用的 Discuz! 版本、功能概述、兼容性聲明、安裝方法、使用方法、卸載方法等等。

o 將任務提供給他人，或自己使用，根據使用者反饋，對任務進行完善。

二、任務腳本命名規范：

o 主程序文件 *.inc.php 置于 include/tasks/ 目錄下。

o 配置文件 *.cfg.php 置于 include/tasks/ 目錄下。

o 主程序文件和配置文件的文件名部分必須一致，比如：gift.inc.php 和 gift.cfg.php。

三、任務數據結構：

任務表(cdb_tasks)：

taskid 任務的唯一 ID，自動遞增

relatedtaskid 依存任務ID：必須完成依存任務才能申請該任務

available 是否啟用

name 任務名稱 不超過 50 字節

description 任務描述 支持 html

icon 任務圖標 必須是 images/tasks 目錄下的文件 這里只需文件名即可 留空使用默認圖標

applicants 已申請任務人次

achievers 已完成任務人次

tasklimits 允許申請并完成該任務的人次上限

applyperm 允許申請任務的用戶組ID(使用 隔開，如: 1 2 3)

scriptname 任務腳本文件名(如：gift)

starttime 任務上線時間(unix時間戳)

endtime 任務下線時間(unix時間戳)

period 任務周期 單位：小時 默認為0表示一次性任務 設置為24即1天表示日常任務

reward 獎勵類型, credit: 積分, magic: 道具, medal: 勛章, invite: 邀請碼, group: 特殊用戶組

prize 獎品: 哪一個擴展積分, 道具ID, 勛章ID,邀請碼有效期， 特殊用戶組ID

bonus 獎品數量/有效期: 積分數量, 道具數量, 勛章有效期, 邀請碼數量，特殊用戶組有效期

displayorder 顯示順序

任務變量表(cdb_taskvars)：

taskvarid 任務變量的唯一 ID，自動遞增

taskid 任務ID

sort 變量類別(apply:用于申請任務的條件 complete:用于完成任務的條件 setting:用于任務設置)

name 變量名稱

description 變量描述

variable 變量名

type 變量類型(數字:number 字串:text 文本:textarea 開關:radio 選擇:select)

value 變量值

extra 變量附加值(當變量類型為 select 時，變量值可選的取值范圍)

我的任務表(cdb_mytasks)：

uid 會員 UID

username 用戶名

taskid 任務 ID

status 任務狀態 -1失敗 0進行中 1已完成

csc 任務進度(浮點數，任務進度百分比，保留小數點后兩位，并且去掉百分號，如：80.33)

dateline 申請任務時間(unix時間戳)