Installer Vanta Admin i dit Django-projekt

Tilføj pakken, placer temaet før Django admin, saml statiske aktiver, og fortsæt med at bruge den admin, du allerede kender.

PyPI pakke

Django admin

Pakke vanta-admin

Django app vanta_admin

Pakkeområde Python 3.12+ / Django 6.0–6.1

1. Installer pakken

Brug PyPI til normale projekter. Pakkenavnet er vanta-admin.

uv add vanta-admin

pip

pip install vanta-admin

2. Tilføj appen Django

Tilføj vanta_admin til INSTALLED_APPS før django.contrib.admin. Den bestilling lader Vantas admin-skabeloner override Django's standardindstillinger.

settings.py

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

3. Saml statiske filer

Kør den sædvanlige Django-kommando collectstatic før implementeringen. Det gør de pakkede CSS-, JavaScript- og favicon-filer tilgængelige for din opsætning af statiske filer.

uv projekt

uv run python manage.py collectstatic

standard Python

python manage.py collectstatic

4. Opdater Vanta Admin

Fra din projektrod skal du løse den nyeste Vanta Admin-udgivelse og synkronisere miljøet. Dette fungerer med den normale begrænsning fra uv add vanta-admin.

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

pip

pip install --upgrade vanta-admin

5. Behold din branding

Vanta stiler admin; dit projekt ejer stadig teksten vist i browserfanen, overskriften og admin-indekset.

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. Valgfri 2FA skabeloner

Hvis dit projekt allerede bruger django-two-factor-auth, kan Vanta også tematisere disse synlige skærme. Det installerer, aktiverer eller konfigurerer ikke to-faktor-godkendelse for dig.

settings.py

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

Tjek admin efter installationen

Start dit Django-projekt, åbn admin, og bekræft loginskærmen, sidebjælken, ændringslister, formularer, beskeder og mobillayout. Temaet forbliver servergengivet og erstatter ikke Django admin adfærd, tilladelser, URL'er eller databasemodeller.

Se kilde