django-absolute 0.2.1

Absolute URLs tools for django

Django Absolute

Django Absolute provides context processors and template tags to use full absolute URLs in templates.

Installation

You can install Django Absolute with pip:

pip install django-absolute

or with easy_install:

easy_install django-absolute

Add absolute to your settings.INSTALLED_APPS.

Context processor

Add absolute.context_processors.absolute to your settings.TEMPLATE_CONTEXT_PROCESSORS. Django Absolute context processor depends on request context processor:

from django.conf import global_settings

TEMPLATE_CONTEXT_PROCESSORS = global_settings.TEMPLATE_CONTEXT_PROCESSORS + (
    'django.core.context_processors.request',
    'absolute.context_processors.absolute',
)

Then you can access the following variables in your templates:

• ABSOLUTE_ROOT: full absolute root URL (without trailing slash) based on incoming request

• ABSOLUTE_ROOT_URL: full absolute root URL (with trailing slash) based on incoming request

• SITE_ROOT: full absolute root URL (without trailing slash) based on current Django Site

• SITE_ROOT_URL: full absolute root URL (with trailing slash) based on current Django site

Template tags

Django absolute provide 2 template tags:

• absolute: acts like url but provide a full URL based on incoming request.

• site: acts like url but provide a full URL based on current Django Site.

To use theses template tags, you need to load the absolute template tag library.:

{% url index %}

{% load absolute %}
{% absolute index %}
{% site index %}

These template tags have exactly the same syntax as url.

Changelog

0.2.1 (2012-11-10)

• Fix packaging

0.2 (2012-11-10)

• {% site %} fallback on http protocol if request is missing.

0.1 (2012-06-10)

• Initial release