1. Introduction
1.1 About ZenTao
1.2 Introduction PDF
1.3 Technical Support
1.4 Follow Us
2. Installation
2.1 Choose the Right Installation
2.2 ZenTao Cloud
2.3 One-click Installation for Windows
2.4 One-click Installation for Linux
2.5 Lampp Installation in Linux
2.6 Source Code Installation (for all systems)
2.7 Source Code Installation for macOS
2.8 XAMPP-VM Installation for macOS
2.9 XAMPP Installation for macOS
2.10 Install ZenTao in Docker
2.11 Install httpd, Mariadb, PHP 7.2 in Cent OS 8
2.12 Softaculous Service
2.13 Install Ioncube
3. Update
3.1 Update ZenTao
3.2 Update Via Source Code (For All Systems)
3.3 Update for One-Click Installation for Windows (xampp)
3.4 Update for One-Click Installation for Linux
4. Users and Groups
4.1 Company Structure
4.2 Add a User
4.3 Manage Users in batches
4.4 Groups and Privileges
5. Quick Start
5.1 Project and Task Management
5.2 Bug Tracking
5.3 Product Management
5.4 Todo Management
6. Basic Application
6.1 Basic Workflow
6.2 Agile and Scrum
6.3 ZenTao and Scrum
6.4 ZenTao Tutorial for Rookies
6.5 Create a Product
6.6 Create a Story
6.7 Create a Project
6.8 Confirm a Story
6.9 Decompose Stories into Tasks
6.10 Report a Bug
6.11 Manage Contacts
6.12 Customization
6.13 Import Excel, CSV Files
6.14 Document Management
6.15 Work Mode
6.16 Points
6.17 Required Field
6.18 Privileges
6.19 Annual Work Summary
7. Advanced Application
7.1. Workflow
7.1.1 ZenTao Workflow
7.2. Individual management
7.2.1 My Todo
7.2.2 My Task, Story and Bug
7.2.3 My Profile
7.3. Product Owner
7.3.1 Manage a Product
7.3.2 Manage a Product Line
7.3.3 Create and Review a Story
7.3.4 Change and Review a Story
7.3.5 Status and Phase
7.3.6 Story Writing
7.3.7 Product Module
7.3.8 Release Plan
7.3.9 Create a Release
7.3.10 Roadmap
7.3.11 Documents
7.3.12 Planning Meetings
7.3.13 Daily Scrum, Review and Retrospective Meetings
7.3.14 Story Reports
7.4. Scrum Master
7.4.1 Create a Sprint
7.4.2 Set a Team
7.4.3 Confirm a Story
7.4.4 Task Breakdown
7.4.5 Daily Standup Meetings
7.4.6 Check Project Progress via Burndown Chart
7.4.7 Check Project Progress via Lists
7.4.8 Review and Retrospective Meetings
7.4.9 Basic reports on tasks
7.5. Development Team
7.5.1 Project planning meeting and task breakdown
7.5.2 Claim tasks and update efforts
7.5.3 Kanban and Tree Diagram
7.5.4 Build
7.5.5 Test Request
7.5.6 Resolve a Bug
7.5.7 Documents
7.5.8 Confirm Bugs
7.6. Test Team
7.6.1 Bug Tracking
7.6.2 Report a Bug
7.6.3 Verify and Close a Bug
7.6.4 Activate a Bug
7.6.5 Find a Bug
7.6.6 Test Case
7.6.7 Create and Review Test Cases
7.6.8 Test Suites, Public Case Libs and Reports
7.6.9 Manage Test Requests
7.6.10 Run Cases and Report Bugs
7.6.11 Reports
8. Configuration
8.1. Maintain ZenTao
8.1.1 Initialize scripts
8.1.2 Data Backup
8.1.3 Recover the Deleted
8.1.4 Update Burndown Charts
8.1.5 ZenTao Remote Host
8.2. Deploy ZenTao
8.2.1 Guest Login
8.2.2 Email Notification
8.2.3 Set Super Admin
8.2.4 Static Access
8.2.5 Remove "zentao" from URL
8.2.6 Integrate SVN
8.2.7 Integrate Git
8.2.8 Integrate Webhook
8.2.9 Integrate Xuan.im
8.2.10 Integrate Zdoo
8.2.11 Integrate Third-Party Apps
8.2.12 Password-Free Login
8.2.13 Translation Add-on
8.2.14 Integrate Jenkins
8.2.15 Extension
8.2.16 Fix Weak Password
9. Customization
9.1 Introduction
9.2 Directory
9.3 Find Codes
9.4 Database Structure
9.5 Common Modules
9.6 Add Features to Menu
9.7 Set Privileges to Modules
9.8 Examples: modify language prompt
9.9 Examples: set priority when creating bugs
9.10 Extension Editor
9.11 Feature Limitation
9.12 ZenTao Packaging Standards 1.1
10. Misc
10.1 About Third-Party Code
10.2 Support ZenTao
10.3 ZenTao Service
10.4 Acknowledgement

