Skip to main content
This is a pre-production deployment of Warehouse. Changes made here affect the production instance of PyPI (pypi.python.org).
Help us improve Python packaging - Donate today!

Absolute URLs tools for django

Project Description

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.

{% 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.

Changelog

0.3 (2013-03-03)

  • Check if django.contrib.sites is enabled (thanks to Rodrigo Primo)
  • Django 1.5 compatibility (Documentation and tests)
  • Added absolute_future template tag library (match {% load url from future %} syntax).
  • drop support for Python 2.6 (test only)

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
Release History

Release History

This version
History Node

0.3

History Node

0.2.2

History Node

0.2.1

History Node

0.1

Download Files

Download Files

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

File Name & Checksum SHA256 Checksum Help Version File Type Upload Date
django-absolute-0.3.tar.gz (10.0 kB) Copy SHA256 Checksum SHA256 Source Mar 3, 2013

Supported By

WebFaction WebFaction Technical Writing Elastic Elastic Search Pingdom Pingdom Monitoring Dyn Dyn DNS Sentry Sentry Error Logging CloudAMQP CloudAMQP RabbitMQ Heroku Heroku PaaS Kabu Creative Kabu Creative UX & Design Fastly Fastly CDN DigiCert DigiCert EV Certificate Rackspace Rackspace Cloud Servers DreamHost DreamHost Log Hosting