Discuz正式版論壇群組接口使用說(shuō)明

1、Discuz X2.5正式版論壇與群組接口使用手冊(cè)一、簡(jiǎn)介1、本接口應(yīng)用于discuz! X2.5 正式版 (Release 20130426) 論壇和群組帖子發(fā)布，支持發(fā)布回復(fù)和附件入庫(kù)；2、本接口完美支持附件入庫(kù)，附件可動(dòng)態(tài)顯示，支持DZX內(nèi)部附件標(biāo)記，所有附件都可以在編輯帖子時(shí)管理以及在后臺(tái)管理；3、本接口支持遠(yuǎn)程附件，詳見(jiàn)發(fā)布接口附件部分說(shuō)明；4、本接口支持預(yù)發(fā)布（定時(shí)發(fā)布），詳見(jiàn)發(fā)布接口參數(shù)cronpublish 說(shuō)明；5、本接口支持回帖獎(jiǎng)勵(lì)設(shè)置，詳見(jiàn)發(fā)布接口回帖獎(jiǎng)勵(lì)部分說(shuō)明6、本接口支持廣播，詳見(jiàn)參數(shù)adddynamic ；7、本接口支持自動(dòng)發(fā)布回復(fù)帖，回復(fù)用戶為賬號(hào)列表中隨機(jī)使用

2、、回復(fù)時(shí)間自動(dòng)擬真，詳見(jiàn)參數(shù) zzhour ；8、本接口支持自動(dòng)獲取標(biāo)簽，詳見(jiàn)參數(shù)tagauto ；9、本接口支持自動(dòng)發(fā)送動(dòng)態(tài)到家園，詳見(jiàn)參數(shù)addfeed ；10、本接口支持更改附件目錄，詳見(jiàn)參數(shù)ashowurl ；11、本接口可設(shè)置隨機(jī)點(diǎn)擊數(shù)，詳見(jiàn)參數(shù)maxclick；12、由于用戶可能同時(shí)使用discuz! X2.5正式版的多種接口，請(qǐng)注意修改接口名稱(chēng)，使每種接口區(qū)別，例如本接口包里提供的接口文件都加上了“bbs”的文件名后綴；13、發(fā)布時(shí)使用的用戶帳號(hào)應(yīng)已在論壇注冊(cè)，如果是發(fā)布群組帖子， 用戶應(yīng)屬于該群組；14、圖片除了使用 ET 的水印功能，還支持X2.5 正式版的水印功能；15、帖

3、子內(nèi)容除了使用 ET 的整理過(guò)濾，還支持 X2.5 正式版的審核、過(guò)濾；16、使用本接口時(shí)，發(fā)布配置應(yīng)啟用“使用UBB 代碼格式”，除非您在 X2.5正式版后臺(tái)開(kāi)啟了允許 HTML 代碼；17、在 discuz! X2.5 正式版 utf8版使用本接口時(shí)，請(qǐng)?jiān)诎l(fā)布規(guī)則中選擇編碼為UTF-8；18、本接口基于 discuz! X2.5正式版 GBK版制作，適用于 discuz! X2.5 正式版 GBK/utf-8等版本，應(yīng)用于其他版本時(shí)請(qǐng)自行測(cè)試調(diào)整；19、接口文件無(wú)須任何改動(dòng)即可使用，如果你希望增加校驗(yàn)或其他功能，請(qǐng)仔細(xì)修改；20、 3 個(gè)接口文件請(qǐng)復(fù)制在discuz! X2.5 正式版網(wǎng)站

4、根目錄下使用；二、安裝接口在接口文件夾中找到接口文件，如圖：請(qǐng)將 etchk_bbs.php 、 etpost_bbs.php 、 etreply_bbs.php 等接口文件上傳到指定目錄，請(qǐng)使用二進(jìn)制方式上傳，如圖：三、配置發(fā)布規(guī)則1、將范例發(fā)布規(guī)則文本導(dǎo)入ET2發(fā)布配置，或使用軟件內(nèi)置發(fā)布規(guī)則范例，如圖：2、將檢查網(wǎng)址和發(fā)布網(wǎng)址中的“您的網(wǎng)站”改為您要發(fā)布的網(wǎng)站網(wǎng)址，如圖：3、在參數(shù)取值頁(yè)，填上您要發(fā)布的版塊ID 或群組 ID，如圖：打開(kāi)論壇或群組頁(yè)面，可以查看版塊ID，即 fid 的值：5、填上注冊(cè)用戶的賬號(hào)、密碼，注意格式和賬號(hào)權(quán)限（需要某些驗(yàn)證或操作才允許發(fā)帖的論壇，賬號(hào)應(yīng)已完成驗(yàn)證

