Installa Vanta Admin nel tuo progetto Django

Aggiungi il pacchetto, posiziona il tema prima di Django admin, raccogli risorse statiche e continua a utilizzare admin che già conosci.

Pacchetto PyPI

Django admin

Pacchetto vanta-admin

Applicazione Django vanta_admin

Intervallo del pacchetto Python 3.12+ / Django 6.0–6.1

1. Installa il pacchetto

Usa PyPI per progetti normali. Il nome del pacchetto è vanta-admin.

uv add vanta-admin

pip

pip install vanta-admin

2. Aggiungi l'app Django

Aggiungi vanta_admin a INSTALLED_APPS prima di django.contrib.admin. Questo ordinamento consente ai modelli admin di Vanta di essere override Django predefiniti.

settings.py

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

3. Raccogli file statici

Esegui il consueto comando collectstatic di Django prima della distribuzione. In questo modo i file CSS, JavaScript e favicon inclusi nel pacchetto saranno disponibili nella configurazione dei file statici.

progetto UV

uv run python manage.py collectstatic

standard Python

python manage.py collectstatic

4. Aggiorna Vanta Admin

Dalla root del tuo progetto, risolvi la versione più recente di Vanta Admin e sincronizza l'ambiente. Funziona con il normale vincolo di uv add vanta-admin.

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

pip

pip install --upgrade vanta-admin

5. Mantieni il tuo marchio

Vanta definisce admin; il tuo progetto possiede ancora il testo mostrato nella scheda del browser, nell'intestazione e nell'indice 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. Modelli 2FA opzionali

Se il tuo progetto utilizza già django-two-factor-auth, Vanta può creare temi anche per quelle schermate visibili. Non installa, abilita o configura l'autenticazione a due fattori per te.

settings.py

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

Controllare admin dopo l'installazione

Avvia il tuo progetto Django, apri admin e verifica la schermata di accesso, la barra laterale, gli elenchi di modifiche, i moduli, i messaggi e il layout mobile. Il tema rimane visualizzato sul server e non sostituisce il comportamento, le autorizzazioni, gli URL o i modelli di database Django admin.

Visualizza fonte