wordpresspub/README.md

WordPress 远程发布工具

这是一个用于远程操作 WordPress 网站的内容发布工具，通过 WordPress REST API 实现文章、分类、标签等内容的自动化管理。

功能特性

• 📝 文章管理: 创建、更新、删除文章
• 📂 分类管理: 创建和管理文章分类
• 🏷️ 标签管理: 创建和管理文章标签
• 🖼️ 媒体管理: 上传和管理媒体文件
• 🔐 安全认证: 使用 WordPress 应用密码进行安全认证

快速开始

1. 安装依赖

pip install -r requirements.txt

2. 配置环境变量

复制 .env 文件并填写你的 WordPress 站点信息：

cp .env.example .env

编辑 .env 文件：

# WordPress 站点配置
WORDPRESS_URL=https://your-wordpress-site.com
WORDPRESS_USERNAME=your-username
WORDPRESS_APP_PASSWORD=your-app-password

3. 测试连接

python test_wp_api.py

4. 发布内容

python publish_post.py

文件说明

• test_wp_api.py: API 连接测试脚本
• wp_api_examples.py: 完整的 API 操作示例
• publish_post.py: 简化的内容发布工具
• .env: 环境配置文件
• requirements.txt: Python 依赖包

使用示例

发布文章

from publish_post import WordPressPublisher

wp = WordPressPublisher()

# 发布文章
result = wp.publish_post(
    title="我的新文章",
    content="<p>这是文章内容</p>",
    excerpt="文章摘要",
    status="publish"  # 或 "draft" 保存为草稿
)

创建分类和标签

# 创建分类
category = wp.create_category("技术分享", "技术相关的文章分类")

# 创建标签
tag = wp.create_tag("Python", "Python 编程相关")

# 发布文章时指定分类和标签
wp.publish_post(
    title="Python 教程",
    content="<p>Python 编程教程内容</p>",
    categories=[category['id']],
    tags=[tag['id']]
)

WordPress 应用密码设置

1. 登录 WordPress 后台
2. 进入 用户 -> 个人资料
3. 滚动到 应用密码 部分
4. 输入应用名称（如 "API 工具"）
5. 点击 添加新应用密码
6. 复制生成的密码到 .env 文件中

API 权限要求

确保你的 WordPress 用户具有以下权限：

• 发布文章
• 编辑文章
• 删除文章
• 管理分类和标签
• 上传媒体文件

通常需要 编辑者 或 管理员 角色。

注意事项

1. HTTPS: 建议使用 HTTPS 连接以确保安全
2. 应用密码: 使用应用密码而非普通登录密码
3. 权限: 确保用户具有相应的操作权限
4. 测试: 建议先在测试环境中验证功能

故障排除

认证失败

• 检查用户名和应用密码是否正确
• 确认应用密码格式正确（移除空格）
• 验证用户是否有足够权限

连接超时

• 检查网络连接
• 确认 WordPress 站点是否正常运行
• 验证 URL 是否正确

权限不足

• 确保用户为编辑者或管理员角色
• 检查 WordPress REST API 是否启用

相关资源

• WordPress REST API 官方文档
• WordPress 应用密码设置指南

---

项目目标: 为远程 WordPress 网站提供简单、安全的内容发布解决方案。