Интеграция Wagtail в проект Django

Wagtail предоставляет команду wagtail start и шаблон проекта, чтобы как можно быстрее начать работу с новым проектом Wagtail, но также легко интегрировать Wagtail в существующий проект Django.

Wagtail в настоящее время совместим с Django 3.2, 4.0 и 4.1. Сначала установите пакет wagtail из PyPI:

pip install wagtail

или добавьте пакет в существующий файл requirements. Это также установит библиотеку Pillow в качестве зависимости, которая требует libjpeg и zlib — см. инструкции по установке, специфичные для платформы Pillow.

Настройки

В файле settings.py добавьте следующие приложения в INSTALLED_APPS:

'wagtail.contrib.forms',
'wagtail.contrib.redirects',
'wagtail.embeds',
'wagtail.sites',
'wagtail.users',
'wagtail.snippets',
'wagtail.documents',
'wagtail.images',
'wagtail.search',
'wagtail.admin',
'wagtail',

'modelcluster',
'taggit',

Добавьте следующую запись в MIDDLEWARE:

'wagtail.contrib.redirects.middleware.RedirectMiddleware',

Добавьте настройку STATIC_ROOT, если она еще не присутствует в вашем проекте:

STATIC_ROOT = os.path.join(BASE_DIR, 'static')

Добавьте настройки MEDIA_ROOT и MEDIA_URL, если они еще не присутствуют в вашем проекте:

MEDIA_ROOT = os.path.join(BASE_DIR, 'media')
MEDIA_URL = '/media/'

Добавьте WAGTAIL_SITE_NAME — это будет отображаться на главной панели управления админ-панели Wagtail:

WAGTAIL_SITE_NAME = 'My Example Site'

Доступны различные другие настройки для конфигурирования поведения Wagtail — см. Настройки.

Настройка URL

Теперь внесите следующие изменения в файл urls.py:

from django.urls import path, include

from wagtail.admin import urls as wagtailadmin_urls
from wagtail import urls as wagtail_urls
from wagtail.documents import urls as wagtaildocs_urls

urlpatterns = [
    ...
    path('cms/', include(wagtailadmin_urls)),
    path('documents/', include(wagtaildocs_urls)),
    path('pages/', include(wagtail_urls)),
    ...
]

Пути URL здесь можно изменить по мере необходимости, чтобы они соответствовали схеме URL вашего проекта.

wagtailadmin_urls предоставляет интерфейс администрирования для Wagtail. Это отдельный интерфейс от интерфейса администрирования Django (django.contrib.admin); проекты, использующие только Wagtail, обычно размещают админ-панель Wagtail по адресу /admin/, но если это будет конфликтовать с существующей админ-панелью вашего проекта, можно использовать альтернативный путь, например /cms/ здесь.

wagtaildocs_urls — это место, откуда будут обслуживаться файлы документов. Это можно опустить, если вы не планируете использовать функции управления документами Wagtail.

wagtail_urls — это базовый путь, откуда будут обслуживаться страницы вашего сайта Wagtail. В приведенном выше примере Wagtail будет обрабатывать URL под /pages/, оставляя корневой URL и другие пути для обработки обычным образом вашим проектом Django. Если вы хотите, чтобы Wagtail обрабатывал всё пространство URL, включая корневой URL, это можно заменить на:

path('', include(wagtail_urls)),

В этом случае это должно быть помещено в конец списка urlpatterns, чтобы оно не переопределяло более конкретные шаблоны URL.

Наконец, ваш проект должен быть настроен на обслуживание загруженных пользователями файлов из MEDIA_ROOT. Возможно, ваш проект Django уже имеет это, но если нет, добавьте следующий фрагмент в urls.py:

from django.conf import settings
from django.conf.urls.static import static

urlpatterns = [
    # ... the rest of your URLconf goes here ...
] + static(settings.MEDIA_URL, document_root=settings.MEDIA_ROOT)

Обратите внимание, что это работает только в режиме разработки (DEBUG = True); в производственной среде вам нужно будет настроить веб-сервер для обслуживания файлов из MEDIA_ROOT. Для получения более подробной информации см. документацию Django: Обслуживание файлов, загруженных пользователем во время разработки и Развертывание статических файлов.

После выполнения этой настройки вы готовы запустить python manage.py migrate для создания таблиц базы данных, используемых Wagtail.

Пользовательские учетные записи

Суперпользователи получают автоматический доступ к интерфейсу администрирования Wagtail; воспользуйтесь python manage.py createsuperuser в случае отсутствия. Поддержка пользовательских моделей с некоторыми ограничениями; Wagtail использует расширение фреймворка разрешений Django, поэтому ваша модель пользователя, как минимум, должна наследоваться от AbstractBaseUser и PermissionsMixin.

Начало разработки

Теперь вы готовы добавить новое приложение в свой проект Django (через python manage.py startapp — не забудьте добавить его в INSTALLED_APPS в файле settings.py) и настроить модели страниц, как описано в Ваш первый сайт Wagtail.

Обратите внимание, что есть небольшое отличие при отсутствии шаблона проекта Wagtail: Wagtail создает начальную домашнюю страницу базового типа Page, которая не содержит никаких полей контента, кроме заголовка. Вы, вероятно, захотите заменить её своей собственной моделью HomePage — при этом убедитесь, что настроили запись сайта (в разделе Настройки/Сайты в админ-панели Wagtail) для указания на новую домашнюю страницу.