WP Chiral Network

Zh/EN

Chiral Connector 插件

Chiral Connector 是 Chiral Hub 生态系统的客户端插件。它安装在各个独立的 WordPress 站点（我们称之为“Hub 站点”）上，作为连接中心枢纽（Chiral Hub Core）的桥梁。

通过 Chiral Connector，您的站点可以轻松地将文章数据（如标题、摘要、特色图片等）安全地同步到 Chiral Hub。更重要的是，它能够从整个内容网络中获取由 Jetpack 驱动的智能相关文章推荐，并将其无缝地展示在您的文章页面上。

这不仅极大地丰富了您网站的内容，还能有效提升用户参与度和页面浏览量，将您站点的内容影响力扩展到整个 Chiral 网络。

详见：工作原理

核心功能：

  • 无缝集成：轻松连接到您的 Chiral Hub Core 中心站点。
  • 自动同步：在您创建、更新或删除文章时，自动将内容元数据同步到 Hub。
  • 智能推荐：在您的文章末尾或通过简码，展示来自全网的高度相关的文章。
  • 灵活控制：可自由配置需要同步的文章类型、相关文章的显示数量和标题。
  • 状态监控：提供连接测试、缓存清理和批量同步工具，让您随时掌控站点状态。

效果

插件作者博客文章：https://1q43.blog/post/11054/

下载

最新版本： 1.1.0

最后更新日期：2025-06-11

下载地址：Github

安装指南

在安装 Chiral Connector 之前，请确保您已从 Hub 管理员处获取了以下信息：

  • Hub 站点的 URL
  • 一个 Chiral Porter 角色的用户名
  • 为该用户生成的应用程序密码

安装步骤：

  1. 登录到您的 WordPress 节点站点（即您希望安装 Connector 的站点）的管理后台。
  2. 导航到 插件 > 安装插件。
  3. 点击页面顶部的 上传插件 按钮。
  4. 选择您刚刚下载的 chiral-connector.zip 文件，然后点击 立即安装。
  5. 安装完成后，点击 启用插件。

生成应用程序密码

在开始配置之前，你需要首先使用账号密码登录你要加入的 Hub（如https://hub.yournetwork.com）

在个人资料页面，生成一个应用程序密码：

该密码不能用来直接登录 Hub，而是专门用来给插件访问 Hub。

初始配置

启用插件后，您需要在 WordPress 后台菜单中找到 Chiral Connector 设置页面，并完成初始配置。

  1. 连接设置 (Connection Settings):
    • Hub URL: 填入您的 Chiral Hub Core 站点的完整 URL (例如: https://hub.yournetwork.com)。
    • Hub Username: 填入 Hub 管理员提供给您的 Chiral Porter 用户名。
    • Hub Application Password: 填入为该 Porter 用户生成的应用程序密码。这不是用户的登录密码。
  2. 显示选项 (Display Options):
    • Enable Related Posts: 勾选此项以在文章页自动显示相关文章。
    • Number of Posts: 设置希望显示的相关文章数量。
  3. 保存与测试:
    • 点击 保存更改。
    • 点击 测试连接 (Test Connection) 按钮。如果看到“成功连接到 Hub！”的提示，说明配置无误。
  4. 首次批量同步：
    • 对于已有大量内容的站点，建议点击 触发批量同步 (Batch Sync All Posts) 按钮，将现有文章一次性同步到 Hub。

常见问题 (FAQ)

连接测试失败怎么办？

请按以下步骤排查：

联系 Hub 管理员确认您的凭据和 Node ID 是否有效。

仔细检查 Hub URL 是否拼写正确，并包含了 http:// 或 https://。

确认 Hub Username 和 应用程序密码 是否完全正确，没有多余的空格。

确保 Hub 站点可以正常访问，并且没有防火墙或安全插件阻止其 REST API。

为什么我的文章没有同步到 Hub？
  1. 首先，请确保连接测试成功。
  2. 首次加入一个网络时，需先运行 Batch Sync All Posts，以便将历史文章同步至 Hub。
  3. 在文章编辑页面，检查右侧的 “Send to Chiral?” meta box 是否被勾选。
  4. 部分文章可能在 Hub 端被设置为“待审”状态，需要 Hub 管理员审核后才能参与推荐。请联系管理员确认。
相关文章模块没有显示出来？
  1. 确保在设置中已经 启用相关文章 显示。
  2. 内容同步到 Hub 并被 WordPress.com 索引需要一些时间。特别是新站点，请在批量同步后耐心等待一段时间。
  3. 如果您的主题非常特殊，可能没有正确调用 the_content 过滤器。您可以尝试在文章内容中手动插入
    Loading related Chiral data...
     简码来指定显示位置。
  4. 网络中的文章数量越多，推荐的准确性和可用性就越高。如果网络中内容较少，可能暂时没有合适的文章可推荐。
我如何修改我的文章在其他站点中展示的 Source 名？

Source Name 目前从 Hub 站点的 Porter 用户对外展示名定义。你需要使用你在 Hub 战线上的 Chiral Porter 用户登录，然后进入【用户】>【个人资料】页面进行修改。

如果你的 Hub 站点不允许你登录他们的 WordPress 后台，你可以要求 Hub 站点管理员帮助你修改。

使用 lightspeed 时，相关文章为什么加载错误？

你需要在 Lightspeed 中为本插件的相关文章加载设置例外，避免插件缓存与 Lightspeed 缓存的冲突。具体步骤如下：

  1. 导航到 ESI 设置 ：在您的 WordPress 后台，转到 LiteSpeed Cache -> Cache -> ESI 标签页。
  2. 启用 ESI 功能 ：将 Enable ESI (启用 ESI) 选项设置为 ON 。
  3. 添加 Nonce 到 ESI 列表 ：
  4. 找到 ESI Nonces (ESI Nonce 列表) 这个文本框。在这个框里，添加一行 Chiral Connector 用于相关文章的 Nonce 句柄：chiral_connector_related_posts_nonce
点击“退出网络 (Quit Network)”会发生什么？

这是一个非常重要的操作。点击后，Connector 会向 Hub 发送请求，要求删除与您的 Node ID 相关的所有数据。同时，它会清除本地的所有连接设置并停用插件。此操作几乎是不可逆的。 操作后，您有责任登录 Hub 站点，亲自确认您的数据是否已被彻底清除。