Installeer Vanta Admin in je Django-project

Voeg het pakket toe, plaats het thema vóór Django admin, verzamel statische items en blijf de admin gebruiken die u al kent.

PyPI-pakket

Django admin

Pakket vanta-admin

Django-app vanta_admin

Pakketbereik Python 3.12+ / Django 6.0–6.1

1. Installeer het pakket

Gebruik PyPI voor normale projecten. De pakketnaam is vanta-admin.

uv add vanta-admin

pip

pip install vanta-admin

2. Voeg de Django-app toe

Voeg vanta_admin toe aan INSTALLED_APPS vóór django.contrib.admin. Door deze volgorde kunnen de admin-sjablonen van Vanta de standaardwaarden van override Django gebruiken.

settings.py

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

3. Verzamel statische bestanden

Voer vóór het implementeren de gebruikelijke Django-opdracht collectstatic uit. Hierdoor zijn de verpakte CSS-, JavaScript- en favicon-bestanden beschikbaar in uw configuratie voor statische bestanden.

uv-project

uv run python manage.py collectstatic

standaard-Python

python manage.py collectstatic

4. Vanta Admin bijwerken

Los vanuit de hoofdmap van je project de nieuwste Vanta Admin-release op en synchroniseer de omgeving. Dit werkt met de normale beperking van uv add vanta-admin.

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

pip

pip install --upgrade vanta-admin

5. Behoud je branding

Vanta geeft de admin vorm; je project blijft eigenaar van de tekst in het browsertabblad, de koptekst en de adminindex.

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. Optionele 2FA-templates

Als je project django-two-factor-auth al gebruikt, kan Vanta ook die zichtbare schermen vormgeven. Het installeert, activeert of configureert geen two-factor-authenticatie voor je.

settings.py

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

Controleer de admin na installatie

Start uw Django-project, open de admin en verifieer het inlogscherm, de zijbalk, de wijzigingslijsten, formulieren, berichten en de mobiele lay-out. Het thema blijft door de server weergegeven en vervangt het gedrag, de rechten, URL's of databasemodellen van Django admin niet.

Broncode bekijken