Zainstaluj Vanta Admin w swoim projekcie Django

Dodaj pakiet, umieść motyw przed Django admin, zbierz zasoby statyczne i nadal korzystaj z admin, które już znasz.

Pakiet PyPI

Django admin

Pakiet vanta-admin

Aplikacja Django vanta_admin

Zakres pakietu Python 3.12+ / Django 6.0–6.1

1. Zainstaluj pakiet

Używaj PyPI do normalnych projektów. Nazwa pakietu to vanta-admin.

uv add vanta-admin

pip

pip install vanta-admin

2. Dodaj aplikację Django

Dodaj vanta_admin do INSTALLED_APPS przed django.contrib.admin. Ta kolejność pozwala szablonom Vanta admin override Django na ustawienia domyślne.

settings.py

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

3. Zbieraj pliki statyczne

Przed wdrożeniem uruchom zwykłe polecenie collectstatic Django. Dzięki temu spakowane pliki CSS, JavaScript i favicon będą dostępne w konfiguracji plików statycznych.

projekt UV

uv run python manage.py collectstatic

standardowy Python

python manage.py collectstatic

4. Zaktualizuj Vanta Admin

W katalogu głównym projektu rozwiąż najnowszą wersję Vanta Admin i zsynchronizuj środowisko. Działa to przy normalnym ograniczeniu z uv add vanta-admin.

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

pip

pip install --upgrade vanta-admin

5. Zachowaj swoją markę

Vanta stylizuje admin; Twój projekt nadal jest właścicielem tekstu wyświetlanego na karcie przeglądarki, w nagłówku i indeksie 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. Opcjonalne szablony 2FA

Jeśli Twój projekt korzysta już z django-two-factor-auth, Vanta może motywować także te widoczne ekrany. Nie instaluje, nie włącza ani nie konfiguruje uwierzytelniania dwuskładnikowego.

settings.py

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

Sprawdź admin po instalacji

Rozpocznij projekt Django, otwórz admin i sprawdź ekran logowania, pasek boczny, listy zmian, formularze, wiadomości i układ mobilny. Motyw pozostaje renderowany przez serwer i nie zastępuje Django admin zachowań, uprawnień, adresów URL ani modeli baz danych.

Zobacz źródło