如何使用 BlogTend 将自动化集成到 WordPress

通过 BlogTend 成功将自动化与 WordPress 集成，需要在两种连接方式中做出选择并正确配置核心设置。你可以通过 WordPress 核心的应用密码（Application Passwords）使用原生 REST API 进行连接；如果托管环境限制 API 访问，则可使用官方 BlogTend Connector 插件。无论哪种方式，设置过程均在十五分钟内完成，并为自动化内容发布建立安全通道。

了解 BlogTend 的集成选项

BlogTend 支持两种连接架构。方法 A 使用 WordPress 核心的应用密码，通过 HTTPS 对原生 REST API 进行身份验证，无需安装任何插件。方法 B 使用 BlogTend Connector 插件，适用于剥离 HTTP Authorization 标头或限制核心 REST 路由的主机。根据 BlogTend 的集成指南，该插件已在 WordPress 7.1.x 版本中测试通过，并保持对旧版命名空间的向后兼容性。

原生 REST API 方法适用于自托管的 WordPress 5.6+ 及 WordPress.com Business 及以上套餐。当安全防火墙阻止 /wp-json/wp/v2/ 端点或服务器配置丢弃标准 Authorization 标头时，必须使用 Connector 插件。在这些情况下，插件通过备用 X-AutoPress-Token 标头接收令牌，并通过自定义 autopress/v1 路由处理请求，将连接令牌存储为 SHA-256 哈希值。

BlogTend 会自动将原生 SEO 元数据写入 Yoast SEO 或 Rank Math。如果这两个插件都不存在，它会回退到自定义文章元键（_autopress_seo_title, _autopress_seo_desc, _autopress_seo_keyword），供自定义主题调用。所有推送的内容均使用结构化语义 HTML 块而非原始样式，确保文章能通过 WordPress KSES 清理并适应主题的排版标记。

将自动化集成到 WordPress：设置 API 连接

在 WordPress 中生成应用密码

应用密码于 2020 年 12 月 8 日随 WordPress 5.6 推出，为非交互式系统提供专用凭证。正如 WordPress Core UI Notice 所述：“应用密码允许通过非交互式系统（如 XML-RPC 或 REST API）进行身份验证，而无需提供你的实际密码。应用密码可以轻松撤销，不能用于网站的传统登录。”

1. 导航至个人资料以管理员身份登录 WordPress，前往用户 → 个人资料 (/wp-admin/profile.php).
2. 找到应用密码部分滚动到个人资料页面底部的“应用密码”部分。
3. 命名并生成在“新应用密码名称”下输入标识符，例如 'BlogTend'（在 WordPress 6.8+ 中，按钮显示为“添加应用密码”；早期版本显示为“添加新应用密码”）。点击生成。
4. 立即复制凭证WordPress 会显示一个由六个 4 字符块组成的 24 字符密钥。请立即复制；它只显示一次。请将其存储在密码管理器中。

配置 BlogTend 仪表盘

在 BlogTend 仪表盘中，导航至站点 → 连接站点 → WordPress → 应用密码。准确填写以下三个字段：

• 站点 URL： 你的主页 URL，省略末尾斜杠，例如， https://example.com
• WordPress 用户名： 生成应用密码的管理员的用户名
• 应用密码： 从 WordPress 复制的完整 24 字符密钥

点击验证连接。BlogTend 将尝试针对 /wp-json/wp/v2/users/me进行握手。绿色确认表示身份验证成功。

若改用 Connector 插件方法，请选择“站点 → 连接站点 → WordPress → Connector 插件”，并提供站点 URL 以及在 WordPress 设置 → BlogTend 下生成的可撤销插件令牌。

验证初始连通性

在运行第一个自动化流程之前，请确认你的 WordPress 固定链接结构设置为“朴素”以外的其他选项。前往 WordPress 的设置 → 固定链接，选择“文章名”、“日期和名称”或自定义结构。REST API 需要重写规则才能工作，而“朴素”固定链接通常会完全禁用这些规则。这是最常见的前置条件失败原因。

