ZenTao ManualBook Info
1 Introduction
1.1 About ZenTao
1.2 Introduction PPT
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 Installation with Lampp
2.6 Source Code Installation (for all Systems)
2.7 Set up Virtualbox for ZenTao
2.8 Softaculous service
2.9 Integrate Zdoo
2.10 Install Ioncube
3 Upgrade
3.1 Upgrade ZenTao
3.2 Upgrade by source code (for all systems)
3.3 Upgrade for one-click installation for Windows (xampp)
3.4 Upgrade for one-click installation package for Linux
4 Users and Groups
4.1 Company Structure
4.2 Add a User
4.3 Batch Manage Users
4.4 Groups and Privileges
5 Quick Start
5.1 Project and Task Management
5.2 Bug Tracking
5.3 Product Management
5.4 Individual Task 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 Task Breakdown
6.10 Report a Bug
6.11 Manage Contacts
6.12 Customization
6.13 Import Excel, CSV files
6.14 Document Management
6.15 Operation Mode
6.16 Points
6.17 Customize Required Field
6.18 Access Control
7 Advanced Application
7.1 Workflow
7.1.1 ZenTao Workflow
7.2 Personal management
7.2.1 My Todo
7.2.2 My Task, Story and Bug
7.2.3 My Profile
7.3 For 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 Story Status
7.3.6 Notes for Writing a Story
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 For Project Manager
7.4.1 Create a Project
7.4.2 Set up a Team
7.4.3 Confirm a Story
7.4.4 Story 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 For 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 Task
7.5.6 Resolve a Bug
7.5.7 Documents
7.5.8 Confirm Bugs
7.6 For QA Team
7.6.1 Defect Management
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 Tasks
7.6.10 Execute Cases and Report Bugs
7.6.11 Reports
8 Configuration
8.1 Maintain ZenTao
8.1.1 Initialize scripts
8.1.2 Back up ZenTao
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 Delete "zentao" from URL
8.2.6 Integrate ZenTao with SVN
8.2.7 Integrate ZenTao with Git
8.2.8 Integrate webhook
8.2.9 Integrate Xuan.im
8.2.10 Integrate Zdoo
9 Customization
9.1 ZenTao customization
9.2 ZenTao Directory
9.3 Locate and Change Files
9.4 ZenTao 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 Web Editor
9.11 ZenTao Packaging Standards 1.1
10 Relevant Issues
10.1 About third-party code
10.2 Support ZenTao
10.3 ZenTao Commercial Service
10.4 Acknowledgement

Integrate Xuan.im

2018-08-13 10:45:00
Renee
276
Last edited by Renee on 2018-11-16 14:02:43

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.

SCREENSHOT


Refer to the comments and change it accordingly.

SCREENSHOT


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

SCREENSHOT


Save the configuration, and start xxd.exe.

SCREENSHOT


3. Login Xuan client

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.

SCREENSHOT


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

SCREENSHOT


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 renee@easysoft.ltd; liujun@cnezsoft.com


    Write a Comment
    Comment will be posted once reviewed.