第三方服务

帮助我们完善此页面

由于 Hexo 静态站点特殊性，无法原生支持文章评论与数据统计等，这些部署在服务器的动态网站很容易实现的功能，这时一个普遍的解决方案便是借助第三方服务。「Cards」原生支持 9 种评论系统，以及 5 种站点数据统计服务，尽可能帮助每一个用户解决此痛点。如果你认为还有其他优秀、可取的服务我们没有内置，也欢迎新建 issue 或提交 PR。

评论服务

评论系统在主题配置文件 comments 处设置，通过 use 字段选择评论系统。

comments: 
  use:

use：将需要开启的评论系统的名称填入，例如 disqusjs。

除非你有特别考量，不然我们 不建议 同时开启超过 1 个评论服务。

Disqus

https://disqus.com/

「Cards」提供两种使用 Disqus 的方式，分别是常规开启与 DisqusJS。

comments: 
  use: disqus

  disqus: 
    shortname:

如果你决定使用常规模式，只需填写 shortname 即可。如果你还不清楚你的 shortname ，可以登陆评论管理后台查看。

DisqusJS

由于 Disqus 在某些地区访问困难，可以选择使用 DisqusJS 更好地加载 Disqus 评论。

comments: 
  use: disqusjs
    
  disqusjs: 
    shortname: 
    siteName: 
    api: 
    apikey: 
    admin: ''
    adminLabel: 
    nesting: 2

你可以前往 DisqusJS - README 了解相关参数细节。

Valine

https://valine.js.org

Valine，一款基于 LeanCloud 的评论系统。

comments: 
  use: valine 
  
  valine: 
    appId: 
    appKey:
    placeholder: 
    path: 
    avatar: 
    meta: [nick, mail, link]
    pageSize: 
    lang: 
    visitor: 
    highlight: 
    avatarForce: 
    recordIP: 
    serverURLs: 
    enableQQ: 
    requiredFields: [nick, mail]
    emojiCDN: 
    emojiMaps:

你可以阅读 Valine 文档中的快速开始与配置项了解相关参数细节。一般情况下，你只需要一个 LeanCloud 账号即可。

MiniValine

https://github.com/MiniValine/MiniValine

MiniValine，一款基于 LeanCloud 的轻量级评论系统。

comments: 
  use: minivaline
  
  minivaline:  
    appId: 
    appKey: 
    mode: 
    placeholder: 
    pathname: 
    adminEmailMd5: 
    master: 
    friends: 
    tagMeta: 
    math: 
    md: 
    lang: 
    emoticonUrl:
    NoRecordIP: 
    maxNest: 
    pageSize: 
    enableQQ: 
    visitor: 
    serverURLs:

你可以阅读 MiniValine 文档中的 Opinions 了解相关配置项。一般情况下，你只需要一个 LeanCloud 账号即可。

Artalk

https://github.com/qwqcode/Artalk

Artalk，一款简洁有趣的自托管评论系统。

comments: 
  use: artalk
  
  artalk: 
    serverUrl: 
    placeholder: 
    noComment: 
    defaultAvatar: 
    pageKey: 
    gravatar: 
      cdn: 
    readMore: 
      pageSize: 
      autoLoad: 
    emoticons:

你可以阅读 Artalk 文档了解相关配置项。

Gitalk

https://github.com/gitalk/gitalk

comments: 
  use: gitalk
  
  gitalk:
    repo:
    owner:
    clientID:
    clientSecret:

你可以阅读 Gitalk 文档中的 Options 了解相关参数细节。该插件需要使用 GitHub Application，如果还未创建请点击这里申请。

Gitment

https://github.com/imsun/gitment

comments: 
  use: gitment
  
  gitment:
    repo:
    owner:
    client_id:
    client_secret:

你可以阅读 Gitment 文档了解相关参数细节。该插件需要使用 GitHub Application，如果还未创建请点击这里申请。

来必力

https://livere.com/

comments: 
  use: levere
  
  livere: 
    livere_uid:

「Cards」内置了 ciry_version 版本的来必力，该版本是免费的。你可以在 Livere 管理后台获取 UID。

畅言

http://changyan.kuaizhan.com/

comments: 
  use: changyan
  
  changyan: 
    appid:
    conf:
    thread_key_type: path

你可以在畅言后台安装方式找到你的 appid 与 conf。而 thread_key_type 为页面区分参数，默认使用页面路径区分。如果你经常更改链接，也可以在每篇文章的 front-matter 中自定义一个参数来区分，例如：

// front-matter of each post
---
cy: [ unique id ]
---

// theme config
changyan:
  enable: true
  appid:
  conf:
  thread_key_type: cy

Wildfire

https://wildfire.js.org/

comments: 
  use: wildfire
    
  wildfire: 
    database_provider: firebase # firebase | wilddog
    wilddog_site_id:
    firebase_api_key:
    firebase_auth_domain:
    firebase_database_url:
    firebase_project_id:
    firebase_storage_bucket:
    firebase_messaging_sender_id:
    theme: light # light | dark
    locale: en

你可以阅读官方文档了解参数细节及如何使用。

Twikoo

https://twikoo.js.org/

Twikoo，一款基于腾讯云 CloudBase 的评论系统。

comments:
  use: twikoo
  
  twikoo:
    envId:  # 你的 CloudBase 环境 ID

你可以阅读 Twikoo 文档快速上手部分了解如何配置 Cloudbase 云函数。一般情况下，你只需要一个 CloudBase 免费应用即可。

数据统计服务

Google Analytics

https://analytics.google.com/

analytics: 
  google_site_id: 
  gtags_site_id:

登陆 Google Analytics 后，前往「设置 - 跟踪信息 - 跟踪代码」处获取 跟踪 ID。Google 提供两种跟踪方式，分别 google_site_id 传统跟踪，或 gtags_site_id 新统计方式。后者需要请求更大的文件，可能会对页面加载有一定影响。

百度统计

http://tongji.baidu.com

登陆百度统计后台，在获取跟踪代码处得到你的跟踪 ID。

  | <script>
  |     var _hmt = _hmt || [];
  |     (function() {var hm = document.createElement('script');
=>|     hm.src = 'https://hm.baidu.com/hm.js?[跟踪 ID]';
  |     var s = document.getElementsByTagName('script')[0];
  |         s.parentNode.insertBefore(hm, s);
  |     })();
  | </script>

然后将该 ID 设置到 baidu_site_id 中。

analytics: 
  ...
  baidu_site_id:

CNZZ

https://web.umeng.com

CNZZ 已被友盟收购，登陆后台找到代码安装页面。

<script src="//s95.cnzz.com/z_stat.php?id=[ 跟踪 ID ]&web_id=[ 跟踪 ID ]" language="JavaScript"></script>

将该 ID 设置到 cnzz_site_id 中。

analytics: 
  
  cnzz_site_id:

Cloudflare Web Analytics

https://support.cloudflare.com/hc/en-us/articles/360052685432-Cloudflare-Web-Analytics

Cloudflare Web Analytics，Cloudflare 提供的免费、隐私优先的统计服务（无需替换 Cloudflare DNS 解析或接入 Cloudflare CDN）。

analytics: 
  
  cloudflare_site_id:

在提示你插入的 JS 片段中找到 token，那便是你的 cloudflare_site_id。