一站通（OneStop）使用说明

一站通插件用于在 zsadmin 更新内容时，将帖子自动/手动同步到其他程序站点，实现「一个后台发布，多站点分发」。

• 版本：v1.0.1
• 作者：kuakeba.cn

功能特性

• 支持多站点同时同步，每个站点独立配置同步事件（新增/更新/删除）
• 内置 8 种目标程序驱动：WordPress、Typecho、Z-BlogPHP、Joomla、Flarum、Discuz!、Xiuno BBS、通用 Webhook
• 同步映射表：编辑帖子时更新远程文章，不会重复发帖
• 同步记录：每次同步的结果、耗时、远程 ID 均可查询，失败可一键重试
• 手动推送：可按帖子 ID 把历史内容批量推送到指定站点
• 可配置内容格式（HTML/纯文本）、是否附加原文链接
• 同步失败仅记录日志，不影响本站发帖主流程

安装与启用

1. 将 OneStop 文件夹放入 plugins 目录
2. 后台「应用中心 → 插件」找到「一站通」，点击安装并启用
3. 后台左侧菜单出现「一站通」入口

全局配置（插件配置）

添加同步站点

后台「一站通 → 新增站点」，按程序类型填写：

WordPress

• 站点地址：WP 站点首页地址（需开启 REST API，默认开启）
• 登录用户名：WP 用户名
• 应用密码：WP 后台 → 用户 → 个人资料 → 应用密码（不是登录密码）
• 远程栏目：远程分类 ID（分类目录页 URL 中的 tag_ID），多个用英文逗号分隔
• 发布状态：直接发布 / 存为草稿 / 待审核

Typecho / Z-BlogPHP（XML-RPC）

• Typecho 端点：站点地址/index.php/action/xmlrpc（在「设置 → 基本」确认开启 XML-RPC）
• Z-BlogPHP 端点：站点地址/zb_system/xml-rpc/index.php（在「网站设置」开启 XML-RPC 协议）
• 登录用户名/密码：后台账号密码
• 远程栏目：分类名称，多个用英文逗号分隔

Joomla 4+

• 站点地址：Joomla 站点首页地址（需开启 Web Services，默认开启）
• API Token：Joomla 后台 → 用户 → 管理 → API Tokens 生成
• 远程栏目：文章分类 ID（catid 数字）

Flarum

• 站点地址：Flarum 站点首页地址
• API Token：管理员 API Token（api_keys 表或插件生成）
• 仅支持新增与删除，编辑更新自动跳过

Discuz! / Xiuno BBS（模拟登录）

• 站点地址：论坛首页地址（不带结尾斜杠）
• 登录用户名：Xiuno 填登录邮箱；Discuz 填用户名
• 登录密码：论坛账号密码（该账号需有目标版块发帖权限）
• 远程栏目：版块 FID 数字（Xiuno：forum-{fid}-1.htm；Discuz：fid={fid}）
• Discuz 需关闭登录验证码、发帖验证码与防水墙，否则无法同步
• 仅支持新增，编辑/删除自动跳过

通用 Webhook

• 站点地址：接收 JSON 的完整地址（Zapier / n8n / 自建接口等）
• 令牌（可选）：填写后请求头携带 X-OneStop-Token
• 请求体格式：{"action": "create|update|delete", "topic": {...}, "site": {...}, "time": 时间戳}
• 响应 JSON 中的 id / link 字段（可选）将作为远程文章标识，用于后续更新

同步流程说明

1. 本站发布新帖 → 对每个已启用且开启「新增同步」的站点执行远程发帖，成功后在映射表记录远程文章 ID
2. 编辑已有映射的帖子 → 更新远程文章（WordPress/Typecho/Z-Blog/Joomla/Webhook 支持）
3. 删除帖子 → 删除远程文章并清理映射（需插件配置与站点均开启删除同步）
4. 帖子处于隐藏/待审核等非正常状态时不同步

手动推送与记录

「一站通 → 同步记录 / 手动推送」页：

• 手动推送：输入帖子 ID（逗号分隔，单次最多 50 个，可从「最近帖子」下拉点选），选择目标站点（不选 = 全部已启用站点），立即执行
• 同步记录：按站点、帖子 ID、动作、结果筛选；失败记录可点「重试」；「清空记录」可清理历史日志

常见问题

同步失败但发帖正常？

这是设计如此：同步失败只写入日志，不影响本站流程。到「同步记录」查看失败原因并重试。

WordPress 提示 401/403？

检查是否使用了「应用密码」而非登录密码，且该用户有发布文章权限。

Typecho/Z-Blog 提示 404？

XML-RPC 未开启或站点地址填错，参照上文开启对应协议。

Discuz 登录失败？

确认关闭了登录验证码/验证问答；部分安全插件也会拦截模拟登录。

编辑帖子后论坛类站点没有更新？

Discuz/Xiuno/Flarum 不支持远程更新，会在日志中记录「已跳过」，属正常行为。