Disqus PHP API

利用 PHP cURL 转发 Disqus API 请求

Disqus 被墙，故做几个简单的接口，用于墙内环境访问 Disqus。

实现功能

评论列表 评论发表 图片上传 Emoji 表情 Gravatar 头像 邮件通知 ……

注：由于 GDPR，Disqus 目前屏蔽了 Email 及 IP 的获取，因此 Gravatar 头像及匿名评论的邮件通知暂无法完美实现。目前暂存匿名评论者邮箱号，以发回复邮件通知显示 Gravatar 头像。

Disqus 设置

使用 API 实现匿名评论功能，需在 Disqus 后台网站设置，设置相关选项。

开启匿名评论，Guest Commenting 项中勾选 Allow guests to comment。 若需评论免审，Pre-moderation 项选中 None。

后端

需要部署在境外服务器。 依赖于 PHP 5.6+，采用 PHP cURL 请求 Disqus API，以获取评论数据，发送访客评论等操作。 配置文件为 config.php，有简单说明。

重要

必须在 Disqus API 申请注册一个 App，取得相关的公钥（API Key）、私钥（API Secret），并填写于后端的配置文件 config.php 中。

App 设置方面，回调链接请填写 login.php 文件的绝对地址，主要的设置如下图，可根据自己情况填写。

邮件发送

简易评论框及 Disqus 评论框皆可实现，规则如下：

匿名者的回复提醒邮件（只有邮箱号存在才会发送） 管理员的留言提醒邮件（只有设置未勾选站点邮件提醒时发送，管理员回复不发提醒）

前端

DEMO: http://blog.fooleap.org/disqus-php-api.html

项目将 Disqus 原生评论框加载代码打包在内，若使用本评论框，需将网页上所有与 Disqus 相关的元素清除，例如 id 为 disqus_thread 的容器、disqus_config 函数等。

Disqus 评论框的相关配置disqus_config：

this.page.identifier: identifier，若无设置则为 url this.page.title: title this.page.url: site + url

关于 Disqus 原生评论框配置的说明，可以看此页面：https://help.disqus.com/customer/portal/articles/472098-javascript-configuration-variables

引入 CSS

<link rel="stylesheet" href="path/to/iDisqus.min.css" />

创建容器

<div id="comment"></div>

引入 JS

<script src="path/to/iDisqus.min.js"></script>

创建实例

var disq = new iDisqus('comment', { forum: 'ifool', api: 'http://api.fooleap.org/disqus', site: 'http://blog.fooleap.org', mode: 1, timeout: 3000, init: true });

配置参数

ID

new iDisqus(ID, OPTIONS); DOM 节点的 id 属性 {String} 默认："comment"

OPTIONS

new iDisqus(ID, OPTIONS); {Object}

api

API 地址，PHP 代码部署的网址如：http://api.fooleap.org/disqus {String} 必填，无默认值

forum

Disqus forum 的 shortname {String} 必填，无默认值

site

网站域名，建议填写，如：http://blog.fooleap.org {String} 默认：location.origin

url

页面链接，按需填写 {String} 默认：location.pathname + location.search

identifier

页面标识，按需填写 {String} 默认：url

title

页面标题 {String} 默认：document.title

mode

1 检测能否访问 Disqus，若能则加载 Disqus 原生评论框，超时则加载简易评论框 2 仅加载简易评论框 3 同时加载两种评论框，先显示简易评论框，Disqus 加载完成则切换至 Disqus 评论框 {Number} 默认：1

timeout

当 mode 为 1 时的超时时间 {Number} 默认：3000

toggle

当 mode 为 3 时可用，作用是切换评论框 具体用法是在网页中放置一个 Checkbox，如 <input type="checkbox" id="comment-toggle" disabled />，此项则设置为 "comment-toggle"，当 Disqus 加载完时，选择框可用。 {String} 无默认值

init

是否自动初始化 {Boolean} 默认：false

autoCreate

是否自动创建 Thread，为了不创建垃圾 Thread，并不推荐设置为 true {Boolean} 默认：false

emojiPath

Emoji 表情 PNG 图片路径 {String} 默认："https://github.githubassets.com/images/icons/emoji/unicode/"

emojiList

自定义评论框内的点选 Emoji 表情，具体可看 DEMO 页面 {Object}

emojiPreview

评论预览是否支持 Emoji 短代码 {Boolean} 默认：false

relatedType

相关文章类型，可选相关文章或热门文章 {String} 默认：Related，可选Popular

实例方法

init

初始化评论框

destroy

销毁评论框

count

加载评论数 用法：创建容器（可多个），加属性 data-disqus-url 值放页面链接，创建实例后执行则可显示评论数，具体可查看DEMO 页面

postsList

加载最近评论 用法：创建容器，指定Id（默认 disqusPostsList），创建实例后执行可显示最近评论，可通过指定参数设置加载评论数量（默认为 5）以及容器Id