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

今天发现了龙笑天下博客评论框里会随机出现一个跟浏览者当前环境相关性很不错的古诗词名句。

通过上面介绍，对今日诗词 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 功能 - 龙笑天下
 */
function dr_show_jinrishici(){
    if( is_single() || is_page() ){
        echo '<script src="https://sdk.jinrishici.com/v2/browser/jinrishici.js" charset="utf-8"></script>';
        echo '<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"
}