From 11ae3570e0c1a9468bf16e46970763987d5ff7a2 Mon Sep 17 00:00:00 2001
From: plhw57tbe <2723863608@qq.com>
Date: Sun, 12 Oct 2025 22:13:50 +0800
Subject: [PATCH] Update utils.py
---
src/DjangoBlog-master/comments/utils.py | 42 +++++++++++++++++++------
1 file changed, 33 insertions(+), 9 deletions(-)
diff --git a/src/DjangoBlog-master/comments/utils.py b/src/DjangoBlog-master/comments/utils.py
index f01dba7..32de978 100644
--- a/src/DjangoBlog-master/comments/utils.py
+++ b/src/DjangoBlog-master/comments/utils.py
@@ -1,28 +1,45 @@
-import logging
+import logging # 导入日志模块，用于记录程序运行中的日志信息
-from django.utils.translation import gettext_lazy as _
+from django.utils.translation import gettext_lazy as _ # 导入翻译函数，支持国际化文本
-from djangoblog.utils import get_current_site
-from djangoblog.utils import send_email
+from djangoblog.utils import get_current_site # 从自定义工具模块导入获取当前站点域名的函数
+from djangoblog.utils import send_email # 从自定义工具模块导入发送邮件的函数
-logger = logging.getLogger(__name__)
+logger = logging.getLogger(__name__) # 创建当前模块的日志记录器，用于记录该模块的日志
def send_comment_email(comment):
+ """
+ 发送评论相关邮件：
+ 1. 向评论作者发送评论成功的感谢邮件
+ 2. 若当前评论是回复（有父评论），向父评论作者发送回复通知邮件
+ """
+ # 获取当前网站的域名（用于拼接文章链接）
site = get_current_site().domain
+ # 邮件主题：评论感谢（支持国际化）
subject = _('Thanks for your comment')
+ # 拼接评论对应的文章访问链接（HTTPS协议）
article_url = f"https://{site}{comment.article.get_absolute_url()}"
+ # 构建给评论作者的HTML格式邮件内容（支持国际化，通过占位符注入动态数据）
html_content = _("""Thank you very much for your comments on this site
You can visit %(article_title)s
to review your comments,
Thank you again!
If the link above cannot be opened, please copy this link to your browser.
- %(article_url)s""") % {'article_url': article_url, 'article_title': comment.article.title}
+ %(article_url)s""") % {
+ 'article_url': article_url, # 文章访问链接
+ 'article_title': comment.article.title # 文章标题
+ }
+ # 评论作者的邮箱（收件人）
tomail = comment.author.email
+ # 调用发送邮件函数，向评论作者发送感谢邮件
send_email([tomail], subject, html_content)
+
try:
+ # 判断当前评论是否有父评论（即是否是回复评论）
if comment.parent_comment:
+ # 构建给父评论作者的HTML格式邮件内容（回复通知，支持国际化）
html_content = _("""Your comment on %(article_title)s
has
received a reply.
%(comment_body)s
@@ -30,9 +47,16 @@ def send_comment_email(comment):
If the link above cannot be opened, please copy this link to your browser.
%(article_url)s
- """) % {'article_url': article_url, 'article_title': comment.article.title,
- 'comment_body': comment.parent_comment.body}
+ """) % {
+ 'article_url': article_url, # 文章访问链接
+ 'article_title': comment.article.title, # 文章标题
+ 'comment_body': comment.parent_comment.body # 父评论的内容（供作者识别）
+ }
+ # 父评论作者的邮箱（收件人）
tomail = comment.parent_comment.author.email
+ # 调用发送邮件函数，向父评论作者发送回复通知邮件
send_email([tomail], subject, html_content)
+ # 捕获发送回复邮件过程中的异常（避免单个邮件发送失败影响整体流程）
except Exception as e:
- logger.error(e)
+ # 记录异常日志（便于问题排查）
+ logger.error(e)
\ No newline at end of file