Small improvement to the `contrib.messages` doc introduction.

This commit is contained in:
Julien Phalip 2012-08-04 15:46:15 -07:00
parent 62ae711cec
commit 9ea4dc90b9
1 changed files with 8 additions and 6 deletions

View File

@ -5,12 +5,14 @@ The messages framework
.. module:: django.contrib.messages .. module:: django.contrib.messages
:synopsis: Provides cookie- and session-based temporary message storage. :synopsis: Provides cookie- and session-based temporary message storage.
Django provides full support for cookie- and session-based messaging, for Quite commonly in web applications, you may need to display a one-time
both anonymous and authenticated clients. The messages framework allows you notification message (also know as "flash message") to the user after
to temporarily store messages in one request and retrieve them for display processing a form or some other types of user input. For this, Django provides
in a subsequent request (usually the next one). Every message is tagged full support for cookie- and session-based messaging, for both anonymous and
with a specific ``level`` that determines its priority (e.g., ``info``, authenticated users. The messages framework allows you to temporarily store
``warning``, or ``error``). messages in one request and retrieve them for display in a subsequent request
(usually the next one). Every message is tagged with a specific ``level`` that
determines its priority (e.g., ``info``, ``warning``, or ``error``).
Enabling messages Enabling messages
================= =================