Django-allauthでテンプレートを上書きするには、account配下にテンプレートを作成する

概要

• Django-allauthでテンプレートを上書きするには、account/login.htmlのように、account配下にテンプレートを作成します。
  • プロジェクトフォルダ内で管理できるので、venv/lib/python3.6/site-packages/allauth/account/templatesにあるファイルを書き換えずにすみ、Gitなどでバージョン管理する際に楽です。
• 環境は、Python 3.6.9 + Django 3.1.1 + django-allauth 0.32.0 で確認しました。

内容

• 例えばログイン画面のaccount_loginというURLは、account/login.htmlというテンプレートに対応しています。
• この名前でテンプレートを作成すれば、デフォルトのテンプレートを上書きすることができます。
  • 公式サイトの Templates にも記載があります。
  • URLとテンプレートファイルの対応は、公式サイトの Views にあります。

具体例

• settings.pyファイルのTEMPLATESのDIRSで、テンプレートディレクトリを指定します
  • 例：manage.pyと同じ階層にtemplatesというフォルダを作ってそこに入れる場合

TEMPLATES = [
    {
        'BACKEND': 'django.template.backends.django.DjangoTemplates',
        'DIRS': [
            os.path.join(BASE_DIR, 'templates'),  # この行を追加
        ],
        (略)
    }
]

• 上記のtemplatesフォルダ内に、account/login.htmlを作成します

$ mkdir -p templates/account/
$ echo "<h1>this is login template...</h1>" > templates/account/login.html

• ブラウザで確認します

  • http://localhost:8000/account/login/

• 上記以外の画面では、デフォルトのテンプレートのままなことを確認します

  • http://localhost:8000/account/signup/

「account」という名前は固定

• 「account」という名前は固定です。
  • INSTALLED_APPS にも'allauth.account',を追加していますし、
  • python3 manage.py showmigrations すると、accountというテーブルへのマイグレーションができているのがわかります。
    • 公式サイトのViewsでは、accountsとaccountが混在しているのが気になります。。。(後でPR出しておきます)