Įdiekite Vanta Admin savo Django projekte

Pridėkite paketą, įdėkite temą prieš Django admin, surinkite statinius išteklius ir toliau naudokite jau žinomą admin.

Paketas vanta-admin
Django programa vanta_admin
Paketo diapazonas Python 3.12+ / Django 6.0–6.1

1. Įdiekite paketą

Įprastiems projektams naudokite PyPI. Paketo pavadinimas yra vanta-admin.

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

2. Pridėkite „Django“ programą

Pridėkite vanta_admin prie INSTALLED_APPS prieš django.contrib.admin. Toks užsakymas leidžia Vantos admin šablonams override Django taikyti numatytuosius nustatymus.

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

3. Surinkite statinius failus

Prieš diegdami paleiskite įprastą Django komandą collectstatic. Taip supakuoti CSS, JavaScript ir favicon failai taps pasiekiami jūsų statinių failų sąrankoje.

uv projektas
uv run python manage.py collectstatic
standartinis Python
python manage.py collectstatic

4. Atnaujinti Vanta Admin

Iš savo projekto šaknies išspręskite naujausią Vanta Admin leidimą ir sinchronizuokite aplinką. Tai veikia su įprastu apribojimu iš uv add vanta-admin.

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

5. Išsaugokite savo prekės ženklą

Vanta stilius admin; jūsų projektui vis dar priklauso tekstas, rodomas naršyklės skirtuke, antraštėje ir administratoriaus rodyklėje.

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. Pasirenkami 2FA šablonai

Jei jūsų projektas jau naudoja django-two-factor-auth, Vanta taip pat gali pritaikyti šiuos matomus ekranus. Jis neįdiegia, neįgalina ir nekonfigūruoja dviejų veiksnių autentifikavimo.

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

Įdiegę patikrinkite admin

Pradėkite projektą Django, atidarykite admin ir patikrinkite prisijungimo ekraną, šoninę juostą, pakeitimų sąrašus, formas, pranešimus ir mobiliojo telefono išdėstymą. Tema lieka serveryje ir nepakeičia Django admin elgsenos, leidimų, URL ar duomenų bazės modelių.

Žiūrėti šaltinį