Django プロジェクトに Vanta Admin をインストール

パッケージを追加し、テーマを Django admin の前に配置し、静的アセットを収集して、既知の admin を使い続けます。

PyPI パッケージ

Django admin

パッケージ vanta-admin

Django アプリ vanta_admin

パッケージの対応範囲 Python 3.12+ / Django 6.0–6.1

1. パッケージをインストールする

通常のプロジェクトには PyPI を使用します。パッケージ名はvanta-adminです。

uv add vanta-admin

pip

pip install vanta-admin

2. Django アプリを追加する

django.contrib.admin の前の INSTALLED_APPS に vanta_admin を追加します。 That ordering lets Vanta's admin templates override Django's defaults.

settings.py

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

3. 静的ファイルを収集する

デプロイする前に、通常の Django collectstatic コマンドを実行します。これにより、パッケージ化された CSS、JavaScript、favicon ファイルを静的ファイルの設定で利用できるようになります。

紫外線プロジェクト

uv run python manage.py collectstatic

標準 Python

python manage.py collectstatic

4. Vanta Admin を更新します

プロジェクトルートから、最新の Vanta Admin リリースを解決し、環境を同期します。これは、uv add vanta-admin の通常の制約で機能します。

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

pip

pip install --upgrade vanta-admin

5. ブランドを維持する

Vanta は admin のスタイルを設定します。プロジェクトは、ブラウザのタブ、ヘッダー、および admin インデックスに表示されるテキストを引き続き所有しています。

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. オプションの 2FA テンプレート

プロジェクトがすでに django-two-factor-auth を使用している場合、Vanta は表示されている画面のテーマも設定できます。 2 要素認証のインストール、有効化、構成は行われません。

settings.py

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

インストール後に admin を確認してください

Django プロジェクトを開始し、admin を開いて、ログイン画面、サイドバー、変更リスト、フォーム、メッセージ、モバイルレイアウトを確認します。テーマはサーバーでレンダリングされたままで、Django admin の動作、権限、URL、データベースモデルを置き換えません。

ソースを見る