Instalar django-localeurl

1. Descargamos el paquete localeurl del sitio oficial a nuestro path de Python.

2. Añadimos 'localeurl.middleware.LocaleURLMiddleware' al setting MIDDLEWARE_CLASSES por encima de 'django.middleware.common.CommonMiddleware'.

   Importante: También deberemos situarlo por debajo de 'django.middleware.locale.LocaleMiddleware' en caso de que utilicemos LocaleMiddleware, para que éste pueda realizar la negociación de selección de idioma previamente.

3. Añadimos 'localeurl' a nuestras aplicaciones instaladas (setting INSTALLED_APPS).

4. Nos aseguramos de que el valor del setting LANGUAGE_CODE esté en el setting LANGUAGES que contiene la lista de lenguajes disponibles para nuestro proyecto. Podemos visualizar la lista de lenguajes por defecto en el código fuente de django.conf.global_settings.

Configurar django-localeurl

Existen 3 settings que nos permiten personalizar el funcionamiento de django-localeurl: LOCALE_INDEPENDENT_PATHS, REDIRECT_LOCALE_INDEPENDENT_PATHS y PREFIX_DEFAULT_LANGUAGE.

import re
LOCALE_INDEPENDENT_PATHS = (
    re.compile('^/aviso-legal/'),
    re.compile('^/privacidad/'),
)

Uso en plantillas

Cualquier aplicación que utilice etiquetas {% url %} para las URLs en sus plantillas funcionará correctamente con django-localeurl. A parte de esto django-localeurl incluye un template tag y 2 filtros que nos aportan flexibilidad a la hora de utilizar URLs en nuestras plantillas.

Para hacerlos funcionar debemos cargarlos con load en las plantillas en las que queramos trabajar con ellos:

{% load localeurl_tags %}

El tag {% locale_url %} funciona del mismo modo que el concido {% url %} pero permitiéndonos especificar el idioma que debe utilizarse en la URL. Nos sirve para enlaces que por algún motivo queramos mostrar en un idioma concreto. Para ello si tenemos algo como:

<a href="{% url ver-articulo articulo.id %}">Ver artículo</a>

Para que el enlace apunte a un idioma concreto es tan sencillo como utilizar:

<a href="{% locale_url "en" ver-articulo articulo.id %}">Ver artículo en inglés</a>

Los filtros incluídos son chlocale y rmlocale. chlocale nos permite añadir o cambiar el código de lenguaje de una URL y rmlocale eliminar el código de lenguaje de una URL. Un ejemplo de uso:

<p>Haz <a href="{{ mi_url|chlocale:"de" }}">click aquí</a> para cambiar a alemán.</p>
<p>La url {{ otra_url }} sin código de lenguaje es {{ otra_url|rmlocale }}</p>