禪道開(kāi)源版11.0版本開(kāi)始，增加了客戶(hù)端集成功能。

客戶(hù)端由 喧喧提供支持。喧喧是易軟天創(chuàng)旗下另外一款免費(fèi)、開(kāi)源、安全的IM產(chǎn)品，支持私有部署，跨平臺(tái)操作，內(nèi)置大量插件，功能豐富。

禪道集成客戶(hù)端配置成功后，客戶(hù)端與禪道深度集成，支持成員溝通，小組討論，文件傳輸，任務(wù)指派，更加方便的項(xiàng)目管理，更加流暢的團(tuán)隊(duì)協(xié)作。

下面給大家介紹具體的禪道客戶(hù)端配置步驟。

一、禪道后臺(tái)客戶(hù)端集成配置

注：如果使用windows一鍵安裝包安裝的禪道，需要打開(kāi)xampp/start.exe程序，將集成面板左下角的apache驗(yàn)證取消勾選。

1、查看禪道客戶(hù)端服務(wù)器設(shè)置

超級(jí)管理員首次登錄禪道時(shí)，頁(yè)面會(huì)提示新增禪道客戶(hù)端功能。

提醒超級(jí)管理員去后臺(tái)--集成--客戶(hù)端集成里配置客戶(hù)端。

后臺(tái)--集成--客戶(hù)端集成里配置客戶(hù)端的服務(wù)器設(shè)置。

備注：禪道服務(wù)器地址為完整的協(xié)議+地址+端口，示例：http://192.168.1.35 或 http://pms.zentao.com ，不能使用127.0.0.1。

2、修改 禪道客戶(hù)端服務(wù)器設(shè)置

你可以點(diǎn)擊服務(wù)器設(shè)置頁(yè)面下方的 修改配置 來(lái)做調(diào)整。

修改配置頁(yè)面：

說(shuō)明：

1、禪道的客戶(hù)端集成默認(rèn)是開(kāi)啟的狀態(tài)。

2、密鑰是隨機(jī)生成的32位密碼，這個(gè)密鑰要與禪道客戶(hù)端的服務(wù)器里的配置一致。

3、上傳文件大小默認(rèn)是20M，可以根據(jù)實(shí)際使用需要調(diào)整。

4、是否啟用https，默認(rèn)是不啟用。啟用后，需要把https證書(shū)的內(nèi)容和密鑰復(fù)制粘貼到輸入框了。

二、禪道客戶(hù)端的服務(wù)器下載和運(yùn)行

1、下載禪道客戶(hù)端的服務(wù)器端

禪道客戶(hù)端的服務(wù)器由易軟天創(chuàng)旗下的另一款產(chǎn)品：喧喧提供驅(qū)動(dòng)。點(diǎn)擊后臺(tái)--集成--客戶(hù)端集成--服務(wù)器設(shè)置頁(yè)面下方的 下載喧喧服務(wù)端。

下載之前需要注意：

必須先點(diǎn)擊 修改配置 并保存。

選擇對(duì)應(yīng)的操作系統(tǒng)，目前支持windows32位，windows64位，linux32位，linux64位，macOS系統(tǒng)。

如果你之前已下載過(guò)喧喧服務(wù)端，那么可以?xún)H下載配置文件。配置文件為xxd.conf，下載成功后替換掉原喧喧服務(wù)器端里的同名文件即可。替換后需要重啟服務(wù)器端服務(wù)。

以下載windows64位服務(wù)端為例：

下載解壓后會(huì)得到一個(gè)win_x86_64.zentao_chat_server的文件夾。

之前在禪道后臺(tái)--集成--客戶(hù)端集成--服務(wù)器設(shè)置里做的配置，都保存config文件夾里的 xxd.conf里。

2、運(yùn)行禪道客戶(hù)端的服務(wù)器端服務(wù)

雙擊目錄中的 xxd.exe ，即可啟用服務(wù)器端的服務(wù)。

如果使用的是linux的服務(wù)器端，解壓后，直接運(yùn)行 ./xxd 就可以了。

