Valine Admin后台搭建(最新修订版)

Caleb ... 2020-06-19
  • VuePress
  • Valine
大约 8 分钟

提示

Valine Admin 是 Valine 评论系统的扩展和增强,主要实现评论邮件通知、评论管理、垃圾评论过滤等功能。支持完全自定义的邮件通知模板,基于 Akismet API 实现准确的垃圾评论过滤。
开发者@Deserts (opens new window)

# 云引擎"一键"部署

# 1. 填写代码库

#Leancloud (opens new window)云引擎-->部署界面,填写我根据作者改写的代码库并保存:https://github.com/ComicAuthor/Valine-Admin.git (opens new window)

提示

# 修改版简单介绍

修改版保留了原版的所有功能,原汁原味,请放心食用。

# version 1.0.2

1.增加了 QQ 提醒功能(Qmsg 酱)
2.增加了微信提醒功能(Server 酱)

# version 1.0.1

1.增加了用户头像的判断 QQ 头像以及 gravatar 头像
2.增加了分页插件
3.增加了博主/全部列表的展示
4.增加了返回顶部按钮

填写代码库.png 填写代码库.png

# 2.在设置页面,设置环境变量以及 Web 二级域名。

设置环境变量.png

具体格式如下:常规版本只需要配置这些

变量 示例 说明
SITE_NAME 平凡的你我 [必填]博客名称
SITE_URL https://reinness.com (opens new window) [必填]首页地址
SMTP_SERVICE "163" [新版支持]邮件服务提供商,支持 QQ、163、126、Gmail 以及 更多 (opens new window)
SMTP_USER xxxxx@163.com [必填]SMTP 登录用户
SMTP_PASS XXXXXXXX [必填]SMTP 登录密码(QQ 邮箱需要获取独立密码)
SENDER_NAME caleb [必填]发件人
SENDER_EMAIL xxxxx@163.com [必填]发件邮箱
BLOGGER_EMAIL xxxxx@163.com [可选]如果自己在回复,设置这个可以不向自己的邮箱发送邮件 && 博主通知收件地址,默认使用 SENDER_EMAIL
ADMIN_URL https://xxx.leanapp.cn/ [建议]Web 主机二级域名,用于自动唤醒
AKISMET_KEY xxxxxxxxxxxx [可选]Akismet Key 用于垃圾评论检测,设为 MANUAL_REVIEW 开启人工审核,留空不使用反垃圾

使用修改版本还需要这些变量:[查看修改版相关教程]

变量 示例 说明
QMSG_KEY Qmsg酱官网申请 教程 [必填]QQ 消息提示的 APPKey
QMSG_TEMPLATE [查看教程] [选填]发送 QQ 消息模板
QQ_SHAKE true / false [选填]是否使用 QQ 戳一戳
SC_KEY Server酱官网申请 教程 [必填]微信消息提示的 SCKEY
SC_TEXT_TEMPLATE [查看教程] [选填]Server 酱发送消息的标题模板
SC_DESP_TEMPLATE [查看教程] [选填]Server 酱发送消息的内容模板

以上必填参数请务必正确设置。

# 3.切换到部署标签页,分支使用 master,点击部署即可

部署.png 第一次部署可能会需要些时间。

部署日志.png

# 4.评论管理

# 访问设置的二级域名https://二级域名.leanapp.cn/sign-up ,注册管理员登录信息,如:https://nk6vtvs0tdwc.leanapp.cn/sign-up (opens new window)

按照 LeanCould 下发的通知,华北和华东地区不再提供共享的域名。所以华北、华东的用户需要自行绑定域名(需要已经备案过的域名)。如果没有自己的域名呢,也可以直接使用国际版,但是只会提供三个月的有效时间。过后还是得自行绑定域名。

详情参考 LeanCloud Blog | 域名绑定 Q&A (opens new window)

国际版域名配置,输入你想自定义的名称即可。

域名配置.png

注意

注:使用原版 Valine 如果遇到注册页面不显示直接跳转至登录页的情况,请手动删除_User 表中的全部数据。

如果发现页面并没有跳转,请在域名后加上 /sign-up

注册页.png

# 5.定时任务设置

目前实现了两种云函数定时任务:

提示

(1)自动唤醒,定时访问 Web APP 二级域名防止云引擎休眠;

(2)每天定时检查 24 小时内漏发的邮件通知。

