Skip to main content

Add fancy notification popups to a Django project

Project description

Super popups for Django

Let ``super-popups`` show fancy messages to your visitors

.. image::

.. image::

.. image::


- Django >= 1.8
- Jquery 1.12
- Font-awesome 4.5.0


1. Install using pip:

``pip install django-super-popups``

Alternatively, you can install download or clone this repo and call ``pip install -e .``.

2. Add to INSTALLED_APPS in your ````:


3. In your templates, load the following ``css`` and ``js`` files:

.. code:: Django

<link rel="stylesheet" type="text/css" media="screen" href="{% static "super_popups/superpopups.css" %}" />
<script type="text/javascript" src="{% static "super_popups/superpopups.js" %}"></script>


Call your website with the following GET variables to display a message: is the text

Which will display the following popup:

.. image::

If you do not want to define the popup using GET variables, you can define the style and content with the following javascript variable.

.. code:: javascript

var superpopups = {
tyT: "ok", // MANDATORY. Possible values are `ok`, `ko` and `warn`
msT: "Everything is great!", // MANDATORY
autohide: 5000, // OPTIONAL. When set, the message will disappear after the defined interval in ms.

Example template

.. code:: Django

{# Web code #}

<link rel="stylesheet" type="text/css" media="screen" href="{% static "super_popups/superpopups.css" %}" />
var superpopups = {
tyT: "ok",
msT: "This message will appear at the top of your website for only 5 seconds!",
autohide: 5000, // The message will disappear in 5000 ms.
<script type="text/javascript" src="{% static "super_popups/superpopups.js" %}"></script>


This is all the documentation we have :)

Bugs and suggestions

If you have found a bug or if you have a request for additional functionality, please use the issue tracker on GitHub.


You can use this under Apache 2.0. See `LICENSE
<LICENSE>`_ file for details.


Original author and maintained by `Eduardo Calleja <>`_.

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Files for django-super-popups, version 1.1
Filename, size File type Python version Upload date Hashes
Filename, size django-super-popups-1.1.tar.gz (5.6 kB) File type Source Python version None Upload date Hashes View

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring DigiCert DigiCert EV certificate Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page