Skip to main content
Help us improve PyPI by participating in user testing. All experience levels needed!

Django application for adding compressed CSS and JS files in some prepared slots

Project description

django-bundledmedia
===================

``django-bundledmedia`` is a Django application for adding compressed CSS and
JS files in some prepared slots.

This functionality was splitted out of Merengue CMS.

Installing
----------

* Install package from pypi::

$ easy_install django-bundledmedia

* Include ``bundledmedia`` in the ``INSTALLED_APPS`` setting.

* Include ``bundledmedia.middleware.BundledMediaMiddleware`` in the ``MIDDLEWARE_CLASSES`` setting.

Usage
-----

In your base template (i.e. ``base.html``)::

{% load bundledmedia %}
<html>
<head>
{# placeholder to allow plugins and other templates to add css assets #}
{% bundledmedia "css" "css" %}
...
{% bundledmedia "extracss" "css" %}
</head>
<body>
...
{# placeholder to allow plugins and other templates to add javascript assets #}
{% bundledmedia "js" "js" %}
</body>
</html>

In your included template (i.e. ``inc.sidebar.html``)::

{% load bundledmedia %}
{% addmedia "css" %}
<link rel="stylesheet" type="text/css" href="{{ MEDIA_URL }}css/sidebar.css"/>
{% endaddmedia %}
{% addmedia "js" %}
<script language="javascript" src="{{ MEDIA_URL }}js/jquery.sidebar.js"></script>
{% endaddmedia %}
...

In your specific template (i.e. ``myview.html``)::

{% load bundledmedia %}
{% addmedia "extracss" %}
<link rel="stylesheet" type="text/css" href="{{ MEDIA_URL }}css/myview.css"/>
{% endaddmedia %}
...

This code will render all chunks of code of all the included templates in the
placeholders above.

Compression
-----------

``django-bundledmedia`` uses ``django-compressor`` to render compressed CSS and
JS when the ``COMPRESS`` setting is set to ``True``

0.1b3
----

* Backward incompatible improvement: using new ``media_type`` parameter to get a more explicit type definition (JS or CSS).

0.1b2
----

* Not generating compressed JS or CSS if there is no content to compress.

0.1b1
----

* More flexible naming conventions in the bundled blocks.

0.1a
----

* Initial version.

Project details


Release history Release notifications

This version
History Node

0.1b3

History Node

0.1b2

History Node

0.1b1

History Node

0.1a

Download files

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

Filename, size & hash SHA256 hash help File type Python version Upload date
django-bundledmedia-0.1b3.tar.gz (11.8 kB) Copy SHA256 hash SHA256 Source None Jun 8, 2012

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging CloudAMQP CloudAMQP RabbitMQ AWS AWS Cloud computing Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page