进入云引擎-定时任务中,创建定时器,创建两个定时任务。

(1)选择 self-wake 云函数,Cron 表达式为0 0/30 7-23 * * ?,表示每天早 6 点到晚 23 点每隔 30 分钟访问云引擎,ADMIN_URL 环境变量务必设置正确:

self-wake云函数.png

(2)选择 resend-mails 云函数,Cron 表达式为0 0 8 * * ?,表示每天早 8 点检查过去 24 小时内漏发的通知邮件并补发:

resend-mails云函数.png

添加定时器后记得点击启动方可生效。

至此,Valine Admin 已经可以正常工作。

# 邮件通知模板

# 1.环境变量设定

邮件通知模板在云引擎环境变量中设定,可自定义通知邮件标题及内容模板。

环境变量 示例 说明
MAIL_SUBJECT PARENTNICK,您在{PARENT_NICK},您在{SITE_NAME}上的评论收到了回复 [可选]@通知邮件主题(标题)模板
MAIL_TEMPLATE 见下文 [可选]@通知邮件内容模板
MAIL_SUBJECT_ADMIN ${SITE_NAME}上有新评论了 [可选]博主邮件通知主题模板
MAIL_TEMPLATE_ADMIN 见下文 [可选]博主邮件通知内容模板

# 2.自定义模板

邮件通知包含两种,分别是 被@通知博主通知,这两种模板都可以完全自定义。默认使用经典的蓝色风格模板。

@通知模板中的可用变量如下(注,这是邮件模板变量,是指嵌入到 HTML 邮件模板中的变量,请勿与云引擎环境变量混淆)

模板变量 说明
SITE_NAME 博客名称
SITE_URL 博客首页地址
POST_URL 文章地址(完整路径)
PARENT_NICK 收件人昵称(被@者,父级评论人)
PARENT_COMMENT 父级评论内容
NICK 新评论者昵称
COMMENT 新评论内容

(1)默认被@通知邮件内容模板如下:

<div
  style="border-top:2px solid #12ADDB;box-shadow:0 1px 3px #AAAAAA;line-height:180%;padding:0 15px 12px;margin:50px auto;font-size:12px;"
>
  <h2
    style="border-bottom:1px solid #DDD;font-size:14px;font-weight:normal;padding:13px 0 10px 8px;"
  >
    您在<a
      style="text-decoration:none;color: #12ADDB;"
      href="${SITE_URL}"
      target="_blank"
    >
      ${SITE_NAME}</a
    >上的评论有了新的回复
  </h2>
  ${PARENT_NICK} 同学,您曾发表评论:
  <div style="padding:0 12px 0 12px;margin-top:18px">
    <div
      style="background-color: #f5f5f5;padding: 10px 15px;margin:18px 0;word-wrap:break-word;"
    >
      ${PARENT_COMMENT}
    </div>
    <p><strong>${NICK}</strong>回复说:</p>
    <div
      style="background-color: #f5f5f5;padding: 10px 15px;margin:18px 0;word-wrap:break-word;"
    >
      ${COMMENT}
    </div>
    <p>
      您可以点击<a
        style="text-decoration:none; color:#12addb"
        href="${POST_URL}"
        target="_blank"
        >查看回复的完整內容</a
      >,欢迎再次光临<a
        style="text-decoration:none; color:#12addb"
        href="${SITE_URL}"
        target="_blank"
        >${SITE_NAME}</a
      ><br />
    </p>
  </div>
</div>
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42

效果如图: 默认主题.png

(2)彩虹风格的@通知邮件模板代码:

<div
  style="border-top:2px solid #12ADDB;box-shadow:0 1px 3px #AAAAAA;line-height:180%;padding:0 15px 12px;margin:50px auto;font-size:12px;"
>
  <h2
    style="border-bottom:1px solid #DDD;font-size:14px;font-weight:normal;padding:13px 0 10px 8px;"
  >
    您在<a
      style="text-decoration:none;color: #12ADDB;"
      href="${SITE_URL}"
      target="_blank"
    >
      ${SITE_NAME}</a
    >上的评论有了新的回复
  </h2>
  ${PARENT_NICK} 同学,您曾发表评论:
  <div style="padding:0 12px 0 12px;margin-top:18px">
    <div
      style="background-color: #f5f5f5;padding: 10px 15px;margin:18px 0;word-wrap:break-word;"
    >
      ${PARENT_COMMENT}
    </div>
    <p><strong>${NICK}</strong>回复说:</p>
    <div
      style="background-color: #f5f5f5;padding: 10px 15px;margin:18px 0;word-wrap:break-word;"
    >
      ${COMMENT}
    </div>
    <p>
      您可以点击<a
        style="text-decoration:none; color:#12addb"
        href="${POST_URL}"
        target="_blank"
        >查看回复的完整內容</a
      >,欢迎再次光临<a
        style="text-decoration:none; color:#12addb"
        href="${SITE_URL}"
        target="_blank"
        >${SITE_NAME}</a
      ><br />
    </p>
  </div>
