django-notify


A Django application which provides temporary notifications

Django Notify

A Django application which provides temporary notifications.

Notification messages persist until a request retrieves them.

As of Django 1.2, temorary notifications are included, and can be found in django.contrib.messages.

Installation

Install from PYPI (easy_install django-notify).

Add the middleware to your MIDDLEWARE_CLASSES setting (after SessionMiddleware): 'django_notify.middleware.NotificationsMiddleware',

Add the context processor into your TEMPLATE_CONTEXT_PROCESSORS setting: 'django_notify.context_processors.notifications',

Usage

Add a temporary notification message like this: ``` request.notifications.add('Hello world.')

# Other methods are provided for adding common message types:
request.notifications.success('Profile details updated.')
request.notifications.warning('Your account expires in three days.')
request.notifications.error('Document deleted.')

```

Use notifications in your template: ``` {% if notifications %}

{% for message in notifications %} {{ message }} {% endfor %}

{% endif %} ```

Temporary Storage

Django Notify can use different temporary storage backends. To change which storage is being used, add a NOTIFICATIONS_STORAGE to your settings, referencing to the module and class of the storage class.

For example, to only store notifications in the session ratehr than using the default cookie/session fallback storage: NOTIFICATIONS_STORAGE = 'session.SessionStorage'

For more info, read the docs.

Project Information