Instalați Vanta Admin în proiectul dvs. Django

Adăugați pachetul, plasați tema înainte de Django admin, colectați elemente statice și continuați să utilizați admin pe care îl cunoașteți deja.

Pachetul PyPI

Django admin

Pachet vanta-admin

Aplicația Django vanta_admin

Intervalul pachetului Python 3.12+ / Django 6.0–6.1

1. Instalați pachetul

Utilizați PyPI pentru proiecte normale. Numele pachetului este vanta-admin.

uv add vanta-admin

pip

pip install vanta-admin

2. Adăugați aplicația Django

Adăugați vanta_admin la INSTALLED_APPS înainte de django.contrib.admin. Această ordine permite admin şabloanelor override Django ale lui Vanta.

settings.py

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

3. Colectați fișiere statice

Rulați comanda obișnuită collectstatic din Django înainte de implementare. Astfel, fișierele CSS, JavaScript și favicon împachetate devin disponibile în configurația de fișiere statice.

proiect UV

uv run python manage.py collectstatic

Python standard

python manage.py collectstatic

4. Actualizați Vanta Admin

De la rădăcina proiectului, rezolvați cea mai nouă versiune Vanta Admin și sincronizați mediul. Aceasta funcționează cu constrângerea normală de la uv add vanta-admin.

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

pip

pip install --upgrade vanta-admin

5. Păstrează-ți brandingul

Vanta stilează admin; proiectul dvs. deține în continuare textul afișat în fila browserului, antet și indexul 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. Șabloane 2FA opționale

Dacă proiectul dvs. folosește deja django-two-factor-auth, Vanta poate tema și acele ecrane vizibile. Nu instalează, activează sau configurează autentificarea cu doi factori pentru dvs.

settings.py

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

Verificați admin după instalare

Începeți proiectul Django, deschideți admin și verificați ecranul de conectare, bara laterală, listele de modificări, formularele, mesajele și aspectul mobil. Tema rămâne redată pe server și nu înlocuiește comportamentul Django admin, permisiunile, adresele URL sau modelele de baze de date.

Vizualizați sursa