django-notify 1.1.2

添加通知消息

中间件将一个名为notifications的临时存储类实例附加到您的request上。要添加通知，请调用

request.notifications.add('Hello world.')

其他一些方法提供了添加通知的标准方式，这些方法通常使用常用标签（这些标签通常表示为消息的HTML类）

request.notifications.debug('%s SQL statements were executed.' % count)
request.notifications.success('Profile details updated.')
request.notifications.warning('Your account expires in three days.')
request.notifications.error('Document deleted.')

显示通知消息

在您的模板中，使用类似以下内容

{% if notifications %}
<ul class="messages">
        {% for message in notifications %}
        <li{% if message.tags %} class="{{ message.tags }}"{% endif %}>{{ message }}</li>
        {% endfor %}
</ul>
{% endif %}

如果您正在使用上下文处理器，则应使用RequestContext渲染模板。否则，请确保request.notifications对模板上下文可用。

通知消息的过期

当遍历存储实例时，将标记通知以清除（并且在处理响应时清除）。

为了避免通知被清除，您可以在迭代后设置 request.notifications.used = False。

通知级别

可以使用 NOTIFICATIONS_LEVEL 设置来更改最小记录级别。尝试添加低于此级别的通知将被忽略。

内置的级别（可以直接从 django_notify 导入）包括

INFO 是默认的最小记录级别。它也是 add 方法的默认级别。

最小记录级别也可以通过更改通知存储实例的 level 属性来按请求设置

import django_notify

# Change the notifications level to ensure the debug message is added.
request.notifications.level = django_notify.DEBUG
request.notifications.debug('Test notification...')

# Set the notifications level back to default.
request.notifications.level = None

自定义标签

为了为通知级别提供自定义标签（无论是内置级别还是自定义级别），将 NOTIFICATIONS_TAGS 设置为一个包含您希望更改的级别的字典。由于它扩展了默认标签，因此您只需提供要覆盖的级别的标签即可

import django_notify
NOTIFICATIONS_TAGS = {
    django_notify.INFO: 'info',
    50: 'critical',
}

要更直接地控制消息标签，您可以选择为任何 add 方法提供一个包含额外标签的字符串

request.notifications.add('Over 9000!', extra_tags='dragonball')
request.notifications.error('Email box full', extra_tags='email')

额外标签将添加到该级别的任何默认标签之前（空格分隔）。