django_user_messages 1.1.0

安装

• 使用pip在虚拟环境中安装django-user-messages。

• 将user_messages添加到INSTALLED_APPS中并运行migrate。

• 将 user_messages.context_processors.messages 消息处理器添加到默认消息处理器之后的位置。Django的admin应用会检查后者的存在，因此您不能直接删除它（除非您想禁用"admin.E404"系统检查）。

• 使用 user_messages.api 的方式与使用 django.contrib.messages 相同，但您需要传递用户模型或ID作为第一个参数，而不是当前请求。

用法

基本上与Django的消息框架相同

from user_messages import api

api.info(user, 'Hey there')
api.warning(user, 'Stop this')
api.error(user, 'Not nice!')

# Passing the ID is also possible; the user instance does not
# have to be instantiated at all:
api.success(user.id, 'Yay!')

django-user-messages的消息支持Django消息框架中不支持的两种附加功能

• 通过传递 deliver_once=False，可以将消息传递多次。这些消息必须被显式确认。django-user-messages不包含执行此操作的代码。

• 可以通过传递字典作为 meta 来附加额外的数据

  api.debug(user, 'Oww', meta={
      'url': 'http://example.com',
  })

为了方便，我们的消息具有与Django消息相同的 tags 和 level_tag 属性。元属性也可以在模板中访问

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

django-user-messages的消息也是惰性评估的。