WordPress 集成一言(Hitokoto)API 经典语句功能
首页>>技术教程>>正文
本篇文章更新于 2021-08-03 11:45:13
本篇文章更新于 2021-08-03
WordPress 集成一言(Hitokoto)API 经典语句功能

很多博客网站看到了这个每日一句、随机语录等经典语句功能,其实我是非常想要加上这个功能的(功能控~~)

  • 增加这个功能,就意味着要一直请求一言,这个就可能会影响网站的加载速度及性能了;另外,大家也都能感觉到很多网站都由于各种原因,要么不稳定,要么就干脆弃站了...
  • 在我这主题,找不到满意的位置放置这这句话~(毕竟拙于设计...)

一言网(Hitokoto.cn)创立于 2016 年,隶属于萌创 Team,目前网站主要提供一句话服务。

动漫也好、小说也好、网络也好,不论在哪里,我们总会看到有那么一两个句子能穿透你的心。我们把这些句子汇聚起来,形成一言网络,以传递更多的感动。如果可以,我们希望我们没有停止服务的那一天。

简单来说,一言指的就是一句话,可以是动漫中的台词,也可以是网络上的各种小段子。
或是感动,或是开心,有或是单纯的回忆。来到这里,留下你所喜欢的那一句句话,与大家分享,这就是一言存在的目的。

下面介绍怎么在主题任意地方添加一言功能:

一【LWL12 的一言纯净版】:

在这里,先介绍一下 LWL12 的这个非常纯净的第三方 API 版本,仅显示一句话内容...,速度给力,食用方法也真的是简单粗暴~

直接将下面的代码放在自己主题想加载的位置就可以完事了...

<script type="text/javascript" src="https://api.lwl12.com/hitokoto/main/get?encode=js&charset=utf-8"></script><div id="lwlhitokoto"><script>lwlhitokoto()</script></div>

二【自建 API 版本】:

自建版的好处就是,api 及经典语句内容完全由自己管控;当然,缺点也很明显了,木有一言的语句多~~

2.1 创建 API

好了,直接开动了,首先,新建一个 index.php 文件,文件内容如下:

<?php
/**
 * WordPress 集成一言(Hitokoto)API 经典语句功能 - 龙笑天下
 * https://www.ilxtx.com/integrating-yiyan-hitokoto-to-wordpress.html
 */
// 获取句子文件的绝对路径
// 如果你介意别人可能会拖走这个文本,可以把文件名自定义一下,或者通过 Nginx 禁止拉取也行。
$path = dirname(__FILE__);
$file = file($path."/hitokoto.txt");
# 随机读取一行
$arr  = mt_rand( 0, count( $file ) - 1 );
$content  = trim($file[$arr]);
# 编码判断,用于输出相应的响应头部编码
if (isset($_GET['charset']) && !empty($_GET['charset'])) {
    $charset = $_GET['charset'];
    if (strcasecmp($charset,"gbk") == 0 ) {
        $content = mb_convert_encoding($content,'gbk', 'utf-8');
    }
} else {
    $charset = 'utf-8';
}
header("Content-Type: text/html; charset=$charset");
# 格式化判断,输出 js 或纯文本
if ($_GET['format'] === 'js') {
    echo "function hitokoto(){document.write('" . $content ."');}";
} else {
    echo $content;
}

然后新建一个名为 hitokoto.txt 的文本文档(在里面每行存入一句经典语句哦~),将 hitokoto.txt 文本文档与上面的 index.php 文件同时放入网站根目录下名为 hitokoto 的文件夹中,当然这里文本文档及文件夹的名称可以更改为其他任意名字,但是要将代码中对应调用部分也做更改。

现在,浏览器访问http://你的域名/hitokoto/就可以看到输出内容了。

2.2 使用 API

部署方法和上面那个基本一样:在主题代码中你需要显示语录文字的地方添加上如下代码既可以实现对 hitokoto.txt 中文字语录的调用。

<script type="text/javascript" src="https://你的域名/hitokoto/?format=js&charset=utf-8"></script><div id="hitokoto"><script>hitokoto()</script></div>

不过,输出的样式也和上面版本一样可能会比较丑,如果你懂 CSS 的话可以自己再美化美化。

三【一言官方 API 版】

在这里,再来教大家一个使用一言官方 API 的方法~

小版本1---首先,在主题 functions.php 中加入以下代码:

/**
 * WordPress 集成一言(Hitokoto)API 经典语句功能 - 龙笑天下
 * https://www.ilxtx.com/integrating-yiyan-hitokoto-to-wordpress.html
 * 最后更新:2018-5-2 22:48:09(一言已不支持 POST 获取,故改为 GET 方法获取,2018.8 会切换为 https://v2.hitokoto.cn/)
 */