</div>
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42

效果如图: 彩虹风格.png

博主通知邮件模板中的可用变量与@通知中的基本一致,PARENT_NICKPARENT_COMMENT 变量不再可用。

(3)默认博主通知邮件内容模板如下:

<div style="border-top:2px solid #12ADDB;box-shadow:0 1px 3px #AAAAAA;line-height:180%;padding:0 15px 12px;margin:50px auto;font-size:12px;"><h2 style="border-bottom:1px solid #DDD;font-size:14px;font-weight:normal;padding:13px 0 10px 8px;">您在<a style="text-decoration:none;color: #12ADDB;" href="${SITE_URL}" target="_blank">${SITE_NAME}</a>上的文章有了新的评论</h2><p><strong>${NICK}</strong>回复说:</p><div style="background-color: #f5f5f5;padding: 10px 15px;margin:18px 0;word-wrap:break-word;"> ${COMMENT}</div><p>您可以点击<a style="text-decoration:none; color:#12addb" href="${POST_URL}" target="_blank">查看回复的完整內容</a><br></p></div></div>
1

因为没使用过这个,所以就没挂图~~~

(4)彩虹风格的博主通知邮件内容模板如下:

<div
  style="border-radius: 10px 10px 10px 10px;font-size:13px;    color: #555555;width: 666px;font-family:'Century Gothic','Trebuchet MS','Hiragino Sans GB',微软雅黑,'Microsoft Yahei',Tahoma,Helvetica,Arial,'SimSun',sans-serif;margin:50px auto;border:1px solid #eee;max-width:100%;background: #ffffff repeating-linear-gradient(-45deg,#fff,#fff 1.125rem,transparent 1.125rem,transparent 2.25rem);box-shadow: 0 1px 5px rgba(0, 0, 0, 0.15);"
>
  <div
    style="width:100%;background:#49BDAD;color:#ffffff;border-radius: 10px 10px 0 0;background-image: -moz-linear-gradient(0deg, rgb(67, 198, 184), rgb(255, 209, 244));background-image: -webkit-linear-gradient(0deg, rgb(67, 198, 184), rgb(255, 209, 244));height: 66px;"
  >
    <p
      style="font-size:15px;word-break:break-all;padding: 23px 32px;margin:0;background-color: hsla(0,0%,100%,.4);border-radius: 10px 10px 0 0;"
    >
      您在<a style="text-decoration:none;color: #ffffff;" href="${SITE_URL}"
        >${SITE_NAME}</a
      >上有新评论啦!
    </p>
  </div>
  <div style="margin:40px auto;width:90%">
    <p>${NICK}给您的回复如下:</p>
    <div
      style="background: #fafafa repeating-linear-gradient(-45deg,#fff,#fff 1.125rem,transparent 1.125rem,transparent 2.25rem);box-shadow: 0 2px 5px rgba(0, 0, 0, 0.15);margin:20px 0px;padding:15px;border-radius:5px;font-size:14px;color:#555555;"
    >
      ${COMMENT}
    </div>
    <p>
      您可以点击<a
        style="text-decoration:none; color:#12addb"
        href="${POST_URL}#comments"
        >查看回复的完整內容</a
      >,欢迎再次光临<a
        style="text-decoration:none; color:#12addb"
        href="${SITE_URL}"
        >${SITE_NAME}</a
      ></p>
    <style type="text/css">
      a:link {
        text-decoration: none;
      }
      a:visited {
        text-decoration: none;
      }
      a:hover {
        text-decoration: none;
      }
      a:active {
        text-decoration: none;
      }
    </style>
  </div>
</div>
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48

效果如图: 彩虹风格.png

以上所有内容供大家参考,如有问题请及时指正,如有侵权,请及时联系删除

# 完结撒花🎉🎉🎉

打赏