Django cnotes provides a simple cookie based user notification system.
Why not use Django's own messaging system or django-notification? While both good solutions, they are a bit more heavy weight than cnotes. Specifically they can only send messages to logged in users and they involve hitting the database to find any queued messages.
Cntoes is different in that it keeps all messaging information in signed cookies and memory. This way it can send, tamper-proof notifications to both authenticated and anonymous users, without ever touching the database.
- Add the cnotes directory to your python path.
- Add cnotes.middleware.CnotesHandlerMiddleware to the MIDDLEWARE_CLASSES variable in your settings.py file.
Adding new messages:
import cnotes
cnotes.add('My message')
Getting, clearing and printing all existing messages:
import cnotes
notes = cnotes.get_and_clear()
for note in notes:
print note
Similar action without clearing:
import cnotes
notes = cnotes.get()
for note in notes:
print note
You can also access cnotes from the request object:
def my_view(request):
messages = request.cnotes
return render_to_response( 'my_view.html'), {
'messages': messages,
})
- CNOTES_AUTO_CLEAR
- If set to
True(default) the cnotes middlware will clear messages one they have been made available on a non-ajax request object.