Для установки приложения выполните следующие шаги:

Команда manage.py syncdb создаёт таблицу django_redirect в вашей базе данных. Это простая таблица с полями site_id, old_path и new_path.

Вы можете создавать перенаправления как через интерфейс администратора Django, так и через API для работы с базой данных. Подробности описаны в разделе «Добавление, изменение и удаление».

После установки средств управления перенаправлениями всю работу будет выполнять класс RedirectFallbackMiddleware. При каждом вызове ошибки 404, в качестве последнего действия, этот класс будет проверять наличие в базе данных соответствующего перенаправления для запрашиваемого URL. Следует отметить, что производится проверка для перенаправления по указанному в old_path пути для соответствующего сайта, SITE_ID. (Обратитесь к разделу «Сайты» для подробностей по параметру SITE_ID и среде управления сайтами.) Затем выполняются следующие действия:

Класс RedirectFallbackMiddleware обрабатывает только ошибки 404, остальное игнорируется.

Следует отметить, что порядок записей в конфигурационном параметре MIDDLEWARE_CLASSES имеет значение. Обычно RedirectFallbackMiddleware располагают поближе к концу списка, так как перенаправление является последним действием при обработке ошибки 404.

Вы можете добавлять, изменять и удалять перенаправления двумя способами:

>>> from django.contrib.redirects.models import Redirect
>>> from django.contrib.sites.models import Site
>>> red = Redirect(
...     site=Site.objects.get(id=1),
...     old_path='/music/',
...     new_path='/sections/arts/music/',
... )
>>> red.save()
>>> Redirect.objects.get(old_path='/music/')
<Redirect: /music/ ---> /sections/arts/music/>