Инсталирайте Vanta Admin във вашия Django проект

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

Пакет vanta-admin
Приложение Django vanta_admin
Диапазон на пакета Python 3.12+ / Django 6.0–6.1

1. Инсталирайте пакета

Използвайте PyPI за нормални проекти. Името на пакета е vanta-admin.

uv
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. Събирайте статични файлове

Изпълнете обичайната команда collectstatic на Django преди внедряване. Така пакетираните CSS, JavaScript и favicon стават достъпни за вашата конфигурация на статичните файлове.

uv проект
uv run python manage.py collectstatic
стандартен Python
python manage.py collectstatic

4. Актуализирайте Vanta Admin

От корена на вашия проект разрешите най-новата версия на Vanta Admin и синхронизирайте средата. Това работи с нормалното ограничение от uv add vanta-admin.

uv
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 адреси или модели на бази данни.

Вижте източника