喧喧客户端是由然之协同团队推出的一款轻量级的开源企业聊天软件，属于开源软件，喧喧是一个已经实现基础功能的，跨平台的，轻量级的，非常容易进行二次开发的开源聊天解决方案，需要部署服务器才可以使用，服务器内置在然之协同里，连接到服务器后，您就可以和其他连接到服务器的同事进行沟通。

1、开聊
和服务器上的任何用户开聊，收发表情、图片、截屏、文件样样在行；

2、讨论组
一个人讨论的不过瘾？随时邀请多人组建个性讨论组；

3、公开频道
将讨论组公开，任何感兴趣的人都可以加入进来；

4、通知及提醒
与系统桌面环境集成，即时收到新消息通知；

5、会话管理
将任意会话（包括讨论组和频道）置顶，精彩内容不容错过，还可以重命名讨论组、为讨论组设置白名单及浏览会话的所有消息历史记录；

6、通讯录
浏览企业成员信息；

7、轻量级服务器端
轻松搭配然之协同使用。

这里有一个公开的测试服务器供使用：

地址：http://demo.ranzhi.org

用户：demo

密码：demo

或用户：demo1, demo2, ... demo10

密码：123456

注意：测试服务器不能使用传送文件功能。

然之协同服务器端部署基本步骤：

1、下载安装然之协同；

2、下载喧喧然之协同服务器端 xuanxuan-1.0.2-server-rangerteam.zip 并解压缩至server目录；

3、合并server目录到然之协同服务目录；

4、导入server/db/xuanxuan.sql到然之协同的数据库；

5、修改php.ini，确保 php 在 webserver 模式和 cli 模式下的session.save_path指向同一目录；

6、Linux 或 Mac 系统在然之服务目录执行./bin/xuanxuan start [-u username]，其中username为然之协同 Apache 服务运行用户，默认为 www-data；Windows 系统在然之服务目录执行x:\xxx\php.exe ./app/xuanxuan/server.php，其中x:\xxx\php.exe为php安装路径。

7、服务器的登录地址为然之协同的站点地址，登录帐号和密码为然之协同内对应用户的帐号和密码。

8、服务器端和客户端基于 php socket 方案并采用 8080 端口进行通讯，如遇不能登录请检查 php socket 扩展是否加载，8080 端口是否开放。端口配置可在 config/ext/xuanxuan.php 中修改。

9、可使用 bin/xuanxuan 控制服务器端的启动、停止、重启、状态查询， bin/xuanxuan -h 获取使用帮助。将 bin/daemon.php 加入计划任务即可实现对服务器端的监控和自动重启。

主界面

喧喧聊天软件主界面主要由垂直功能导航和功能区域组成。在垂直功能导航上目前可以使用的功能包括：

查看当前登录用户，右键点击用户头像使用用户菜单；

切换【最近聊天】、【联系人】和【讨论组】功能；

系统设置。

聊天会话

喧喧即时通讯软件的聊天会话界面由会话菜单和聊天窗口组成。

会话菜单

会话菜单主要包括会话列表和创建新会话功能。

会话列表

会话列表包含当前用户所有参与会话。你可以通过导航上的 “最近会话”、“联系人”和“讨论组”切换不同的会话列表。

在会话列表中点击会话名称即可打开会话聊天窗口。

创建新会话

点击会话菜单标签页上的创建会话按钮，打开创建会话对话框。

勾选需要参与会话的联系人，点击创建按钮即可。如果所选择的联系人数目少于 2 个，则直接创建为一对一的会话，如果所选择的联系人数目多余 2 个，则创建为多人讨论组。

会话聊天

在喧喧聊天软件会话聊天窗口中，你可以向当前会话发送 Emoji 表情、文本、图片、文件及屏幕截图。消息发送快捷键为 Enter，如果你需要在消息中输入换行，则可以通过 Shift+Enter 或 Alt+Enter 输入。

Markdown

你可以通过发送 Markdown 文本来发送富文本消息。Markdown 语法参见 Markdown 编辑器语法指南。

为避免 XSS 攻击，你无法在 Markdown 中包含 HTML 代码。

Emoji 表情

在喧喧即时通讯软件中，你可以直接输入或粘贴 Emoji 字符来发送表情。如果你的系统或输入法还不支持 Emoji，可以在 getemoji.com 上复制你需要输入的 Emoji 字符。你也可以使用快捷短语来输入 Emoji，例如 :grinning: 来表示 。