[Django]管理サイト( Django Admin )を作成する

Python の Web アプリケーションフレームワークである Django には、管理サイト( admin )という機能があります。
この機能を使うことで作成したModelのデータの追加・変更削除ができるようになります。イメージとしてはマスタ管理機能があらかじめフレームワークから提供されているようなものだと思ってもらえればよいかと。

下記の記事で作成した環境をベースに管理サイトを作成していきたいと思います。

[Django] Web アプリケーションを構築する手順まとめ

Python の Web アプリケーションフレームワークである「 Django 」を利用して、アプリを作成する手順を書い...

[Django] Python 3系で MySQL に接続する方法について

Python 3系で Django を利用した際に、 MySQL に接続するのにちょっと苦労したので、その時の手順を記載...

[Django]ログイン認証できるようになるまでの実装手順まとめ

Python の Web アプリケーションフレームワークである「 Django 」を利用してログイン画面を作成していきま...

もし、 Django の環境がまだない方はこちらを参考にしていただければと思います。

環境
管理サイトへアクセスしてみる
管理サイトを日本語で表示する
管理サイトにモデルを追加する
管理サイトのモデルの一覧画面
1. 一覧画面のカスタマイズ
管理サイトのモデルの詳細画面
最後に

環境

Python : 3.5.1
Django : 1.10.5
MySQL : 5.5.42

管理サイトへアクセスしてみる

まずは、デフォルトの状態で管理サイトにアクセスしてみます。
Web アプリケーションを起動します。

$ python manage.py runserver
Performing system checks...

System check identified no issues (0 silenced).
March 28, 2017 - 08:54:19
Django version 1.10.5, using settings 'sample.settings'
Starting development server at http://127.0.0.1:8000/
Quit the server with CONTROL-C.

「 http://localhost:8000/admin/ 」にブラウザからアクセスします。

管理サイトのログイン画面が表示されるので、管理サイトへアクセス可能なユーザのユーザIDとパスワードを使ってログインします。

ログインすると Django の標準機能である「 Group 」だけが管理サイトからデータ編集可能な状態となっています。

ここに accounts アプリケーションの AuthUser モデルを追加していきたいと思います。
ただ、デフォルトの setting.py の状態では英語でメッセージなどが表示されるので、日本語で表示できるように設定を変更したいと思います。

管理サイトを日本語で表示する

settings.py を編集します。

# LANGUAGE_CODE = 'en-us'
LANGUAGE_CODE = 'ja'

# TIME_ZONE = 'UTC'
TIME_ZONE = 'Asia/Tokyo'

ついでなんで、タイムゾーンも変更しておきます。
もう一度管理サイトにアクセスすると、

管理サイトを日本語で表示できるようになりました！！

管理サイトにモデルを追加する

では、早速 accounts アプリケーションの AuthUser モデルを管理サイトに追加したいと思います。
accounts ディレクトリにある __init__.py と apps.py 、 admin.py を編集します。

__init__.py

default_app_config = 'accounts.apps.AccountsConfig'

apps.py

# -*- coding: utf-8 -*-
from __future__ import unicode_literals
from django.utils.encoding import python_2_unicode_compatible
from django.apps import AppConfig

@python_2_unicode_compatible
class AccountsConfig(AppConfig):
    name = 'accounts'
    verbose_name = 'アカウント管理'

admin.py

# -*- coding: utf-8 -*-
from __future__ import unicode_literals
from django.utils.encoding import python_2_unicode_compatible
from django.contrib import admin
from .models import AuthUser
from django.contrib.auth.hashers import make_password

@python_2_unicode_compatible
@admin.register(AuthUser)
class AuthUserAdmin(admin.ModelAdmin):
    def save_model(self, request, obj, form, change):
        """
        モデルの保存

        :param request: リクエストデータ
        :param obj: ユーザモデルオブジェクト
        :param form: フォーム
        :param change: 変更フラグ
        :return: なし
        """
        if change:
            user = AuthUser.objects.get(pk=obj.pk)
            if not user.password == obj.password:
                obj.password = make_password(obj.password)
        else:
            obj.password = make_password(obj.password)
        obj.save()

    list_display = ['username', 'last_name', 'first_name', 'email']
    ordering = ['username']

編集が終わったら再度、管理サイトにアクセスします。

「アカウント管理」というメニューが追加され、その下にユーザモデルが追加されれば成功です。

管理サイトのモデルの一覧画面

先ほど追加した AuthUser モデルの一覧画面はこんな感じになります。

この一覧に表示されている「ユーザID」「苗字」「名前」「メールアドレス」は、 admin.py の AuthUserAdmin で設定した「 list_display 」の値が反映されています。

表示順については、 admin.py の AuthUserAdmin で設定した「 ordering 」の値が反映されます。

管理サイトの一覧画面ではこのように、画面のカスタマイズが可能となっています。

カスタマイズ可能設定を記載しておきます。こちらを参考に自分が使いやすいようにカスタマイズしてみてもらえればと思います。

一覧画面のカスタマイズ

list_display：一覧画面に表示させる項目を指定する
- list_display = ['username', 'last_name', 'first_name', 'email']
list_display_links：デフォルトでは一番左側に表示された項目に詳細画面のリンクがつきますが、詳細画面へのリンクを付ける項目を変更することができます
- list_display_links = ['email']
ordering：ソート順を指定する
- ordering = ['username']