上次的教程我们已经成功的安装好了wordpress,那么这节课我们就来学习下wordpress_xmlrpc模块的功能使用以及如何用它来发布文章。
一、使用wordpress_xmlrpc模块登录WordPress
Client类是连接登录WordPress的接口,使用该类就初始化一个wp的客户端。然后就可以通过这个客户端对wp进行相关的操作。
class Client(url, username, password[, blog_id, transport])
参数说明:
url:WordPress站点的xmlrpc文件所在的url
username: 站点后台用户名
password: 站点后台的密码
blog_id:博客的id(WordPress会忽略这个值)(不需要填)
transport: 自定义XML-RPC传输实现(不需要填)
Client类:返回wordpress_xmlrpc.base.Client对象
如果返回了wordpress_xmlrpc.base.Client对象则可以表明登录成功了。
Client对象还有一个call方法,该方法用来调用xml-rpc的方法的,也就是说所有的xml-rpc方法都是要通过call方法调用才能执行。
二、WordPress_xmlrpc对象
登录成功后我们就可以对WordPress_xmlrpc的一些对象进行操作了,这里有一份官方文档,列举了WordPress的所有可操作对象及其属性。
官方文档:http://python-wordpress-xmlrpc.readthedocs.io/en/latest/ref/wordpress.html
仅仅知道WordPress_xmlrpc对象还不够,想要用python发布文章还需要知道每个对象的方法,才能对对象进行操作。
三、WordPress_xmlrpc方法
官方文档:http://python-wordpress-xmlrpc.readthedocs.io/en/latest/ref/methods.html
这里需要重点说明Methods类,我们的发文工具主要就是运用这个类的多种方法来实现的。Methods类中有几个常用的方法:
GetPosts方法:class wordpress_xmlrpc.methods.posts.GetPosts([filter, fields])
获取所有文章,返回WordPressPost实例,以文章列表形式。通过查看官方文档(http://python-wordpress-xmlrpc.readthedocs.io/en/latest/ref/wordpress.html#WordPressPost)看到,WordPressPost实例有各种属性,我们可以通过“.”的方法来获得:
#-*-coding: utf-8-*-
import time,pymysql
from wordpress_xmlrpc.exceptionsimport ServerConnectionError
from wordpress_xmlrpcimport Client, WordPressPost ,WordPressTerm
from wordpress_xmlrpc.methodsimport posts,taxonomies
from wordpress_xmlrpc.methods.postsimport GetPosts, NewPost
from wordpress_xmlrpc.methods.usersimport GetUserInfo
try:# 检测是否登录成功
# 登录WordPress后台
client = Client('http://127.0.0.1/wordpress/xmlrpc.php','admin','123456')
### client = Client('http://dsfsfsdf.com/xmlrpc.php', 'xxxxxx', 'xxxxxx') # Client类:返回wordpress_xmlrpc.base.Client对象
exceptServerConnectionError:
print('登录失败')
else:
print('登录成功')
# print(client)
# 获取所有文章,返回WordPressPost实例,文章列表
# class wordpress_xmlrpc.methods.posts.GetPosts([filter, fields])
post_list = client.call(posts.GetPosts())#所有的xml-rpc方法都是要通过call方法调用才能执行
for p in post_list:
print(p.title)
print(p.content)
print(p.link)
NewPost()方法:class wordpress_xmlrpc.methods.posts.NewPost(content)
创建一篇新文章。需要用到WordPressPost实例的至少两个参数:title和content。示例如下:
# NewPost()方法,新建一篇文章
newpost = WordPressPost() # 创建一个类实例,注意,它不是一个函数。只要在一个类名后面加上括号就是一个实例
newpost.title = '东尧的第二篇文章标题'
newpost.content = '东尧第二篇测试文章正文'
print(client.call(posts.NewPost(newpost))) #发布新建的文章,返回的是文章id
到WordPress后台查看发布结果,我们发现NewPost()方法将文章发布到了后台保存的是草稿,这是因为发布状态默认选择的是草稿。如果需要更改发布状态,可以通过修改WordPressPost()实例post_status属性的值:
publish:已发布
pending:等待复审
draft:草稿
# NewPost()方法,新建一篇文章
newpost = WordPressPost()
newpost.title = '东尧的第三篇文章标题'
newpost.content = '东尧第三篇测试文章正文'
# 设置发布状态
newpost.post_status = 'publish'
# 发布新建的文章,返回的是文章id
print(client.call(posts.NewPost(newpost))) # 结果:27
这个时候我们又发现,所有的文章都是发布到默认的“未分类”目录下:
那我们想将发布到指定目录下该如何操作呢?WordPressPost类有一个属性是terms_names ,通过设置这里的值(字典格式:{‘category’: [‘栏目名 1’,‘栏目名 2’,‘栏目名 3’]……})来指定栏目目录,因为一篇文章可以属于多个栏目,所以字典的值是一个列表,里面包含了所选栏目。示例:
# NewPost()方法,新建一篇文章
newpost = WordPressPost()
newpost.title = '东尧的第四篇文章标题'
newpost.content = '东尧第四篇测试文章正文'
# 设置发布状态
newpost.post_status = 'publish'
# 设置发布目录(一篇文章可以属于多个分类目录)
newpost.terms_names = {
'category':['散文','诗歌'], # 目录
}
# 发布新建的文章,返回的是文章id
print(client.call(posts.NewPost(newpost)))
另外,WordPressPost类的terms_names 属性不仅可以指定栏目目录,还可以指定文章标签,在字典内新增标签的键值对就好了(字典格式:{‘post_tag’: [‘tag名 1’,‘tag名 2’,‘tag名 3’]……}),多个标签用英文逗号分隔:
# NewPost()方法,新建一篇文章
newpost = WordPressPost()
newpost.title = '东尧的第五篇文章标题'
newpost.content = '东尧第五篇测试文章正文'
# 设置发布状态
newpost.post_status = 'publish'
# 设置发布目录(一篇文章可以属于多个分类目录、多个标签)
newpost.terms_names = {
'category':['散文','诗歌'],# 目录
'post_tag':['唯美散文','爱情散文']# 标签
}
# 发布新建的文章,返回的是文章id
print(client.call(posts.NewPost(newpost)))
WordPress发文部分的内容我们就讲到这里,明天的教程将对WordPress栏目设置。结合我们之前的采集教程,大家可以自己设计个采集+发布的python自动发文程序试试哦。