Catalog

Sanplex 10.2+ has integrated Xuan. Once you integrate Sanplex and Xuan, Sanplex will work as the server for Xuan, and Sanplex users can log in Xuan with Sanplex username and password. The integration is optimizing, and other information in Sanplex 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 Sanplex.

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

Sanplex open source download https://www.sanplex.com/download.html
Xuan 2.0.0 client download http://xuan.im/page/1.html
Xuan 2.0.0 xxd server download http://xuan.im/page/2.html

2. Integrate Xuan

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

2.1 Install Sanplex and make sure it works.

Note:

If you install Sanplex via one-click installation package, you have to turn of the Apache Authentication in Sanplex 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 Sanplex 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:

Sanplex 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 Sanplex.

For example, the address to visit Sanplex 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 Sanplex username and password to log in Xuan. The server IP on Xuan login page is the Listen IP.

Note:

If Sanplex and xxd are on the same server, it is OK to enter the IP to visit Sanplex in server address.
If Sanplex 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 Sanplex, username and password are shared. Sanplex works as the server for Xuan.

4. Note

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

If your Sanplex is upgraded to Sanplex 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 Sanplex open source), setting for zentaopro(for Sanplex Pro), or setting for zentaobiz(for Sanplex 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 Sanplex 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 Sanplex open source), setting for zentaopro(for Sanplex Pro), or setting for zentaobiz(for Sanplex 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 Sanplex and it should work.

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

If you install Sanplex via one-click installation package, you have to turn off the Apache Authentication in Sanplex 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 Sanplex username and password to log in Xuan

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