Installer Vanta Admin i Django-prosjektet ditt

Legg til pakken, plasser temaet før Django admin, samle statiske eiendeler, og fortsett å bruke adminen du allerede kjenner.

PyPI-pakke

Django admin

Pakke vanta-admin

Django-appen vanta_admin

Pakkeområde Python 3.12+ / Django 6.0–6.1

1. Installer pakken

Bruk PyPI for vanlige prosjekter. Pakkenavnet er vanta-admin.

uv add vanta-admin

pip

pip install vanta-admin

2. Legg til Django-appen

Legg til vanta_admin til INSTALLED_APPS før django.contrib.admin. Denne rekkefølgen lar Vantas admin maler override Django sine standardinnstillinger.

settings.py

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

3. Samle statiske filer

Kjør den vanlige Django-kommandoen collectstatic før du distribuerer. Da blir de pakkede CSS-, JavaScript- og favicon-filene tilgjengelige i oppsettet ditt for statiske filer.

uv prosjekt

uv run python manage.py collectstatic

standard Python

python manage.py collectstatic

4. Oppdater Vanta Admin

Fra prosjektroten din, løs den nyeste Vanta Admin-utgivelsen og synkroniser miljøet. Dette fungerer med den normale begrensningen fra uv add vanta-admin.

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

pip

pip install --upgrade vanta-admin

5. Behold merkevarebyggingen din

Vanta stiler adminen; prosjektet ditt eier fortsatt teksten som vises i nettleserfanen, overskriften og admin-indeksen.

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. Valgfrie 2FA-maler

Hvis prosjektet ditt allerede bruker django-two-factor-auth, kan Vanta også tematisere disse synlige skjermene. Den installerer, aktiverer eller konfigurerer ikke tofaktorautentisering for deg.

settings.py

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

Sjekk admin etter installasjonen

Start Django-prosjektet ditt, åpne admin og bekreft påloggingsskjermen, sidefeltet, endringslistene, skjemaene, meldingene og mobiloppsettet. Temaet forblir servergjengitt og erstatter ikke Django admin atferd, tillatelser, URL-er eller databasemodeller.

Se kilde