Django Admin — バックエンドで記事を管理
この章では、Django Admin を設定して、フロントエンドのコードを書かなくてもコンテンツ管理バックエンドを利用できるようにします。
Admin とは何か?
Django AdminDjango の最も強力な組み込み機能の1つです:モデルを登録するだけで、完全なバックエンド管理システムが自動的に生成されます。
バックエンドは記事の追加・削除・変更・検索(CRUD)、検索、フィルタリング、ページネーションなどの機能を提供するため、自分で CRUD コードを書く必要はありません。
スーパーユーザーを作成する
まず、バックエンドにログインするための管理者アカウントを作成する必要があります:
(venv) $ python manage.py createsuperuser 用户名:admin 电子邮件地址:admin@example.com Password: # 输入密码(不会回显) Password (again): # 重复密码 Superuser created successfully.
サーバーを起動後、http://127.0.0.1:8000/admin/ にアクセスし、先ほど作成したアカウントでログインします。
(venv) $ python manage.py runserver
Admin にモデルを登録する
開くblog/admin.py、Post と Category モデルを登録します。
例
from django.contrib import admin
from .models import Category, Post
# カテゴリモデルを登録:最も簡単な登録方法
@admin.register(Category)
class CategoryAdmin(admin.ModelAdmin):
# 一覧ページに表示する列
list_display = ['name', 'slug']
# 記事モデルを登録:カスタム設定付き
@admin.register(Post)
class PostAdmin(admin.ModelAdmin):
# 一覧ページに表示する列
list_display = ['title', 'category', 'created_at', 'updated_at']
# 右側のフィルターバー:カテゴリと時間でフィルタリング
list_filter = ['category', 'created_at']
# 上部の検索ボックス:タイトルと概要で検索
search_fields = ['title', 'summary']
# 公開日時の階層ナビゲーション(年 → 月 → 日)
date_hierarchy = 'created_at'
# 1ページあたり20件のレコードを表示
list_per_page = 20
admin.py の主要設定の説明
| 設定項目 | 型 | 機能 |
|---|---|---|
| list_display | リスト | リストページに表示するフィールドを指定する |
| list_filter | リスト | 右側にフィルタサイドバーを追加する |
| search_fields | リスト | 上部に検索ボックスを追加する |
| date_hierarchy | 文字列 | 日付の階層ナビゲーション |
| list_per_page | 数値 | 1ページあたりのページネーション数(デフォルト 100) |
バックエンドのページを更新し、左側の「記事」をクリックすると、完全なリスト、フィルタリング、検索機能を確認できます。
Admin を使ってテストデータを入力する
「記事を追加」ボタンをクリックし、フォームにタイトル、概要、本文を入力します。
カテゴリフィールドは、作成済みの Category から自動的に選択肢を取得します(ForeignKey が設定されているため)。
異なるカテゴリをカバーする記事を少なくとも5件入力し、後続の章でリストとフィルタリング効果を確認できるようにします。
Admin のフォームフィールドの順序は models.py のフィールド定義の順序と同じです。順序を調整したい場合は、Admin クラスで設定できます。
fields = ['title', 'category', ...]明示的に配置を指定します。
リッチテキスト編集(任意の拡張)
デフォルトの本文入力ボックスはプレーンテキストボックスなので、HTML の入力はあまり便利ではありません。
インストールできますdjango-summernoteこれにより、WYSIWYGのリッチテキストエディタが得られます:
(venv) $ pip install django-summernote
例
INSTALLED_APPS = [
# ...
'django_summernote', # アプリを登録
]
# サポートするファイルアップロードサイズ制限(任意)
SUMMERNOTE_CONFIG = {
'summernote': {
'width': '100%',
'height': '480',
}
}
次に、Admin で content フィールドを Summernote エディタに変更します:
例
from django_summernote.admin import SummernoteModelAdmin
@admin.register(Post)
class PostAdmin(SummernoteModelAdmin): # SummernoteModelAdmin を継承
list_display = ['title', 'category', 'created_at']
list_filter = ['category']
search_fields = ['title', 'summary']
summernote_fields = ['content'] # content フィールドでリッチテキストエディタを使用
これで記事を編集するとき、本文エリアは完全なリッチテキストエディタになり、レイアウト、画像挿入、フォーマット調整ができます。
django-summernoteこれは任意です。サードパーティのライブラリをインストールしたくない場合は、プレーンテキストボックスで HTML を書き続けても問題ありません。本チュートリアルの以降のコードは、Summernote のインストール有無とは関係ありません。
Admin インターフェースの中国語化
settings.py で設定すると、LANGUAGE_CODE = 'zh-hans'Admin インターフェースは自動的に中国語に切り替わります。
モデル定義のverbose_nameパラメータは Admin フォームのフィールドラベルに使用されます。
本章のまとめ
この章では、Django Admin バックエンドを設定しました:スーパーユーザーの作成、モデルの登録、リスト表示・検索・フィルタリングの設定、任意でリッチテキストエディタの導入。
これで、ブラウザで記事コンテンツを直感的に管理でき、Shell に入って手動でデータを入力する必要はありません。
その他の拡張