5、） ，如圖：四、接口說(shuō)明一、檢查接口1、接口文件名etchk_bbs.php ，為保密，請(qǐng)自行修改文件名；2、本接口文件請(qǐng)復(fù)制在網(wǎng)站根目錄下使用；3、主要參數(shù)subject文章標(biāo)題 ;fid論壇版塊ID,用于限定檢查范圍，可不填；vercode請(qǐng)自行設(shè)定，并在檢查接口文件開(kāi)始處修改vercode 使其一致；4、發(fā)布配置 -文章檢查網(wǎng)址處，可以如下填寫(xiě)：http:/ 您的網(wǎng)址 /etchk_bbs.php?vercode=&fid=&subject=<%title%> 注：使用大小寫(xiě)敏感的服務(wù)器的用戶請(qǐng)注意網(wǎng)址大小寫(xiě)和網(wǎng)站文件一致5、接口文件無(wú)須任何改動(dòng)即可使用，如果

6、你希望增加校驗(yàn)或其他功能，請(qǐng)仔細(xì)修改；二、發(fā)布接口1、接口文件名etpost_bbs.php ，為保密，請(qǐng)自行修改文件名；2、本接口文件請(qǐng)復(fù)制在網(wǎng)站根目錄下使用；注：以下參數(shù)名后“ =”號(hào)為示范取值而用，參數(shù)名本身不含“ =”號(hào)；固定取值的參數(shù)，可以在發(fā)布規(guī)則 -參數(shù)取值中設(shè)置；采集取值的參數(shù)項(xiàng)，請(qǐng)?jiān)诎l(fā)布規(guī)則-發(fā)布項(xiàng)中添加；3、主要參數(shù)usernamepasswordsubjectmessageetattachs會(huì)員名參數(shù)名密碼參數(shù)名主題標(biāo)題參數(shù)名內(nèi)容參數(shù)名文件列表參數(shù)名4、附加參數(shù)fid論壇版塊編號(hào) (取值為您要發(fā)布的版面FID 號(hào) )vercode安全校驗(yàn)碼，請(qǐng)自行設(shè)定，并須與發(fā)布接口文件

7、開(kāi)始處vercode 值一致，本項(xiàng)用以防止接口被他人利用，如果需要進(jìn)行更多校驗(yàn)，請(qǐng)自行填加相關(guān)代碼。ashowurl=BBS文件顯示URL，默認(rèn)值“ /data/attachment/forum”，通過(guò)本參數(shù)可支持更改默認(rèn)附件目錄，取值應(yīng)與發(fā)布配置-文件顯示URL相同；tags標(biāo)簽，多個(gè)請(qǐng)以空格或英文逗號(hào)分隔；5、可選參數(shù)typeid=主題分類(lèi)（如論壇未設(shè)必選主題分類(lèi)，可以不用）sortid分類(lèi)信息分類(lèi)ID，若發(fā)布分類(lèi)信息，此參數(shù)必須設(shè)置；adddynamic=是否轉(zhuǎn)播給聽(tīng)眾，默認(rèn)留空，留空時(shí)只轉(zhuǎn)播主題，為1 時(shí)主題和回帖都轉(zhuǎn)播，為0時(shí)不轉(zhuǎn)播。tagauto=1是否啟用自動(dòng)獲取標(biāo)簽，1 為啟用

8、，當(dāng)啟用本項(xiàng)功能時(shí)，tags 將不生效。addfeed=1啟用發(fā)送動(dòng)態(tài)，1 為啟用zzhour=1擬真時(shí)間，發(fā)帖時(shí)間倒退小時(shí)數(shù)，默認(rèn)為1，回復(fù)時(shí)間將自動(dòng)間隔5-9 分鐘；maxclick=200最大隨機(jī)點(diǎn)擊數(shù)；parseurloff=禁用URL 識(shí)別， 0 或留空為允許，1 為禁止bbcodeoff=禁用Discuz 代碼， 0 或留空為允許，1 為禁止smileyoff=禁用表情， 0 或留空為允許，1 為禁止isanonymous=0使用匿名發(fā)帖，1 為啟用Usesig=1使用個(gè)人簽名，1 為啟用Readperm=文章所需閱讀權(quán)限price=文章售價(jià)ordertype=倒序看帖，1 為啟用