三、禪道客戶(hù)端的安裝和使用

禪道客戶(hù)端的服務(wù)器端配置成功后，禪道頁(yè)面會(huì)提示用戶(hù)去下載禪道客戶(hù)端。

點(diǎn)擊禪道界面右下角的 下載客戶(hù)端 即可進(jìn)入下載頁(yè)面。

說(shuō)明：

只有超級(jí)管理員在后臺(tái)配置了客戶(hù)端服務(wù)器端信息，禪道界面的右下角才會(huì)顯示 下載客戶(hù)端 入口。

內(nèi)網(wǎng)環(huán)境需要手動(dòng)將禪道客戶(hù)端的安裝包放到服務(wù)器指定目錄下，這樣其他用戶(hù)才可以通過(guò)禪道右下角 下載客戶(hù)端 入口下載禪道客戶(hù)端。（具體請(qǐng)參考： http://www.zentao.net/book/zentaopmshelp/302.html#3）

下載頁(yè)面：

下面以禪道客戶(hù)端windows 64位的為例，給大家具體演示一下。

你可以根據(jù)自己使用的操作系統(tǒng)，選擇下載對(duì)應(yīng)的客戶(hù)端。

選擇適合你的操作系統(tǒng)，保存后進(jìn)入下載頁(yè)面：

請(qǐng)耐心等待一下。

禪道客戶(hù)端下載成功后，解壓得到zentao_chat_client.win64文件夾，到zentaoclient目錄里，拖到底部，雙擊 zentaoclient.exe即可啟動(dòng)禪道客戶(hù)端。

禪道客戶(hù)端登錄頁(yè)面：

服務(wù)器填寫(xiě)的是客戶(hù)端服務(wù)器端設(shè)置文件（xxd.conf）里的服務(wù)器地址。

注：如果沒(méi)有單獨(dú)修改xxd配置文件中的默認(rèn)端口號(hào)，服務(wù)器地址后面不需要加端口。

例如：禪道在網(wǎng)頁(yè)端訪(fǎng)問(wèn)地址為http://192.168.1.110:8080，在客戶(hù)端的服務(wù)器填寫(xiě)http://192.168.1.110就可以了。

賬號(hào)和密碼，填寫(xiě)的是禪道里的用戶(hù)名和密碼。

禪道客戶(hù)端登錄成功頁(yè)面，那么現(xiàn)在你可以跟你的小伙伴開(kāi)始聊天討論了。

可以點(diǎn)擊客戶(hù)端左側(cè)導(dǎo)航的禪道圖標(biāo)，直接在客戶(hù)端里查看瀏覽禪道里的內(nèi)容信息。

特別說(shuō)明：內(nèi)網(wǎng)環(huán)境如何下載禪道客戶(hù)端

如果是內(nèi)網(wǎng)環(huán)境可以先從官網(wǎng)手動(dòng)下載禪道客戶(hù)端，然后放到指定的服務(wù)器目錄下，其他用戶(hù)再下載的時(shí)候就可以直接下載客戶(hù)端了.

這里以禪道11.0為例進(jìn)行說(shuō)明，對(duì)應(yīng)的禪道客戶(hù)端為2.2.0。

1、先到禪道開(kāi)源版11.0下載頁(yè)面，找到禪道客戶(hù)端下載，下載對(duì)應(yīng)操作系統(tǒng)的安裝包：                                           

2、創(chuàng)建對(duì)應(yīng)目錄

找到禪道所在目錄，看目錄下是否存在 “tmp/cache/client” 目錄，

如果不存在則創(chuàng)建此目錄。明確客戶(hù)端的版本，在client目錄下創(chuàng)建一個(gè)以客戶(hù)端版本號(hào)為名的目錄，這里的客戶(hù)端版本號(hào)為2.2.0，則在client下創(chuàng)建2.2.0目錄。

3、將安裝包放到禪道服務(wù)器指定目錄下