Integrate Xuan.im

2018-08-13 10:45:00
Renee
8934
Last edited by Taotao on 2020-12-24 11:27:51
Share links

ZenTao 10.2+ has integrated Xuan. Once you integrate ZenTao and Xuan, ZenTao will work as the server for Xuan, and ZenTao users can log in Xuan with ZenTao username and password. The integration is optimizing, and other information in ZenTao will be shared in Xuan.


Xuan is an instant messenger for enterprises and it is open source, free, secure, and cross-platform. Visit http://xuan.im for more.


Next, let's see how to integrate Xuan with ZenTao.

1. Download and install ZenTao, Xuan, and Xuan xxd server.

2. Integrate Xuan

Take ZenTao for Windows as an example and let's see how to integrate Xuan.


2.1 Install ZenTao and make sure it works.

Note:

  • If you install ZenTao via one-click installation package, you have to turn of the Apache Authentication in ZenTao Control Panel. Or you cannot log in Xuan client.
  • Apache Authentication is ON by default. Uncheck the Apache Authentication box will do.


Go to Admin->Xuan in ZenTao and check the settings of Xuan. The key by default is  32 bits of 8. It is recommended that you Re-Create a key for security reasons.


2.2 Go to xxd and change configure files.

Unzip the xxd file for Windows, and you will have config and xxd.exe. Go to config->xxd.conf and change it.


Refer to the comments and change it accordingly.


Note:

  • ZenTao is the only and default server for Xuan. So add "default" when configuring the server.
  • The key in the config file should be the one genereate in Admin->Xuan.
  • Server name is the address that you visit ZenTao.

For example, the address to visit ZenTao is http://127.0.0.1/zentao, then localhost=http://127.0.0.1/xxb/xuanxuan.php,88888888888888888888888888888888. The actual configuration is xuanxuan=http:127.0.0.1/zentao/xuanxuan.php,myanris5vpthvvghuo33mtqepxqs3eq7,default


Save the configuration, and start IM server.

3. Login Xuan desktop

Use ZenTao username and password to log in Xuan. The server IP on Xuan login page is the Listen IP.

Note:

  • If ZenTao and xxd are on the same server, it is OK to enter the IP to visit ZenTao in server address.
  • If ZenTao and xxd are not on the same server, the server IP has to be the Listen IP.
  • If the Listen IP is the intranet IP and Xuan has to connect to the internet IP,  use the internet IP as the server IP.


After login Xuan, you can use Xuan to communicate with other users.


After integrating Xuan with ZenTao, username and password are shared. ZenTao works as the server for Xuan.

4. Note

4.1 Add  the parse of xuanxuan.php and upgradexuanxuan.php

If your ZenTao is upgraded to ZenTao 10.2, you should add the parse to xuanxuan.php and upgradexuanxuan.php.


For Windows one-click installation package, go to xampp/runner/res/apache/conf/httpd.conf and add the code below to setting for zentaopms(or ZenTao open source), setting for zentaopro(for ZenTao Pro), or setting for zentaobiz(for ZenTao Enterprise).


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


After adding the code, save the file. Restart ZenTao and it should work.


For Linux one-click installation package, go to /opt/zbox/etc/apache /httpd.conf and the code below to setting for zentaopms(or ZenTao open source), setting for zentaopro(for ZenTao Pro), or setting for zentaobiz(for ZenTao Enterprise).


<Files "xuanxuan.php">
    SetHandler application/x-httpd-php
  </Files>
  <Files "upgradexuanxuan.php">
    SetHandler application/x-httpd-php
  </Files>
After adding the code, save the file. Restart ZenTao and it should work.



4.2 Turn off the Apache Authentication in Windows one-click installation package.


  • If you install ZenTao via one-click installation package, you have to turn off the Apache Authentication in ZenTao Control Panel. Or you cannot log in Xuan client.
  • Apache Authentication is ON by default. Uncheck the Apache Authentication box will do.


4.3 Fail to use ZenTao username and password to log in Xuan

If you cannot log in Xuan with ZenTao username and password after integration,


  • check whether ZenTao, Xuan, and Xuan xxd are working.
  • If so, check the configuration in xxd.conf.

Check the server name, the key, and "default".


4.4 Misc

You can leave a message, write a post, and email us, if you have any questions.

Forum: https://www.zentao.pm/forum/feedback.html

Email: [email protected]


Write a Comment
Comment will be posted after it is reviewed.