在 WordPress 中管理自动化内容

映射分类法并设置文章状态

连接后，将 BlogTend 的分类和标签映射到你现有的 WordPress 分类法。在 BlogTend 仪表盘中，进入站点的“内容设置”。对于每个 BlogTend 分类，从下拉菜单中选择对应的 WordPress 分类。未映射的分类将自动创建新的 WordPress 分类，这可能会随着时间推移使你的分类法结构变得杂乱。

在首次运行前设置默认文章状态。选项包括草稿、待审核或立即发布。大多数用户从“草稿”开始，以便在内容上线前审查自动化内容。你可以根据需要按活动或按运行更改此设置。

通过 API 上传处理特色图片

BlogTend 可以在同步期间自动上传特色图片。标准横向尺寸为 1200 x 630 px，符合各平台的 Open Graph 规范。在你的 BlogTend 内容设置中，启用“上传特色图片”，并指定是使用 BlogTend 自动生成的图片、自定义图片来源 URL，还是你的媒体库。

图片通过 WordPress REST API 媒体端点上传。确保你的 WordPress 安装允许足够大小的文件上传，通常压缩图片至少需要 2 MB。上传的图片作为 featured_media 附加到文章对象上，并继承主题的响应式图片处理功能。

排查常见集成问题

缓存与安全插件冲突

缓存插件和安全防火墙是导致 API 受阻的常见原因。全页缓存插件可能会错误地缓存 REST API 响应。Wordfence 或 Sucuri 等安全插件有时会将重复的 API 请求视为暴力破解尝试而进行拦截。

解决方法：将 BlogTend 的 IP 范围添加到安全插件白名单中，并将 /wp-json/ 从缓存规则中排除，同时考虑为经过身份验证的 REST 流量提供速率限制豁免。如果您的主机使用了具有激进规则的 ModSecurity，Connector 插件方法可以通过其自定义命名空间绕过许多此类限制。

持续同步与更新的最佳实践

通过 BlogTend 仪表板的连接状态指示器监控集成健康状况，该指示器显示上次成功同步的时间以及任何近期的错误计数。请每周检查一次，尤其是在更新 WordPress 核心或插件之后。

在更新 WordPress 核心、主题或插件时，如果可能，请在测试环境中随后测试 BlogTend 的连接。主要的 WordPress 版本偶尔会更改 REST API 的行为。Connector 插件会接收兼容性更新，因此如果您使用该插件，请保持其为最新版本。

扩展内容量需要关注服务器资源。高频自动发布会产生数据库写入、媒体上传和缓存失效。监控您的托管资源使用情况，并在从每周发布增加到每日发布之前考虑升级套餐。如果需要更高的数量限制或额外的站点连接，请 比较套餐。

标准的自动运行绝不会覆盖或删除以前发布的文章。正如 BlogTend 团队在其集成指南中指出的：“每次运行都会创建一篇新文章。您已发布的任何内容都不会被编辑或删除。不过，系统会读取您现有的文章，以便在新文章中建立链接，并确保不会撰写您已有的内容。”

这种设计保护了您的手动编辑。您可以安全地在 WordPress 中修改标题、添加内部链接或调整格式，而无需担心下一次自动化运行会撤销这些更改。但是，如果您需要刷新旧内容，BlogTend 为此提供了特定操作。根据官方文档说明：“指向 BlogTend 一篇已发布的文章，它会就地重写，保持相同的 URL 和发布日期，保留其自身的链接，并记录其更新的内容。”

对于自定义字段工作流_autopress_seo_title等）可以通过主题中的简单筛选器映射到主题的自定义字段， functions.php 或者使用代码片段插件。

对于准备自动化的团队，免费开始并运行第一个测试草稿以验证工作流。初始设置投入能迅速收回成本，且受保护的覆盖行为确保在优化流程的同时，现有内容保持安全。