Easy full absolute URLs for Django
Python Shell
Latest commit 0358fd3 Nov 13, 2013 @noirbizarre Merge pull request #5 from Elijen/master
Handle `as` template tag syntax also inside of a loop
Permalink
Failed to load latest commit information.
absolute
doc Added sphinx doc Mar 3, 2013
.gitignore Added sphinx doc Mar 3, 2013
.travis.yml Removed Python 2.6 tests (not supported anymore) Mar 3, 2013
CHANGELOG.rst Updated to version 0.4.dev for next development cycle Mar 3, 2013
LICENSE Added license and classifiers. Jun 10, 2012
MANIFEST.in
README.rst Fix in README Mar 3, 2013
manage.py Django 1.5 compatibility (Documentation and tests) Mar 3, 2013
release.sh Added release script Nov 10, 2012
setup.py Added release script Nov 10, 2012

README.rst

Django Absolute

https://secure.travis-ci.org/noirbizarre/django-absolute.png

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.

{% load absolute %}

{% url index %}
{% 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 }}

If you use Django 1.5, you need to use the "new-style" url syntax (quoted parameters):

{% load absolute %}

{% url "index" %}
{% absolute "index" %}
{% site "index" %}

{% absolute "index" as the_url %}
{{ the_url }}

If you want to match the "new-style" syntax in Django < 1.5 you need to load absolute_future instead (same behavior as {% load url from future %}).

{% load url from future %}
{% load absolute_future %}

{% url "index" %}
{% absolute "index" %}
{% site "index" %}

{% absolute "index" as the_url %}
{{ the_url }}

For more informations, see the Django 1.5 release notes.