jarn.xmpp.core 0.34

扩建

可以在jarn.xmpp.buildout中找到可以用作起点的示例构建。

设置 ejabberd (>=2.1.5)

./bin/ejabberdctl register admin localhost your_password

设置前端代理

在客户端，每个经过身份验证的用户都将通过 HTTP 模拟双向流连接到您的 jabber 服务器。为此，您需要在 Plone 前面有一个代理，它将 XMPP 流重定向到您的 XMPP 服务器。没有使用 Flash 插件的劣质解决方案是可能的，但这不会得到支持。

因此，假设您在域localhost的端口8080上将nginx作为代理运行，Zope 在8081上侦听，存在一个具有 id Plone的 Plone 站点，并且您的 ejabberd为端口5280配置了http_bind，您的nginx配置将如下所示：

http {
    server {
        listen       8080;
        server_name  localhost;
        location ~ ^/http-bind/ {
            proxy_pass http://localhost:5280;
        }

        location / {
            proxy_pass http://localhost:8081/VirtualHostBase/http/localhost:8080/Plone/VirtualHostRoot/;
        }
    }
  }

设置你的克隆实例

您的实例需要保持与 XMPP 服务器管理员帐户的连接。这是通过Twisted完成的，您需要在它们中的每一个上运行一个 Twisted reactor。为此，请将其包含在构建的实例部分中：

zcml-additional =
  <configure xmlns="http://namespaces.zope.org/zope">
    <include package="jarn.xmpp.twisted" file="reactor.zcml" />
  </configure>

同样，它将帮助您查看jarn.xmpp.buildout中提供的示例构建。

设置新的 Plone 站点

• 启动 ejabberd（如果您使用配方构建 ejabberd，bin/ejabberd将完成这项工作）。

• 启动 Nginx 前端。bin/前端启动

• 启动您的 zope 实例。

• 直接在http://localhost:8081/manage访问 Zope并使用jarn.xmpp.core（或jarn.xmpp.collaboration，如果您还想安装该软件包）创建一个新的 Plone 站点。

• 转到 Plone 控制面板，进入注册表设置。编辑 jarn.xmpp.* 设置以反映您的安装、密码等。

• 重新启动您的 Plone 实例。

• 在第一次请求时，管理员将登录到他的帐户。您应该在日志中看到发生的事情，如果有任何错误，您的安装可能有问题。

• 设置用户和发布订阅节点。您可以通过像http://localhost:8080/@@setup -xmpp 一样调用@@setup-xmpp来做到这一点。该表单不会报告任何错误，因为一切都将异步发生，但您将在控制台上获得结果/失败。

如果您打算在现有站点上使用它，您只需在确保 XMPP 管理员已连接后执行最后一步。

确保一切正常；）

这是一个复杂的基础架构，因此有时很难知道哪里出了问题。不要绝望，这里有一些事情可以尝试：

• 确保您的 ejabberd 正在运行。以管理员用户身份连接到它的普通客户端。

• 验证在 ejabberd 上正确设置了 http-binding。访问http://localhost:5280/http-bind应该告诉你它正在工作。

• 验证 XMPP 请求是否可以正确通过您的代理。访问http://localhost:8080/http-bind/应该会得到与上面相同的结果。

• 当您在前台启动 Zope 实例时，您可以验证 Twisted reactor 运行良好：

  2011-09-01 14:37:38 INFO jarn.xmpp.twisted Starting Twisted reactor...
  2011-09-01 14:37:38 INFO jarn.xmpp.twisted Twisted reactor started
  2011-09-01 14:37:38 INFO Zope Ready to handle requests

• 在对站点的第一次请求之后，您还应该在日志中看到：

  2011-09-01 14:45:48 INFO jarn.xmpp.core XMPP admin client has authenticated succesfully.

• 运行@@setup-xmpp后，使用用户登录到 Plone 站点还应该使用 XMPP 服务器对他进行身份验证。这在日志中通过以下方式指示：

  2011-09-01 14:45:50 INFO jarn.xmpp.core Pre-binded ggozad@localhost/auto-QravOoyEeE

0.34 - 2011-12-9

• 修复谷歌地图初始化。[格扎德]

0.33 - 2011-12-07

• IE9 兼容性。[格扎德]

• 用于 BOSH 身份验证的无缓存。[格扎德]

0.32 - 2011-11-30

• UI/UX 改进。[米舒诺夫]

