Installera Vanta Admin i ditt Django-projekt

Lägg till paketet, placera temat före Django admin, samla statiska tillgångar och fortsätt använda den admin du redan känner.

PyPI-paket

Django admin

Paket vanta-admin

Django app vanta_admin

Paketintervall Python 3.12+ / Django 6.0–6.1

1. Installera paketet

Använd PyPI för vanliga projekt. Paketnamnet är vanta-admin.

uv add vanta-admin

pip

pip install vanta-admin

2. Lägg till Django-appen

Lägg till vanta_admin i INSTALLED_APPS före django.contrib.admin. Den ordningen gör att Vantas admin templates kan override standardinställningarna i Django.

settings.py

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

3. Samla statiska filer

Kör det vanliga Django-kommandot collectstatic före distributionen. Då blir de paketerade CSS-, JavaScript- och favicon-filerna tillgängliga i din konfiguration för statiska filer.

uv-projekt

uv run python manage.py collectstatic

standard Python

python manage.py collectstatic

4. Uppdatera Vanta Admin

Från din projektrot, lös den senaste Vanta Admin-versionen och synkronisera miljön. Detta fungerar med den normala begränsningen från uv add vanta-admin.

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

pip

pip install --upgrade vanta-admin

5. Behåll ditt varumärke

Vanta stilar admin; ditt projekt äger fortfarande texten som visas i webbläsarfliken, rubriken och admin index.

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. Valfria 2FA-mallar

Om ditt projekt redan använder django-two-factor-auth, kan Vanta också tematisera dessa synliga skärmar. Den installerar, aktiverar eller konfigurerar inte tvåfaktorsautentisering åt dig.

settings.py

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

Kontrollera admin efter installationen

Starta ditt Django-projekt, öppna admin och verifiera inloggningsskärmen, sidofältet, ändringslistor, formulär, meddelanden och mobillayout. Temat förblir serverrenderat och ersätter inte Django admin beteende, behörigheter, webbadresser eller databasmodeller.

Visa källa