Valine Admin 是 Valine 評論系統(tǒng)的擴展和增強,主要實現(xiàn)評論郵件通知、評論管理、垃圾評論過濾等功能。支持完全自定義的郵件通知模板,基于Akismet API實現(xiàn)準(zhǔn)確的垃圾評論過濾。
開發(fā)者@Deserts
云引擎"一鍵"部署
1. 填寫代碼庫
在Leancloud云引擎設(shè)置界面,填寫代碼庫并保存:https://github.com/DesertsP/Valine-Admin.git
2.在設(shè)置頁面,設(shè)置環(huán)境變量以及 Web 二級域名。
具體格式如下:
| 變量 | 示例 | 說明 |
|---|---|---|
| SITE_NAME | 平凡的你我 | [必填]博客名稱 |
| SITE_URL | https://reinness.com | [必填]首頁地址 |
| SMTP_SERVICE | "163" | [新版支持]郵件服務(wù)提供商,支持 QQ、163、126、Gmail 以及 更多 |
| SMTP_USER | xxxxx@163.com | [必填]SMTP登錄用戶 |
| SMTP_PASS | XXXXXXXX | [必填]SMTP登錄密碼(QQ郵箱需要獲取獨立密碼) |
| SENDER_NAME | caleb | [必填]發(fā)件人 |
| SENDER_EMAIL | xxxxx@163.com | [必填]發(fā)件郵箱 |
| BLOGGER_EMAIL | xxxxx@163.com | [可選]如果自己在回復(fù),設(shè)置這個可以不向自己的郵箱發(fā)送郵件 |
| ADMIN_URL | https://xxx.leanapp.cn/ | [建議]Web主機二級域名,用于自動喚醒 |
| BLOGGER_EMAIL | xxxxx@qq.com | [可選]博主通知收件地址,默認(rèn)使用SENDER_EMAIL |
| AKISMET_KEY | xxxxxxxxxxxx | [可選]Akismet Key 用于垃圾評論檢測,設(shè)為MANUAL_REVIEW開啟人工審核,留空不使用反垃圾 |
以上必填參數(shù)請務(wù)必正確設(shè)置。
3.切換到部署標(biāo)簽頁,分支使用master,點擊部署即可
第一次部署可能會需要些時間。
4.評論管理
訪問設(shè)置的二級域名https://二級域名.leanapp.cn/sign-up ,注冊管理員登錄信息,如:https://nk6vtvs0tdwc.leanapp.cn/sign-up
注:使用原版Valine如果遇到注冊頁面不顯示直接跳轉(zhuǎn)至登錄頁的情況,請手動刪除_User表中的全部數(shù)據(jù)。
此后,可以通過https://二級域名.leanapp.cn/管理評論。
5.定時任務(wù)設(shè)置
目前實現(xiàn)了兩種云函數(shù)定時任務(wù):
(1)自動喚醒,定時訪問Web APP二級域名防止云引擎休眠;
(2)每天定時檢查24小時內(nèi)漏發(fā)的郵件通知。
進(jìn)入云引擎-定時任務(wù)中,創(chuàng)建定時器,創(chuàng)建兩個定時任務(wù)。
(1)選擇self-wake云函數(shù),Cron表達(dá)式為0 0/30 7-23 * * ?,表示每天早6點到晚23點每隔30分鐘訪問云引擎,ADMIN_URL環(huán)境變量務(wù)必設(shè)置正確:
(2)選擇resend-mails云函數(shù),Cron表達(dá)式為0 0 8 * * ?,表示每天早8點檢查過去24小時內(nèi)漏發(fā)的通知郵件并補發(fā):
添加定時器后記得點擊啟動方可生效。
至此,Valine Admin 已經(jīng)可以正常工作。
郵件通知模板
1.環(huán)境變量設(shè)定
郵件通知模板在云引擎環(huán)境變量中設(shè)定,可自定義通知郵件標(biāo)題及內(nèi)容模板。
| 環(huán)境變量 | 示例 | 說明 |
|---|---|---|
| MAIL_SUBJECT |
${PARENT_NICK},您在${SITE_NAME}上的評論收到了回復(fù) |
[可選]@通知郵件主題(標(biāo)題)模板 |
| MAIL_TEMPLATE | 見下文 | [可選]@通知郵件內(nèi)容模板 |
| MAIL_SUBJECT_ADMIN | ${SITE_NAME}上有新評論了 | [可選]博主郵件通知主題模板 |
| MAIL_TEMPLATE_ADMIN | 見下文 | [可選]博主郵件通知內(nèi)容模板 |
2.自定義模板
郵件通知包含兩種,分別是 被@通知 和 博主通知,這兩種模板都可以完全自定義。默認(rèn)使用經(jīng)典的藍(lán)色風(fēng)格模板。
@通知模板中的可用變量如下(注,這是郵件模板變量,是指嵌入到HTML郵件模板中的變量,請勿與云引擎環(huán)境變量混淆)
| 模板變量 | 說明 |
|---|---|
| SITE_NAME | 博客名稱 |
| SITE_URL | 博客首頁地址 |
| POST_URL | 文章地址(完整路徑) |
| PARENT_NICK | 收件人昵稱(被@者,父級評論人) |
| PARENT_COMMENT | 父級評論內(nèi)容 |
| NICK | 新評論者昵稱 |
| COMMENT | 新評論內(nèi)容 |
(1)默認(rèn)被@通知郵件內(nèi)容模板如下:
<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>上的評論有了新的回復(fù)</h2> ${PARENT_NICK} 同學(xué),您曾發(fā)表評論:<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>回復(fù)說:</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">查看回復(fù)的完整內(nèi)容</a>,歡迎再次光臨<a style="text-decoration:none; color:#12addb" href="${SITE_URL}" target="_blank">${SITE_NAME}</a>。<br></p></div></div>
效果如圖:
(2)彩虹風(fēng)格的@通知郵件模板代碼:
<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>上的評論有了新的回復(fù)</h2> ${PARENT_NICK} 同學(xué),您曾發(fā)表評論:<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>回復(fù)說:</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">查看回復(fù)的完整內(nèi)容</a>,歡迎再次光臨<a style="text-decoration:none; color:#12addb" href="${SITE_URL}" target="_blank">${SITE_NAME}</a>。<br></p></div></div>
效果如圖:
博主通知郵件模板中的可用變量與@通知中的基本一致,PARENT_NICK 和 PARENT_COMMENT 變量不再可用。
(3)默認(rèn)博主通知郵件內(nèi)容模板如下:
<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>回復(fù)說:</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">查看回復(fù)的完整內(nèi)容</a><br></p></div></div>
因為沒使用過這個,所以就沒掛圖~~~
(4)彩虹風(fēng)格的博主通知郵件內(nèi)容模板如下:
<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}給您的回復(fù)如下:</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">查看回復(fù)的完整內(nèi)容</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>
效果如圖:
以上所有內(nèi)容供大家參考,如有問題請及時指正,如有侵權(quán),請及時聯(lián)系刪除
完結(jié)撒花??????
- 本人博客地址:https://reinness.com 站點名稱:平凡的你我。 歡迎大家的到來!