9、Hiddenreplies=回帖僅作者可見(jiàn)，1 為啟用htmlon=1取值啟用 HTML 代碼，默認(rèn) 1，1 為允許， 0 為禁止，當(dāng)版塊允許0 ，則帖子內(nèi)容仍無(wú)法正常顯示HTML 代碼；HTML 時(shí)，如果本參數(shù)save=是否草稿，1 為啟用，DISUCZ! X不允許回復(fù)草稿，所以當(dāng)啟用草稿狀態(tài)時(shí)，回復(fù)不能成功。6、定時(shí)發(fā)布參數(shù)cronpublish=0是否啟用定時(shí)發(fā)布（預(yù)發(fā)布，需要該賬號(hào)用戶組有此權(quán)限）， 0 或留空為禁止，1為使用；cronpublishhour=0推遲發(fā)布時(shí)間參數(shù)，為 0 表示不推遲，大于0 時(shí)，表示推遲幾個(gè)小時(shí)定時(shí)發(fā)布，如果當(dāng)前時(shí)間分鐘小于30，則在幾小時(shí)后整點(diǎn)定時(shí)發(fā)布

10、，如果當(dāng)前時(shí)間分鐘大于等于30，則在幾小時(shí) 30 分定時(shí)發(fā)布。當(dāng) cronpublishhour 大于 0 時(shí)， cronpublishdate 無(wú)效；當(dāng) cronpublishhour=0 時(shí)，使用 cronpublishdate 設(shè)置的定時(shí)時(shí)間。cronpublishdate定時(shí)發(fā)布時(shí)間參數(shù)，標(biāo)準(zhǔn)時(shí)間格式“年-月 -日 時(shí)：分”，其中分必須為 00 或 30；例如：2012-10-1 12:30。7、回帖獎(jiǎng)勵(lì)參數(shù)發(fā)布賬號(hào)必須有足夠的獎(jiǎng)勵(lì)。replycredit_extcredits=0每次回帖獎(jiǎng)勵(lì)多少，0 或留空為不獎(jiǎng)勵(lì)；replycredit_times=1獎(jiǎng)勵(lì)多少次，最小取值1 次；r

11、eplycredit_membertimes每人最多可獲得多少次，最小取值1 次；replycredit_random=100中獎(jiǎng)率百分比，取值范圍10 100， 10 的倍數(shù)。8、分類(lèi)信息本接口支持分類(lèi)信息發(fā)布，分類(lèi)信息參數(shù)名格式為typeoption字段1 變量名，對(duì)應(yīng)采集規(guī)則的分類(lèi)信息數(shù)據(jù)項(xiàng)，如圖：發(fā)布分類(lèi)信息時(shí)，具體有哪些參數(shù)，請(qǐng)查看網(wǎng)站分類(lèi)信息發(fā)帖網(wǎng)頁(yè)源碼的單內(nèi)容。發(fā)布分類(lèi)信息時(shí)，必須設(shè)置分類(lèi)信息分類(lèi)ID 參數(shù)sortid ；form表9、內(nèi)容格式當(dāng)該版塊允許 HTML 時(shí)，可發(fā)布 HTML 代碼格式文章，此時(shí) Htmlon 參數(shù)應(yīng)設(shè) 1 或不填；當(dāng)該版塊禁用 HTML 時(shí)，只能發(fā)布

12、 UBB 代碼格式文章，應(yīng)在發(fā)布規(guī)則中勾選“使用 UBB 代碼格式”和“保留換行符” ；由于 UBB 不能完整替代HTML，如果需要發(fā)布包含HTML 代碼的文章，應(yīng)在網(wǎng)站管理中心 -編輯版塊 -帖子選項(xiàng)中選擇“允許使用HTML 代碼”；要使用 UBB 發(fā)布如 FLASH、視頻等內(nèi)容時(shí)，請(qǐng)使用采集規(guī)則將FLASH、視頻等地址整理為 Discuz 代碼格式；注：使用這類(lèi)UBB 代碼，設(shè)置的發(fā)布用戶必須有相關(guān)權(quán)限，否則會(huì)被過(guò)濾；用戶可自行使用論壇支持的各種UBB 功能代碼，例如回復(fù)可見(jiàn)的代碼是“hide內(nèi)容/hide，”更多UBB 功能代碼請(qǐng)參考論壇發(fā)帖界面；10、附件如果要使用使用 ET 發(fā)布下載

