Asenna Vanta Admin Django-projektiisi

Lisää paketti, aseta teema ennen Django admin, kerää staattista sisältöä ja jatka jo tuntemasi admin:n käyttöä.

Paketti vanta-admin
Django sovellus vanta_admin
Paketin versioalue Python 3.12+ / Django 6.0–6.1

1. Asenna paketti

Käytä PyPI:tä normaaleihin projekteihin. Paketin nimi on vanta-admin.

uv
uv add vanta-admin
pip
pip install vanta-admin

2. Lisää Django-sovellus

Lisää vanta_admin kohtaan INSTALLED_APPS ennen django.contrib.admin. Tämä tilaus antaa Vantan admin-mallien override Django oletusasetukset.

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

3. Kerää staattisia tiedostoja

Suorita tavallinen Djangon collectstatic-komento ennen käyttöönottoa. Näin pakatut CSS-, JavaScript- ja favicon-tiedostot ovat käytettävissä staattisten tiedostojen määrityksessäsi.

uv-projekti
uv run python manage.py collectstatic
tavallinen Python
python manage.py collectstatic

4. Päivitä Vanta Admin

Ratkaise uusin Vanta Admin -julkaisu projektisi juuresta ja synkronoi ympäristö. Tämä toimii uv add vanta-admin normaalin rajoitteen kanssa.

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

5. Säilytä tuotemerkkisi

Vanta tyylittelee admin; projektisi omistaa edelleen tekstin, joka näkyy selaimen välilehdessä, otsikossa ja admin-hakemistossa.

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. Valinnaiset 2FA-mallit

Jos projektissasi on jo käytössä django-two-factor-auth, Vanta voi myös teemalla nämä näkyvät näytöt. Se ei asenna, ota käyttöön tai määritä kaksivaiheista todennusta puolestasi.

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

Tarkista admin asennuksen jälkeen

Aloita Django-projektisi, avaa admin ja tarkista kirjautumisnäyttö, sivupalkki, muutosluettelot, lomakkeet, viestit ja mobiiliasettelu. Teema pysyy palvelimen hahmontamana, eikä se korvaa Django admin -käyttäytymistä, käyttöoikeuksia, URL-osoitteita tai tietokantamalleja.

Näytä lähde