Waline

Mr.Hope ... 2021-5-16 大约 3 分钟

欢迎使用 Waline,只需几个步骤,你就可以在你的网站中启用 Waline 提供评论与浏览量服务。

# LeanCloud 设置 (数据库)

  1. 登录 (opens new window)注册 (opens new window) LeanCloud 国际版 并进入 控制台 (opens new window)

  2. 点击左下角 创建应用 (opens new window) 并起一个你喜欢的名字 (请选择免费的开发版):

    创建应用

  3. 进入应用,选择左下角的 设置 > 应用 Key。你可以看到你的 APP ID,APP KeyMaster Key。后续我们会用到这三个值。

    ID 和 Key

注意

如果你正在使用 Leancloud 国内版 (leancloud.cn (opens new window)),我们推荐你切换到国际版 (leancloud.app (opens new window))。否则,你需要为应用额外绑定已备案的域名:

  • 登录国内版并进入需要使用的应用
  • 选择 设置 > 域名绑定 > API 访问域名 > 绑定新域名 > 输入域名 > 确定
  • 按照页面上的提示按要求在 DNS 上完成 CNAME 解析。

域名设置

# Vercel 部署 (服务端)

Vercel (opens new window)

  1. 点击上方按钮,跳转至 Vercel 进行 Server 端部署。

  2. 如果你未登录的话,Vercel 会让你注册或登录,请使用 GitHub 账户进行快捷登录。

  3. 输入一个你喜欢的 Vercel 项目名称并点击 Continue 继续:

    创建项目

  4. 输入你想要设置的 GitHub 仓库名称并点击 Continue 继续。

    此时 Vercel 会基于 Waline 模板帮助你新建并初始化该仓库。

    创建仓库

  5. 在仓库初始化完毕后,请进入 Environment Variables 中配置三个环境变量 LEAN_ID, LEAN_KEYLEAN_MASTER_KEY 。它们的值分别对应上一步在 LeanCloud 中获得的 APP ID, APP KEY, Master Key

    设置环境变量

    提示

    如果你使用 LeanCloud 国内版,请额外配置 LEAN_SERVER 环境变量,值为你绑定好的域名。

  6. 点击 Deploy 部署。一两分钟后,满屏的烟花会庆祝你部署成功。此时请点击 Visit ,即可跳转到部署好的网站地址,此地址即为你的服务端地址。

    部署成功

# 客户端

# 使用插件

在插件选项中设置 type: 'waline',同时设置服务端地址 serverURL 为上一步获取到的值。

此时,将 <Comment> 组件放置在你网站中合适的位置 (通常是页面的底部),即可使用 Waline 评论功能。

# 使用主题

themeConfig.comment 中设置 type: 'waline',同时设置服务端地址 serverURL 为上一步获取到的值。

此时 Waline 就会在你的站点上成功运行。 🎉

提示

你也可以传入其他 Waline 支持的选项 (除了 el)。

详情请见 Waline 配置

# 评论管理 (管理端)

  1. 部署完成后,请访问 <serverURL>/ui/register 进行注册。首个注册的人会被设定成管理员。
  2. 管理员登陆后,即可看到评论管理界面。在这里可以修改、标记或删除评论。
  3. 用户也通过评论框注册账号,登陆后会跳转到自己的档案页。