13、的附件，請(qǐng)?jiān)谥贫ǚ桨钢?，選擇發(fā)布順序?yàn)椤跋壬蟼魑募保桓郊訁?shù)ashowurl （即 BBS文件顯示URL）的值應(yīng)與“發(fā)布規(guī)則-基本設(shè)置 -文件顯示 URL”相同；文件顯示URL的值，應(yīng)與用戶網(wǎng)站后臺(tái)-上傳設(shè)置 -基本設(shè)置 -附件URL 地址對(duì)應(yīng)，默認(rèn)值是“ http:/ 您的 dzx 網(wǎng)站 /data/attachment/forum”；當(dāng)網(wǎng)站更改了上傳設(shè)置- 附件URL 地址時(shí)，該值應(yīng)等于“附件“ /forum ”；URL地址”+注意：部分用戶的DZX 網(wǎng)站程序并不是網(wǎng)站主程序,而是放在網(wǎng)站下的子目錄，遇到這種情況時(shí)，應(yīng)正確設(shè)置ashowurl和 文件顯示URL，加上子目錄（例如/bbs/

14、data/attachment/forum）或使用完整網(wǎng)址格式（例如http:/網(wǎng)站域名/DZX 目錄 /data/attachment/forum）。本接口支持DZX遠(yuǎn)程附件功能，用戶只需在DZX后臺(tái) -上傳設(shè)置開(kāi)啟遠(yuǎn)程附件，ET發(fā)布配置和使用非遠(yuǎn)程附件時(shí)完全相同，不須另作任何設(shè)置；11、發(fā)布配置 -文章發(fā)布網(wǎng)址處，可以如下填寫(xiě)：http:/ 您的網(wǎng)址 /etpost_bbs.php注：使用大小寫(xiě)敏感的服務(wù)器的用戶請(qǐng)注意網(wǎng)址大小寫(xiě)和網(wǎng)站文件一致12、接口文件無(wú)須任何改動(dòng)即可使用，如果你希望增加校驗(yàn)或其他功能，請(qǐng)仔細(xì)修改；三、回復(fù)接口1、接口文件名etreply_bbs.php ，為保密，請(qǐng)自

15、行修改文件名；2、本接口文件請(qǐng)復(fù)制在網(wǎng)站根目錄下使用；3、本接口文件不能獨(dú)立使用，必須配合發(fā)布接口文件4、要使用本回復(fù)，請(qǐng)確認(rèn)對(duì)應(yīng)的采集規(guī)則-正文數(shù)據(jù)項(xiàng)etpost_bbs.php “匹配多條正文使用?！边x項(xiàng)有效；5、發(fā)布配置 -文章回復(fù)網(wǎng)址處，可以如下填寫(xiě)：http:/ 您的網(wǎng)址 /etreply_bbs.php注：使用大小寫(xiě)敏感的服務(wù)器的用戶請(qǐng)注意網(wǎng)址大小寫(xiě)和網(wǎng)站文件一致6、接口文件無(wú)須任何改動(dòng)即可使用，如果你希望增加校驗(yàn)或其他功能，請(qǐng)仔細(xì)修改；五、常見(jiàn)錯(cuò)誤：當(dāng)提示采集失敗時(shí)，請(qǐng)查看返回信息了解錯(cuò)誤詳情，以便改正，返回信息窗見(jiàn)下圖：一、 err 賬號(hào)密碼錯(cuò)誤/err1、檢查發(fā)布規(guī)則-參數(shù)取

16、值 -賬號(hào)密碼隊(duì)列；二、 errinvalid vercode/err1、在發(fā)布規(guī)則 -檢查網(wǎng)址中填寫(xiě)的vercode 值和檢查接口文件中的vercode 值不一致；2、在發(fā)布規(guī)則 -參數(shù)取值 -附件參數(shù)隊(duì)列中填寫(xiě)的 vercode 值和發(fā)布接口文件中的 vercode 值不一致；三、 err subjectis null/err ：1、使用的采集規(guī)則未能正確采集到標(biāo)題；2、采集規(guī)則的數(shù)據(jù)整理將標(biāo)題過(guò)濾了；3、錯(cuò)誤的修改了發(fā)布規(guī)則-發(fā)布項(xiàng)中的標(biāo)題參數(shù)名，正確的參數(shù)名請(qǐng)看本文接口說(shuō)明部分；4、發(fā)布規(guī)則未開(kāi)啟utf-8 編碼轉(zhuǎn)換；四、 err 內(nèi)容不能為空/err ：1、使用的采集規(guī)則未能正確采集到正文數(shù)據(jù)項(xiàng)；2、采集規(guī)則的數(shù)據(jù)整理將正文數(shù)據(jù)過(guò)濾了