- 1 Introduction
- 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 macOS
- 2.7 XAMPP-VM Installation for macOS
- 2.8 XAMPP Installation for macOS
- 2.9 Source Code Installation (for all systems)
- 2.10 Set up Virtualbox for ZenTao
- 2.11 Softaculous Service
- 2.12 Integrate Zdoo
- 2.13 Install Ioncube
- 3 Update
- 3.1 Update ZenTao
- 3.2 Update by 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
- 5 Quick Start
- 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 Operation Mode
- 6.16 Points
- 6.17 Required Field
- 6.18 How to check privilege settings in ZenTao
- 6.19 Annual Work Summary
- 7 Advanced Application
- 7.1 Workflow
- 7.1.1 ZenTao Workflow
- 7.2 Individual management
- 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 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 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 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 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 Request
- 7.5.6 Resolve a Bug
- 7.5.7 Documents
- 7.5.8 Confirm Bugs
- 7.6 For QA Team
- 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
- 9 Customization
- 9.1 ZenTao Customization
- 9.2 ZenTao Directory
- 9.3 Find and Edit 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 Extension Editor
- 9.11 Feature Limitation
- 9.12 ZenTao Packaging Standards 1.1
- 10 Misc
With ZenTao 9.6+, you can integrate third-party applications in ZenTao, so to share your data. The third-party application can access ZenTao in the way of GET, and ZenTao will return the data in .json format.
Log in ZenTao as the super-Admin, and go to Admin->Develop->Entry and Click Add Application.
Then enter the information of the application that you want to add to ZenTao.
- Name: The name of the application
- Code: The alias of the application
- Key: Key is generated automatically in ZenTao
- IP: This is a whitelist of IP. Check All means there is no limit to any IP.
2. API Authentication
API authentication is required when the third-party applications request data from ZenTao. The format is /api.php? m=moduleName&f=methodName& params=params &code=code&token=token
- m=moduleName&f=methodName& params=params is the parameters that the data request, and you should set it according to your own situation.
- code is the alias of the application and should be the same as that is in ZenTao.
- token is the digital authentication, and its algorithm is to remove the md5 and add the key, then md5 again.
For example, the code of the application is myApp and the key is 427c579384224abf9570779d82969d1e, so the algorithm of the token is as shown below,
$key = '427c579384224abf9570779d82969d1e'; $query = 'm=project&f=view&id=1&code=myApp'; $token = md5(md5($query) . $key);
3. Error Code
300001 No code parameter. Check whether the requested API contains the code.
300002 No token parameter. Check whether the requested API contains the token.
310001 Application does not exist. Check whether the requested application exists in ZenTao or deleted.
310002 Application has no key set up. Check whether the requested application has a key set up.
320001 IP is restricted. Check the IP setting of this requested application in ZenTao.
330001 Invalid token parameters.
If a redirection happens when requesting, ZenTao should check the session to authenticate whether the request after the redirection is valid. For example, when requesting the index method in the index module, it will redirect to the index method in the my module.
340001 No session code. Check whether $_SESSION['ENTRY_CODE'] is correct after the redirection.
340002 Session authentication failed. Check the authentication logic of the session, as well as whether $_SERVER['REMOTE_ADDR'] is correct after the redirection.