[WordPress]为你的WordPress博客添加一言展示

一言

一言介绍：

简单来说，一言（ヒトコト）指的是就是一句话，可以是动漫中的台词，可以是小说中的语句，也可以是网络上的各种小段子。

或是感动，或是开心，又或是单纯的回忆，来到这里，留下你所喜欢的那一句句话，与大家分享，这就是一言存在的目的。

我也是在逛别人博客的时候偶然间发现的一言，你可以用一言来记录一些自己喜欢的句子，再用它提供的API把自己的记录分享出来，感觉很不错呢。

下面就教教大家怎么把一言添加到自己的博客里吧！

添加方法

注意：方法只以我自己的博客添加方法来说明，如果你有更多要求请看官方API的说明：http://hitokoto.us/api.html

首先我们要注意一下几个主要的请求参数（省略对encode参数的说明，有需要的点上面的网址）：

cat：返回指定分类的一句话，如果为空则返回任意分类的一言。若请求参数包含uid，则cat对应cid

charset：字符集，支持gbk/utf-8，默认为utf-8

length：返回一句话的长度限制，超出则打断并添加省略号

uid：获取“我的一言”

mix：同时在系统收录的“一言”和获取“我的一言”中随机，若需指定用户分类请使用ucat参数

ucat：配合mix参数使用，用于指定用户分类CID

然后我们来说下对一言的具体展示设置，主要是对最后添加的代码里网址的设置，这里需要用到上面的参数。

请求网址：http://api.hitokoto.us/rand

SSL：https://api.hitokoto.us:214/rand

加上一些参数后，就能展示出不同的一言了。比如你可以这样：http://api.hitokoto.us/rand?cat=a&charset=utf-8或者https://api.hitokoto.us:214/rand?cat=a&charset=utf-8（意思是随机展示审核过的投稿里a分类的一言记录，字符编码为UTF-8，网址对应HTTP和HTTPS的网站）

官方投稿分类说明（cat参数具体设置）：

a：Anime - 动画

b：Comic - 漫画

c：Game - 游戏

d：Novel - 小说

e：原创

f：来自网络

g：其他

如果你和我一样是准备展示自己收藏的一言，那么你可以这样写：http://api.hitokoto.us/rand?uid=XXXX或者https://api.hitokoto.us:214/rand?uid=XXXX（对应HTTP和HTTPS网站）

这里的UID请点击“我的一言”，在最后的API相关里有写。更具体一点的，你是想展示自己收藏的一言里某个分类的记录，请结合上面的例子将cat=a换成cat=CID（CID为你自己分类目录的CID）。

上面说的，主要是搞定了自定义需要展示的一言的问题，现在再说怎么添加到博客吧！

以下方法来自官方说明，部分修改：

1. 将下面这段代码放入HTML页面的head标签内（放入博客的header.php里）

上面的网址请根据前面的说明写你自定义的。

2. 将下面这段代码放入页面内需要展示一句话的位置即可

该脚本实质为document.write的脚本。

当然如果你和我一样只是想放到右侧边栏里，可以直接复制下面的代码，新建一个文本小工具放进去就可以了，效果嘛看我博客的右边栏。

代码：

注意替换网址哦！

最后再贴一下官方的API说明：http://hitokoto.us/api.html

里面有更加详细的说明以及更多的用法。