將下載的客戶(hù)端安裝包放到剛才創(chuàng)建的2.2.0目錄下，linux服務(wù)器需要注意文件權(quán)限和屬組的設(shè)置，最終的目錄結(jié)構(gòu)如下：

4、這樣用戶(hù)就可以直接通過(guò)禪道系統(tǒng)里右下角的“下載客戶(hù)端“按鈕來(lái)下載客戶(hù)端了。

四、禪道客戶(hù)端的具體操作使用

1、禪道和客戶(hù)端的信息共享

禪道和客戶(hù)端集成后：

賬戶(hù)和密碼共用；

禪道頁(yè)面可以直接在客戶(hù)端打開(kāi)，瀏覽；

禪道里的操作可以通過(guò)客戶(hù)端發(fā)送消息提醒；

客戶(hù)端消息可以直接右鍵創(chuàng)建Bug、需求、任務(wù)、文檔、待辦；

客戶(hù)端卡片形式顯示禪道里Bug、需求、任務(wù)、文檔、用例的詳情頁(yè)，并且還提供具體的操作按鈕。

2、客戶(hù)端的具體操作使用

禪道客戶(hù)端的基礎(chǔ)使用，可以直接參考喧喧官網(wǎng)的客戶(hù)端使用說(shuō)明： https://xuan.im/page/client.html

在此不再贅述，下面給大家介紹禪道客戶(hù)端的獨(dú)有功能的操作使用。

2.1 客戶(hù)端使用禪道賬號(hào)和密碼登錄

禪道客戶(hù)端和禪道的賬號(hào)和密碼是通用的。使用禪道的用戶(hù)名和密碼即可登錄禪道客戶(hù)端。

2.1.1 禪道管理員配置好客戶(hù)端的服務(wù)器，在禪道--組織--用戶(hù)里添加好用戶(hù)。

2.1.2 其他用戶(hù)只要下載客戶(hù)端，使用禪道賬號(hào)和密碼，就可以登錄到禪道客戶(hù)端了。

2.2 客戶(hù)端打開(kāi)禪道頁(yè)面

客戶(hù)端左側(cè)導(dǎo)航添加了 禪道的入口，點(diǎn)擊即可進(jìn)入禪道頁(yè)面，進(jìn)行瀏覽操作。

2.3 客戶(hù)端消息提醒禪道里的操作

首先需要管理員到禪道后臺(tái)--通知--設(shè)置--客戶(hù)端里設(shè)置。

勾選需要發(fā)送提醒的操作即可，這樣在禪道里做這樣的操作，指派人就可以在客戶(hù)端收到提醒。

以任務(wù)的指派為例，指派人的禪道客戶(hù)端的通知中心里，會(huì)收到任務(wù)的指派信息。

可以直接查看任務(wù)的詳情。

當(dāng)客戶(hù)端最小化在右下角時(shí)，有聲音通知和信息提示。

2.4 客戶(hù)端消息右鍵創(chuàng)建禪道Bug、需求、任務(wù)、文檔、待辦

禪道客戶(hù)端消息右鍵，目前支持直接創(chuàng)建禪道Bug、需求、任務(wù)、文檔、待辦。

禪道里分配了這些權(quán)限，在禪道客戶(hù)端里消息右鍵才可以進(jìn)行創(chuàng)建。如果沒(méi)有分配這些權(quán)限，那么客戶(hù)端消息右鍵時(shí)，不會(huì)顯示創(chuàng)建按鈕。

下面我們以客戶(hù)端消息右鍵創(chuàng)建Bug來(lái)給大家演示具體操作：

禪道客戶(hù)端消息右鍵，點(diǎn)擊創(chuàng)建Bug，即可跳轉(zhuǎn)到Bug創(chuàng)建頁(yè)面。

禪道客戶(hù)端的Bug創(chuàng)建頁(yè)面：

客戶(hù)端的消息會(huì)直接同步過(guò)來(lái)，顯示在Bug標(biāo)題框里。

其他的信息可以在這個(gè)頁(yè)面里補(bǔ)充一下，然后保存。

