Перенаправления
Модуль redirects предоставляет модели и пользовательский интерфейс для управления произвольными перенаправлениями между URL-адресами и Pages или другими URL-адресами.
Установка
Модуль redirects по умолчанию не включен. Для его установки добавьте wagtail.contrib.redirects в INSTALLED_APPS и wagtail.contrib.redirects.middleware.RedirectMiddleware в MIDDLEWARE в файле настроек Django вашего проекта.
INSTALLED_APPS = [
# ...
'wagtail.contrib.redirects',
]
MIDDLEWARE = [
# ...
# all other django middlware first
'wagtail.contrib.redirects.middleware.RedirectMiddleware',
]
Этот приложение содержит миграции, поэтому убедитесь, что после установки вы выполнили команду migrate django-admin.
Использование
После установки в меню «Настройки» должно появиться новое пунк меню «Перенаправления». Здесь вы можете добавлять произвольные перенаправления на ваш сайт.
Для руководства по использованию интерфейса см. Управление перенаправлениями.
Автоматическое создание перенаправлений
Новое в версии 2.16.
Wagtail автоматически создаёт постоянные перенаправления для страниц (и их потомков) при их перемещении или изменении сокращённого URL-адреса. Это помогает сохранить рейтинги SEO страниц со временем и помогает посетителям сайта попасть на нужную страницу при использовании закладок или устаревших ссылок.
Создание перенаправлений для альтернативных маршрутов страниц
Если ваш проект использует RoutablePageMixin для создания страниц с альтернативными маршрутами, вы можете рассмотреть возможность переопределения метода get_route_paths() для этих типов страниц. Добавление популярных маршрутов в этот список приведет к созданию дополнительных перенаправлений, помогая посетителям, использующим альтернативные маршруты, попасть на нужную страницу.
Для получения дополнительной информации, пожалуйста, см. get_route_paths().
Отключение автоматического создания перенаправлений
Стандартная реализация Wagtail подходит лучше для проектов малого и среднего размера (5000 страниц или меньше), которые в основном используют встроенные методы Wagtail для генерации URL-адресов.
Переопределения следующих Page методов учитываются при генерации перенаправлений, но использование определённых полей страниц в этих переопределениях вызовет дополнительные запросы к базе данных.
Если вы считаете, что эта функция не подходит для вашего проекта, вы можете отключить её, добавив следующее в настройки вашего проекта:
WAGTAILREDIRECTS_AUTO_CREATE = False
Команды управления
import_redirects
$ ./manage.py import_redirects
Эта команда импортирует и создаёт перенаправления из файла, предоставленного пользователем.
Параметры:
- src Путь к файлу, из которого необходимо импортировать перенаправления.
- site Сайт, на котором необходимо сохранить перенаправления.
- permanent Если импортируемые перенаправления должны быть постоянными (True) или нет (False). По умолчанию True.
- from Индекс столбца, который нужно использовать в качестве значения «перенаправление из».
- to Индекс столбца, который нужно использовать в качестве значения «перенаправление к».
- dry_run Позволяет выполнить импорт без внесения изменений.
- ask Позволяет проверить и утвердить каждое перенаправление перед его созданием.
Класс Redirect
© 2014-present Torchbox Ltd and individual contributors.
All rights are reserved.
Licensed under the BSD License.
https://docs.wagtail.org/en/v3.0.3/reference/contrib/redirects.html