WordPress 集成今日诗词古诗词名句 API 功能

2021-11-24 15:40 118 22 条评论 龙笑天下

WordPress 集成今日诗词古诗词名句 API 功能

很久之前龙笑天写过一篇类似的文章,如下,主要是集成的一言经典语句功能,有需要的盆友可以前往瞅瞅。

Wordpress 集成一言(Hitokoto)API 经典语句功能-BG
Wordpress 集成一言(Hitokoto)API 经典语句功能

Wordpress 集成一言(Hitokoto)API 经典语句功能

很早前就在很多博客网站看到了这个每日一句、随机语录等经典语句功能,其实我是非常想要加上这个功能的(功能控~~),但出于以下的考虑,就一直没开启集成工作: 增加这个功能,就意味着要一直请求一言...

今天有细心的盆友发现了龙笑天下评论框里的一个小细节,没错,本站评论框里会随机出现一个跟浏览者当前环境相关性很不错的古诗词名句。这个主要是本站Dragon 主题集成了今日诗词的古诗词名句 API 功能,使用Dragon主题的盆友可以前往“主题设置-常用功能-评论相关”里找到“评论框显示一言”去开启即可,在此,非常感谢 @今日诗词 提供了这个非常优质的古诗词名句 API 接口。

今日诗词

今日诗词 API 是一个可以返回一句古诗词名句的接口。它可以通过图片和 JSON 格式调用。今日诗词 API 根据不同地点、时间、节日、季节、天气、景观、城市进行智能推荐。

通过上面介绍,对今日诗词 API 感兴趣的盆友可以看下面的方法,去按需集成到自己的主题哈。

简单使用方法

在 HTML 中需要加载诗词的地方放置以下加载代码即可,和 网站统计 的安装方法一致。

<span id="jinrishici-sentence">正在加载今日诗词....</span>
<script src="https://sdk.jinrishici.com/v2/browser/jinrishici.js" charset="utf-8"></script>

高级使用方法

如果你也想要本站这种将古诗词放在评论框里的话,将下面代码放至主题的 functions.php 文件里即可完事。

/**
 * WordPress 集成今日诗词古诗词名句 API 功能 - 龙笑天下
 * https://www.ilxtx.com/integrating-jinrishici-api-to-wordpress.html
 * @date  2021.12.07 12:36
 */
function dr_show_jinrishici(){
	if( is_single() || is_page() ){
    	echo '<script src="https://sdk.jinrishici.com/v2/browser/jinrishici.js" charset="utf-8"></script> <script type="text/javascript"> jinrishici.load(function(result) { var id = "comment", c = result.data.content+" ---- "+result.data.origin.dynasty+"·"+result.data.origin.author+"《"+result.data.origin.title+"》"; if (document.getElementById(id)){ document.getElementById(id).placeholder=c; } }); </script>';
	}
}
add_action( 'wp_footer', 'dr_show_jinrishici' );

注意:上面代码里的comment记得改为你自己评论框的 id 哦,wp 一般来说不用改上面代码,直接用就行。

今日诗词 API 的回调里的返回的 result 结果格式详见如下,会代码的盆友可以按需修改。当然,更多的高级用法,详见下面的今日诗词官方 API 文档哈。

{
    "status": "success",
    "data": {
        "id": "5b8b9572e116fb3714e6faba",
        "content": "君问归期未有期,巴山夜雨涨秋池。",
        "popularity": 1170000,
        "origin": {
            "title": "夜雨寄北",
            "dynasty": "唐代",
            "author": "李商隐",
            "content": [
                "君问归期未有期,巴山夜雨涨秋池。",
                "何当共剪西窗烛,却话巴山夜雨时。"
            ],
            "translate": [
                "您问归期,归期实难说准,巴山连夜暴雨,涨满秋池。",
                "何时归去,共剪西窗烛花,当面诉说,巴山夜雨况味。"
            ]
        },
        "matchTags": [
            "秋",
            "晚上"
        ],
        "recommendedReason": "",
        "cacheAt": "2018-09-17T21:18:44.693645"
    },
    "token": "6453911a-9ad7-457e-9b9d-c21011b85a0c",
    "ipAddress": "162.248.93.154"
}

相关参考

今日诗词开放接口
本文贴图出自知乎

「点点赞赏,手留余香」

还没有人赞赏,快来当第一个赞赏的人吧!

本文为原创文章,版权归所有,欢迎分享本文,转载请保留出处!

2021-11-21

2021-11-30

发表评论

评论
正在努力加载中...
扫一扫二维码分享