創(chuàng)建成功的Bug，客戶(hù)端會(huì)直接跳轉(zhuǎn)到Bug的詳情頁(yè)。

禪道界面也已同步記錄創(chuàng)建成功的Bug：

客戶(hù)端確認(rèn)Bug：

客戶(hù)端里指派Bug：

客戶(hù)端里解決Bug：

客戶(hù)端編輯Bug：

禪道客戶(hù)端消息右鍵創(chuàng)建需求、任務(wù)、文檔、待辦，歡迎大家自行操作，體驗(yàn)客戶(hù)端和禪道集成的便捷。

說(shuō)明： 如果客戶(hù)端信息只有鏈接地址，右鍵只可以創(chuàng)建類(lèi)型是鏈接的文檔。

創(chuàng)建類(lèi)型為鏈接的文檔：

創(chuàng)建成功后：

2.5 客戶(hù)端里卡片顯示需求、任務(wù)、Bug、用例、文檔的詳情頁(yè)

在客戶(hù)端聊天對(duì)話(huà)框，發(fā)送禪道中的需求、任務(wù)、Bug、用例、文檔詳情頁(yè)面地址，發(fā)送成功后，將以卡片形式顯示。

以下以發(fā)送任務(wù)的詳情頁(yè)地址為例：

發(fā)送成功后，鏈接自動(dòng)變?yōu)榭ㄆ问斤@示：       

2.6 客戶(hù)端的小組討論

點(diǎn)擊討論組右上角的添加 圖標(biāo)，即可選擇成員添加討論組。

比較方便禪道中項(xiàng)目團(tuán)隊(duì)成員之間的溝通和協(xié)作。

五、注意事項(xiàng)

5.1 windows一鍵安裝包，請(qǐng)關(guān)閉Apache用戶(hù)訪(fǎng)問(wèn)驗(yàn)證

如果你使用的是禪道windows一鍵安裝包，那么禪道運(yùn)行控制面板里是否啟用Apache用戶(hù)訪(fǎng)問(wèn)驗(yàn)證，這一項(xiàng)必須關(guān)閉掉，否則喧喧客戶(hù)端登錄不上。

禪道windows一鍵安裝包，Apache用戶(hù)訪(fǎng)問(wèn)驗(yàn)證默認(rèn)是開(kāi)啟的，記得一定要手動(dòng)關(guān)閉，不勾選即可。

注意：11.0之前的一鍵安裝包升級(jí)過(guò)來(lái)的，需要確認(rèn)下xampp/runner/res/apache/conf/httpd.con配置文件中，有沒(méi)有x.php的配置文件。

如果沒(méi)有，需要添加一下，然后重啟下xampp服務(wù)。添加內(nèi)容：

  <Files "x.php">
    SetHandler application/x-httpd-php
  </Files>
  <Files "upgradexuanxuan.php">
    SetHandler application/x-httpd-php
  </Files>

5.2 客戶(hù)端登錄失敗排查

如果配置好禪道客戶(hù)端后，使用禪道用戶(hù)名和密碼登錄客戶(hù)端失敗。

5.2.1 請(qǐng)先逐一排查禪道、禪道客戶(hù)端、禪道客戶(hù)端服務(wù)器端（xxd）是否都正常運(yùn)行。

5.2.2 禪道、禪道客戶(hù)端、禪道客戶(hù)端服務(wù)器端（xxd）都運(yùn)行正常的話(huà)，需要檢查禪道客戶(hù)端服務(wù)器端的xxd.conf的配置。 服務(wù)器名是否寫(xiě)對(duì)，密鑰是否一致，是否加上了default。

5.2.3 禪道客戶(hù)端登錄頁(yè)面提示：服務(wù)器操作失敗，提示500錯(cuò)誤。請(qǐng)先到后臺(tái)--集成--客戶(hù)端集成--服務(wù)器設(shè)置里查看服務(wù)器配置里是否是打開(kāi)狀態(tài)。