opa

OPA-网络的XMPP聊天客户端

• 介绍
• 特征
• 要求
• 入门
  • 安装
  • 配置
  • 国际化
  • 兼容性
• 学分

介绍

OPA是完全建立在VUE ， NUXTJ和Elementui顶部的Web（SSR）的开源XMPP聊天客户端，遵循最酷的趋势再见闪光灯和桌面客户端呢

琐事：“ OPA”，在巴西的许多含义中，也非正式地用作问候！

---

OPA拥有一种现代设计，具有干净的界面，可提供良好的用户体验。该界面的灵感来自JavaScript环境中已经存在的许多Web应用程序，例如WhatsApp Web ， Telegram Web ， Discord ， Rocket Chat等...它是作为一个内部项目诞生的，目的是填补不需要在每台机器上安装的XMPP客户端，而是使用当前技术的每台计算机上的安装，并在公司环境中具有现代设计和支持的通用功能。

---

OPA有一个最新版本的演示。用于测试有两个用户：

用户名：Darth密码：1234

用户名：卢克密码：1234

该演示可以在这里获得，玩得开心：https：//www.credija.com.br/opa-demo

---

是否有一些功能，建议或遇到错误？打开一个问题，以便我们可以讨论吗？

---

特征

在此处检查功能：https：//github.com/credija/opa/wiki/features

要求

目前，OPA使用https://polyfill.io/v3/polyfill.min.js?flags= gited以获得更好的支持，因为您的浏览器需要支持以下三个功能：

• https://caniuse.com/#search = es6
• https://caniuse.com/#feat=flexbox
• https://caniuse.com/#feat= IntersectionObserver
• https://caniuse.com/#feat=atob-btoa

此外，您的XMPP服务器必须支持MSM/RSM（用于消息归档）。

入门

OPA的最初想法是成为任何XMPP服务器的插件n-play客户端。

之后，您有两种运行此应用的方法：

• 用nodejs从源建造和运行

• 使用提供的Docker容器并覆盖全局配置文件

安装

nodejs（来自源）

使用nodejs安装将需要您安装软件包管理器纱线。您可以使用此命令在nodejs环境上安装纱线：

 npm install yarn -g

安装纱线后，您需要将项目克隆到文件夹中。此文件夹将是OPA服务器将从以下位置运行的地方：

 git clone https://github.com/credija/opa.git

克隆项目后，您需要导航到此文件夹并运行下面的命令以构建和启动OPA：

 yarn build && yarn start

但是，您需要连接到XMPP服务器。为此，您需要覆盖/your-project-clone-folder/static/config/app-config.json（配置文件中每个选项的说明在配置部分中）。

Docker

使用Docker的安装非常简单。但是，您需要连接到XMPP服务器。为此，您需要覆盖/app/static/config/app-config.json（配置文件中的每个选项的说明是在配置部分中）：

 docker run --name opa -d --restart=always 
  --publish 3000:3000 
  --volume /opt/your-config.json:/app/static/config/app-config.json 
  -m 512MB 
  credija/opa

---

配置

要连接到XMPP服务器，您需要覆盖App-config.json。选项是：

• XMPP_SERVER_ADDRESS ：HTTP/S BOSH或WSS WebSocket连接的地址。
• xmpp_server_domain ：您的聊天域。
• app_locale ：需要以“语言乡村”的格式设置语言环境，例如“ en-us”，“ pt-br”等，因为此值将用于通过应用程序格式化日期。
• show_users_without_groups ：布尔值。非常适合向没有组的用户展示（将放入一个“其他”组），而对于隐藏这些用户来说是错误的。

国际化

OPA具有用于环境的插头-N-Play结构，该结构存储在 /静态 /语言环境中。

现在有这些语言：

• En-us
• pt-br
• de-de（感谢@matzeso的此翻译）

如果您想测试OPA，但它没有您的语言，则可以按照en-us.json提供的示例开发自己的翻译到该应用程序。

完成后，将带有您的翻译的开发分支请求请求，因此我们可以将其添加到OPA中。

注意：重要的是要记住，该文件需要遵循“语言country.json”格式，该格式与app_locale选项中使用相同。

兼容性

经过测试的浏览器：

• Google Chrome
• Firefox
• 歌剧
• Microsoft Edge

未测试：

• IE
• 野生动物园

---

测试的XMPP服务器：

• IGNITE实时：OpenFire Server版本4.3.2
• Ejabberd版本18.04

学分

• 感谢Sicoob Credija的IT团队，该团队为该项目的开发提供了支持，测试和基础架构。

• 感谢Vuejs，Nuxtjs，Element-UI，STROPHEJS的核心库。

• 该应用中使用的表情符号来自Twemoji项目，并根据CC-BY 4.0许可。