一、安装

pip install django-notifications-hq

二、配置

1. settings.py文件INSTALLED_APPS = (    'django.contrib.auth',    ...    'notifications',    ...)2. 项目urls.py文件import notifications.urlsurlpatterns = [    ...    url('^inbox/notifications/', include(notifications.urls, namespace='notifications')),    ...]

三、数据库迁移

python manage.py migrate notifications

四、使用

  • 一般生成的通知最好在单独的信号中完成，Django有自带的信号处理方式，具体可参考Django官方文档signals章节

示例代码：

from django.dispatch import receiverfrom django.db.models.signals import post_savefrom comment.models import Commentfrom notifications.signals import notifyfrom django.utils.html import strip_tags@receiver(post_save, sender=Comment)def send_notification(sender, instance, **kwargs):    # 发送站内消息    if instance.reply_to is None:        # 评论        recipient = instance.content_object.get_user()        if instance.content_type.model == 'blog':            blog = instance.content_object            verb = '{0} 评论了你的博客《{1}》'.format(instance.user.username, blog.title)        else:            raise Exception('unkown comment object type')    else:        # 回复        recipient = instance.reply_to        verb = '{0} 回复了你的评论“{1}”'.format(                instance.user.username,                 strip_tags(instance.parent.text)            )    notify.send(instance.user, recipient=recipient, verb=verb, action_object=instance)
  • 也可在项目任何地方生成通知

示例代码：

from notifications.signals import notifynotify.send(user, recipient=user, verb='消息内容')

  • 如果希望在消息中携带额外的数据可参考下面的步骤
    1.在项目的settings.py文件配置

    DJANGO_NOTIFICATIONS_CONFIG = {      'USE_JSONFIELD': True,}

    2.发送消息时携带参数

    notify.send(instance.user, recipient=recipient, verb=verb, action_object=instance, url=url)

五、在HTML模板页面渲染

  • 在页面顶部添加模板标签{% load notifications_tags %}

  • 参考功能：

    • 获取未读数量
    1. 添加模板标签 {% notifications_unread as unread_count %}2. 使用：{{ unread_count }}
    • 全部标记为已读
    {% url 'notifications:mark_all_as_read' %}?next={% url 'userinfo' %}不加next参数默认返回主路由，即'/'
功能很多，这里就不一一举例，具体可参考官方文档。