Instalirajte Vanta Admin u svoj Django projekat

Dodajte paket, postavite temu pre Django admina, prikupite statičke datoteke i nastavite da koristite admin koji već poznajete.

PyPI paket

Django admin

Paket vanta-admin

Django aplikacija vanta_admin

Podržane verzije Python 3.12+ / Django 6.0–6.1

1. Instalirajte paket

Instalirajte vanta-admin sa PyPI-ja pomoću uv-a ili pip-a.

uv add vanta-admin

pip

pip install vanta-admin

2. Dodajte Django aplikaciju

Dodajte vanta_admin u INSTALLED_APPS pre django.contrib.admin. Ovakav redosled omogućava da Vanta Admin template preuzmu Django podrazumevane vrednosti.

settings.py

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

3. Prikupite statičke datoteke

Pokrenite uobičajenu Django collectstatic komandu pre objavljivanja. Tako će upakovani CSS, JavaScript i favicon fajlovi biti dostupni u vašem podešavanju statičkih datoteka.

uv projekat

uv run python manage.py collectstatic

standardni Python

python manage.py collectstatic

4. Ažurirajte Vanta Admin

Da biste ažurirali paket pomoću uv-a, nadogradite vanta-admin u lockfile-u, a zatim sinhronizujte okruženje. Ako koristite pip, pokrenite komandu za nadogradnju ispod.

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

pip

pip install --upgrade vanta-admin

5. Zadržite svoj brend

Vanta menja izgled admina, ali vaš projekat i dalje određuje tekst prikazan u kartici pregledača, zaglavlju i admin indeksu.

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. Opcioni 2FA template-i

Ako vaš projekat već koristi django-two-factor-auth, Vanta može da primeni stil i na njegove vidljive ekrane. Neće umesto vas instalirati, uključiti niti konfigurisati dvofaktorsku autentifikaciju.

settings.py

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

Proverite admin nakon instalacije

Pokrenite Django projekat, otvorite admin i proverite ekran za prijavu, bočnu traku, changlist-e, obrasce, poruke i raspored na mobilnim uređajima. Vanta se i dalje prikazuje na serveru i ne menja ponašanje Django admina, dozvole, URL adrese ni modele baze podataka.

Pogledajte izvorni kod na GitHubu