Installieren Sie Vanta Admin in Ihrem Django-Projekt

Fügen Sie das Paket hinzu, platzieren Sie das Design vor Django admin, sammeln Sie statische Assets und verwenden Sie weiterhin das admin, das Sie bereits kennen.

PyPI Paket

Django admin

Paket vanta-admin

Django App vanta_admin

Paketbereich Python 3.12+ / Django 6.0–6.1

1. Installieren Sie das Paket

Verwenden Sie PyPI für normale Projekte. Der Paketname ist vanta-admin.

uv add vanta-admin

pip

pip install vanta-admin

2. Fügen Sie die App Django hinzu

Fügen Sie vanta_admin zu INSTALLED_APPS vor django.contrib.admin hinzu. Durch diese Reihenfolge können Vantas admin-Vorlagen override Django-Standardeinstellungen verwendet werden.

settings.py

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

3. Sammeln Sie statische Dateien

Führen Sie vor der Bereitstellung den üblichen Django-Befehl collectstatic aus. Dadurch werden die gebündelten CSS-, JavaScript- und Favicon-Dateien für Ihre Konfiguration statischer Dateien verfügbar.

UV-Projekt

uv run python manage.py collectstatic

Standard Python

python manage.py collectstatic

4. Vanta Admin aktualisieren

Lösen Sie von Ihrem Projektstamm aus die neueste Vanta Admin-Version auf und synchronisieren Sie die Umgebung. Dies funktioniert mit der normalen Einschränkung von uv add vanta-admin.

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

pip

pip install --upgrade vanta-admin

5. Behalten Sie Ihr Branding bei

Vanta gestaltet den admin; Ihr Projekt besitzt weiterhin den Text, der im Browser-Tab, in der Kopfzeile und im admin-Index angezeigt wird.

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. Optionale 2FA-Vorlagen

Wenn Ihr Projekt bereits django-two-factor-auth verwendet, kann Vanta auch diese sichtbaren Bildschirme thematisieren. Die Zwei-Faktor-Authentifizierung wird nicht für Sie installiert, aktiviert oder konfiguriert.

settings.py

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

Überprüfen Sie den admin nach der Installation

Starten Sie Ihr Django-Projekt, öffnen Sie das admin und überprüfen Sie den Anmeldebildschirm, die Seitenleiste, die Änderungslisten, Formulare, Nachrichten und das mobile Layout. Das Design bleibt vom Server gerendert und ersetzt nicht das Verhalten, die Berechtigungen, URLs oder Datenbankmodelle von Django admin.

Quelle ansehen