• 修复了一个无标题的 portlet 错误。[格扎德]

• 修复了一个错误，该错误将允许存储从每个节点仅加载 10 个项目。[格扎德]

• 修复了 json 视图以正确设置 json 标头。[格扎德]

0.31 - 2011-11-28

• 版本修复。[格扎德]

0.3 - 2011-11-28

• 支持 pubsub 节点上的一级线程。[格扎德]

• 允许用户订阅单个节点。[格扎德]

• 异步加载 PubSub 项目。[格扎德]

• 在 XMPP 上实现 XEP-0049 私有存储。[格扎德]

• 实施 vCard 2.0 支持。允许将所有用户元数据/头像存储在 XMPP 服务器上，避免所有对 Plone 的调用。[格扎德]

• 修复 Safari 浏览器确实行为不端并有时崩溃的罕见情况。将补丁恢复到 Strophe 以允许 WebKit 浏览器进行同步而不是异步调用以在页面卸载时断开连接。[格扎德]

• 造型！[米舒诺夫]

• 更新德语翻译 [potzenheimer]

• 更新法语翻译 [toutpt]

0.23 - 2011-11-02

• 添加德语翻译 [potzenheimer]

• 添加了意大利语翻译 [giacomos]

• 添加了法语翻译 [toutpt]

0.22 - 2011-11-02

• i18n 支持。暂时是挪威语和希腊语。[格扎德]

• 提供一个显示 PubSub 提要的 portlet。[格扎德]

• 修复了 url 指向二进制文件时的魔术链接错误。 https://github.com/ggozad/jarn.xmpp.core/issues/13 [ggozad]

0.21 - 2011-10-27

• 除非必要，否则不要跟踪用户的地理位置。[格扎德]

• 代理网站图标的下载（关闭 #11）。[格扎德]

• 将肖像链接到提要视图中的个人信息流。（关闭#10）。[格扎德]

• pubsub 提要的“漂亮日期”。（关闭#8）。[格扎德]

0.2 - 2011-10-20

• 添加地理定位功能。发布到提要现在可以包含地理位置数据。[格扎德]

• 将 sessionStorage 用于用户信息数据，以便每个会话仅获取一次。[格扎德]

0.2b1 - 2011-10-09

• 为消息传递、状态、发布订阅源设计和实现出色的 UI。[米舒诺夫，格扎德]

• 替换 python 视图/实用程序以通过 js 发布到节点。[格扎德]

• 提供 pubsub 项目视图并在 pubsub 提要视图中异步加载它们。[格扎德]

• 在支持的浏览器中开始使用 sessionStorage。[格扎德]

• 删除多用户聊天。定义用例后，它将再次正确进入。[格扎德]

0.1b4 - 2011-09-30

• 恢复使用 Strophe 1.0.1 作为针对坚持转义所有内容的损坏的 xml 解析器的解决方法。[格扎德]

0.1b3 - 2011-09-18

• 修补 strophe 以发出同步请求，以便能够 在 onbeforeunload上真正断开连接。这是为了阻止基于 WebKit 的浏览器在用户超时之前保持连接。此外，不再使用 strophe 库的缩小版本，因为我们修补了它们。[格扎德]

• 文档更新。[tkimnguyen]

0.1b2 - 2011-09-02

• 如果尚未安装产品，则修复启动订阅者不执行任何操作。这允许您在现有站点上安装。[格扎德]

• 更新到 Strophe 1.0.2 [ggozad]

0.1b1 - 2011-09-01

• 简化配置并修复注册表中令人困惑的拼写错误 [ggozad]

• 管理客户端现在处理连接失败和断开连接。发生这种情况时，管理客户端实用程序将取消注册，并将在下一个请求时重试。[格扎德]

• 现在可以使用一个 viewlet，通过它可以执行所有操作。[格扎德]

• 在构建中添加配方以构建 ejabberd。需要工作的 erlang 安装。[格扎德]

• JS 修复 [ggozad]

0.1a3 - 2011-06-06

• 包含使用collective.recipe.template 生成工作ejabberd.cfg 的配方。[格扎德]

• 为 pubsub 添加了一些基本测试。[格扎德]

• 仅当在 testrunner 上指定级别 2 时才运行需要 EJABBERD 层的测试。[格扎德]

0.1a2 - 2011-05-11

• 更新了有关如何添加最近的 wokkel 的文档。[格扎德]

0.1a1 - 2011-05-09

• 初始版本 [ggozad]