django-messages-ui 1.1.0

JS and HTML to support the Django contrib.messages app

  Add it to your Download Basket!

 Add it to your Watch List!

0/5

Rate it!

What's new in django-messages-ui 1.1.0:

  • Add option for template name.
  • Make agnostic regarding templating engine, as long as template is precompiled and callable fn.
Read full changelog
send us
an update
LICENSE TYPE:
BSD License 
USER RATING:
UNRATED
  0.0/5
DEVELOPED BY:
Jonny Gerig Meyer
HOMEPAGE:
github.com
CATEGORY:
ROOT \ Internet \ Django Plugins
django-messages-ui is a Django app that adds JS and HTML to support the Django contrib.messages app. It should be called on the message list element, and accepts options for message selectors, transient messages (that disappear on click or key-press), and close-links.

Messages can be dynamically added via ICanHaz.js, and there's a Python middleware to automatically add messages from the request into Ajax JSON responses.

Installation:

In your Django project settings, add "messages_ui" to your INSTALLED_APPS.

Usage:

Linking the JS:

< script src="{{ STATIC_URL }}messages_ui/jquery.messages-ui.js" >< /script >

Including the default HTML Template:

{% include "messages_ui/_messages.html" %}

Calling the plugin:

$('#messages').messages();

Calling the plugin with a variety of options explicitly configured to their default values:

$('#messages').messages({
 message: '.message', // Selector for individual messages
 closeLink: '.close', // Selector for link to close message
 transientMessage: '.success', // Selector for transient messages
 transientDelay: 500, // Transient message fade delay (ms)
 transientFadeSpeed: 3000, // Transient message fade speed (ms)
 handleAjax: false // Enable automatic AJAX handling
});


Adding a message in JS (requires ICanHaz.js):

$(ich.message({message: "Sample Message", tags: "info"}).appendTo(
 $('#messages'));


To override the default JS template, add a message.html file to a directory listed in your ICANHAZ_DIRS setting (a django-icanhaz setting).

Ajax

To enable automatic handling of messages from Ajax requests, add "messages_ui.middleware.AjaxMessagesMiddleware" to your MIDDLEWARE_CLASSES setting (directly after django.contrib.messages.middleware.MessageMiddleware), and pass handleAjax: true to the plugin initialization.

Last updated on July 25th, 2012

requirements

#Django contrib.messages #Django messages #Django #messages #UI #contrib.messages

Add your review!

SUBMIT