django-absolute 0.2.2

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, including the as syntax:

{% absolute index as the_url %}
{{ the url }}

0.2.2 (2012-11-18)

• Handle template tag as syntax

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