function LxtxgetHitokoto(){
    $url = 'https://v1.hitokoto.cn/?encode=json'; // 不限定内容类型
    // $url = https://v1.hitokoto.cn/?encode=json&c=d'; // 限定内容类型
    $ch = curl_init();  
    curl_setopt($ch, CURLOPT_SSL_VERIFYPEER, false); // 跳过证书检查
    curl_setopt($ch, CURLOPT_SSL_VERIFYHOST, 2); // 从证书中检查 SSL 加密算法是否存在
    curl_setopt($ch, CURLOPT_URL, $url);
    curl_setopt($ch, CURLOPT_CUSTOMREQUEST, 'GET');
    curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
    curl_setopt($ch, CURLOPT_TIMEOUT, 6);
    $response = curl_exec($ch);  
    if($error=curl_error($ch)){  
        return '欢迎来到龙笑天下~'; // 如果 6s 内,一言 API 调用失败则输出这个默认句子~
    }  
    curl_close($ch);
    $array_data = json_decode($response,true);
    $lxtx_content = $array_data['hitokoto'].'----《'.$array_data['from'].'》'; // 输出格式:经典语句----《语句出处》
    return $lxtx_content;
}

使用方法也非常简单粗暴,在主题文件中想输出橘子的地方加入以下输出代码即可,当然,你也可以跟龙笑天下一样放在文章的评论框哦~:

<?php echo LxtxgetHitokoto(); ?>

小版本2:

/**
 * WordPress B2Pro主题集成一言(Hitokoto)API 经典语句功能 - 鸸鹋产业网
 */
function GetHitokoto(){
    $url = 'https://v1.hitokoto.cn/?encode=json'; // 不限定内容类型
    // $url = https://v1.hitokoto.cn/?encode=json&c=d'; // 限定内容类型
    $ch = curl_init();  
    curl_setopt($ch, CURLOPT_SSL_VERIFYPEER, false); // 跳过证书检查
    curl_setopt($ch, CURLOPT_SSL_VERIFYHOST, 2); // 从证书中检查 SSL 加密算法是否存在
    curl_setopt($ch, CURLOPT_URL, $url);
    curl_setopt($ch, CURLOPT_CUSTOMREQUEST, 'GET');
    curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
    curl_setopt($ch, CURLOPT_TIMEOUT, 6);
    $response = curl_exec($ch);  
    if($error=curl_error($ch)){  
        return '欢迎来到B2主题的一言功能~'; // 如果 6s 内,一言 API 调用失败则输出这个默认句子~
    }  
    curl_close($ch);
    $array_data = json_decode($response,true);
    $Emu_content = $array_data['hitokoto'].'----《'.$array_data['from'].'》'; // 输出格式:经典语句----《语句出处》
    return $Emu_content;
}

在需要调用的地方添加:

<?php echo GetHitokoto(); ?>

另外,再附上一言 API的返回参数:

返回参数名称 描述

id:本条一言的 id。可以链接到 https://hitokoto.cn?id=[id]查看这个一言的完整信息。

hitokoto:一言正文。编码方式 usc2。使用 utf-8。

type:类型,跟请求参数相同。a: Anime - 动画;b: Comic – 漫画;c: Game – 游戏;d: Novel – 小说;e: Myself – 原创;f: Internet – 来自网络;g: Other – 其他

from:一言的出处。

creator:添加者。

cearted_at:添加时间。

友情提示:大家可以根据返回参数自行修改上面的LxtxgetHitokoto()函数中的第 22 行,随意修改为自己想要的格式哦;另外,本文教程不局限与 wordpress~~

历史上的今天

很遗憾~,历史上的今天未发表过文章
技术教程

教你如何配置B2的暗黑模式

2021-7-28 13:09:41

技术教程

wp文章自动外链go跳转避免权重丢失

2021-8-6 16:52:53

重要说明

本站资源大多来自网络,如有侵犯你的权益请联系管理员或给邮箱发送邮件zhouqiuqiu123@foxmail.com 我们会第一时间进行审核删除。站内资源为网友个人学习或测试研究使用,未经原版权作者许可,禁止用于任何商业途径!请在下载24小时内删除!


如果遇到评论下载的文章,评论后刷新页面点击对应的蓝字按钮即可跳转到下载页面本站资源少部分采用7z压缩,为防止有人压缩软件不支持7z格式,7z解压,建议下载7-zip(点击下载),zip、rar解压,建议下载WinRAR(点击下载)

敏而好学,不耻下问。——孔子