Установите Vanta Admin в свой проект Django

Добавьте пакет, поместите тему перед Django admin, соберите статические ресурсы и продолжайте использовать уже знакомый вам admin.

пакет PyPI

Django admin

Упаковка vanta-admin

Приложение Django vanta_admin

Диапазон пакета Python 3.12+ / Django 6.0–6.1

1. Установить пакет

Используйте PyPI для обычных проектов. Имя пакета — vanta-admin.

uv add vanta-admin

pip

pip install vanta-admin

2. Добавьте приложение Django

Добавьте vanta_admin к INSTALLED_APPS перед django.contrib.admin. Такой порядок позволяет использовать шаблоны admin Vanta override Django по умолчанию.

settings.py

INSTALLED_APPS = [
    "vanta_admin",
    "django.contrib.admin",
    # ...
]

3. Собирать статические файлы

Перед развертыванием выполните обычную команду Django collectstatic. Благодаря этому упакованные файлы CSS, JavaScript и favicon будут доступны в конфигурации статических файлов.

УФ-проект

uv run python manage.py collectstatic

стандартный Python

python manage.py collectstatic

4. Обновить Vanta Admin

Из корня проекта разрешите новейшую версию Vanta Admin и синхронизируйте среду. Это работает с обычным ограничением из uv add vanta-admin.

uv lock --upgrade-package vanta-admin
uv sync

pip

pip install --upgrade vanta-admin

5. Сохраните свой бренд

Vanta стилизует admin; вашему проекту по-прежнему принадлежит текст, отображаемый на вкладке браузера, в заголовке и индексе admin.

admin.py

from django.contrib import admin

admin.site.site_header = "Your Admin"
admin.site.site_title = "Your Admin"
admin.site.index_title = "Your Admin"

6. Дополнительные шаблоны 2FA

Если ваш проект уже использует django-two-factor-auth , Vanta также может оформить темы для этих видимых экранов. Он не устанавливает, не включает и не настраивает двухфакторную аутентификацию за вас.

settings.py

INSTALLED_APPS = [
    "vanta_admin",
    "django_otp",
    "django_otp.plugins.otp_static",
    "django_otp.plugins.otp_totp",
    "two_factor",
    "django.contrib.admin",
    # ...
]

Проверьте admin после установки.

Запустите проект Django, откройте admin и проверьте экран входа в систему, боковую панель, списки изменений, формы, сообщения и макет для мобильных устройств. Тема остается визуализированной на сервере и не заменяет поведение Django admin, разрешения, URL-адреса или модели базы данных.

Посмотреть источник