WordPress 6.x 文章发布接口 火车头采集器发布到WP 自动创建分类 相同标题更新内容

该接口目的是，相同的文章标题，会覆盖更新内容，而不会重复创建新的文章。

而且可以自动创建文章分类，无需手动在后台一个一个的去创建文章分类。

该接口只适用于文章类型，需要产品的，请看woocommerce产品的接口。

接口概述

这是一个专为火车头采集器设计的WordPress文章发布接口，支持文章的创建、更新、自动分类创建、自动作者创建等功能。

---

基础配置

1. 接口文件配置

在接口文件开头修改以下配置项：

$post_author_default    = 1;           // 默认作者ID
$post_status            = 'draft';     // 发布状态：draft|publish|pending
$secretWord             = '123456';    // 接口密码，请务必修改！
$checkTitle             = true;        // 是否启用标题重复检查

2. 文件放置位置

将接口文件放置在WordPress根目录或子目录中，确保可以访问到wp-config.php文件。

---

接口调用方式

基础URL

http://您的域名/接口文件路径.php?action=save&secret=您的密码

请求方法

支持 POST 和 GET 方法

---

完整字段说明

🔴 必需字段

字段名	说明	示例
post_title	文章标题	我的第一篇文章
post_content	文章内容	<p>这是文章正文内容</p>

🟢 可选字段

分类相关

字段名	说明	示例
post_category	文章分类（支持自动创建）	技术,编程 或 1,2,3
post_taxonomy	分类法	category（默认）
category_description	分类描述	技术相关文章分类
post_parent_cate	父级分类	技术分类

内容相关

字段名	说明	示例
post_excerpt	文章摘要	这是文章摘要内容
post_type	文章类型	post（默认）
tag	文章标签	PHP,WordPress,教程
post_date	发布时间	2024-01-15 14:30:00

作者相关

字段名	说明	示例
post_author	作者	1 或 管理员

自定义字段

字段名	说明	示例
post[post_meta][字段名]	自定义字段	post[post_meta][seo_title]=SEO标题
post_cate_meta	分类自定义字段	复杂格式，一般不使用

文件上传

字段名	说明	示例
fujian0, fujian1…	附件文件	文件上传字段
thumb	特色图片	文件上传字段

---

详细使用示例

示例1：基础文章发布

POST /publish.php?action=save&secret=123456

post_title=我的技术文章
post_content=<p>这是文章正文内容，支持HTML格式。</p>
post_category=技术,编程
post_excerpt=这是文章摘要
tag=PHP,WordPress,教程
post_date=2024-01-15 14:30:00

示例2：带自定义字段的文章

POST /publish.php?action=save&secret=123456

post_title=SEO优化文章
post_content=文章内容...
post_category=SEO,营销
post[post_meta][seo_title]=自定义SEO标题
post[post_meta][seo_description]=自定义SEO描述
post[post_meta][custom_field]=自定义值

示例3：自动创建分类和作者

POST /publish.php?action=save&secret=123456

post_title=新作者的文章
post_content=内容...
post_category=人工智能,机器学习  # 自动创建这两个分类
post_author=新作者名称          # 自动创建这个作者

示例4：文件上传

使用multipart/form-data格式上传文件：

POST /publish.php?action=save&secret=123456

post_title=带图片的文章
post_content=文章内容...
post_category=图片
fujian0=@/path/to/image1.jpg
fujian1=@/path/to/image2.jpg
thumb=@/path/to/featured.jpg

---

自动创建功能说明

1. 自动创建分类

• 当提交的分类名称不存在时，系统会自动创建
• 支持多级分类（通过post_parent_cate指定父级）
• 支持中英文分类名称
• 自动处理分类重复问题

2. 自动创建作者

• 当提交的作者名称不存在时，系统会自动创建用户
• 用户名会自动处理（中文会转为MD5前10位）
• 用户角色默认为”投稿者”
• 自动设置作者基本信息

3. 标题重复检查

• 当checkTitle=true时，会检查标题是否重复
• 发现重复标题时，会更新现有文章而不是创建新文章
• 返回信息会明确显示是”发布成功”还是”更新成功”

---

响应信息说明

成功响应

发布成功
文章ID: 123
文章URL: http://yoursite.com/?p=123
时间戳: 1705293000

或

更新成功
文章ID: 123
文章URL: http://yoursite.com/?p=123
时间戳: 1705293000

错误响应

发布失败，错误信息：
ERROR: 具体错误信息

常见错误信息

• 标题为空 – 未提供文章标题
• 内容为空 – 未提供文章内容
• 接口密码错误 – 密码不匹配
• 非法操作 – action参数错误

---

其他功能接口

1. 获取分类列表

GET /publish.php?action=list&secret=123456

响应格式：

<<<1--未分类>>>
<<<2--技术>>>
<<<3--编程>>>

2. 发布待审文章

GET /publish.php?action=update&secret=123456

---

火车头采集器配置

1. Web发布配置

• 发布地址: http://您的域名/publish.php?action=save&secret=123456
• 发布方式: POST
• 编码格式: UTF-8

2. 内容发布参数

在火车头中设置以下发布参数：

参数名	参数值	说明
post_title	[标签:标题]	文章标题
post_content	[标签:内容]	文章内容
post_category	[标签:分类]	文章分类
post_excerpt	[标签:摘要]	文章摘要
tag	[标签:标签]	文章标签
post_date	[标签:时间]	发布时间

3. 文件发布配置

• 文件上传字段名: fujian0, fujian1…
• 缩略图字段名: thumb
• 支持多文件同时上传

---

高级功能

1. 禁用标题重复检查

在URL中添加参数临时禁用重复检查：

http://yoursite.com/publish.php?action=save&secret=123456&check_title=false

2. 强制发布状态

通过修改代码中的$post_status变量来控制发布状态：

• draft – 草稿
• publish – 已发布
• pending – 待审核

3. 自定义文章类型

通过post_type字段支持自定义文章类型：

post_type=news  # 发布到news自定义文章类型

---

故障排除

1. 常见问题

• 无法连接到WordPress: 检查接口文件路径是否正确
• 密码错误: 检查secret参数是否匹配
• 分类创建失败: 检查分类名称是否包含特殊字符
• 文件上传失败: 检查文件大小和格式限制

2. 调试模式

在代码中添加错误日志输出：

error_log("调试信息: " . $variable);

3. 安全建议

• 定期修改接口密码
• 限制接口访问IP（如果需要）
• 及时更新WordPress和插件

---

注意事项

1. 备份数据 – 在使用前请备份网站数据
2. 测试环境 – 先在测试环境验证功能
3. 权限检查 – 确保WordPress有正确的文件写入权限
4. 性能考虑 – 大量发布时注意服务器负载

这个接口提供了完整的WordPress文章发布功能，支持火车头采集器的所有常用特性，可以满足大多数内容采集和发布需求。