Django Admin でモデルを登録する方法：ステップバイステップガイド

Django でウェブサイトやアプリケーションを構築する際、データベースモデルが実際に動作するのはエキサイティング瞬間です。しかし、Django Admin パネルを使用すると、データの入力、編集、削除などの管理が簡単になります。

モデルを作成するだけでは、Admin パネルに表示されません。Admin パネルに表示させるには、モデルを登録する必要があります。このガイドでは、Django Admin でモデルを登録する方法を、コード例を用いてステップごとに説明します。

Django Admin の重要性

Django Admin は、ウェブサイトのバックエンドの個人用ダッシュボードのようなものです。モデルを登録すると、コードに触れることなくアプリのコンテンツを管理できます。

例えば、新しいブログ記事の追加、ユーザーの承認、製品リストの更新などを数回クリックするだけで実現できます。Django Admin の優れた点はここにあります。モデルを適切に登録しないと、手作業で管理することになり、すぐに煩雑になります。また、Django Admin を使用すると、開発者の作業時間を大幅に節約できます。

モデルの登録方法

ステップ 1：モデルの作成

まず、モデルが必要です。blog という名前のアプリ内の基本的なモデルの例を次に示します。

# blog/models.py
from django.db import models

class Post(models.Model):
    title = models.CharField(max_length=200)
    body = models.TextField()
    date_created = models.DateTimeField(auto_now_add=True)

    def __str__(self):
        return self.title

このモデルでは、

• title は短いテキストフィールドです。
• body は長いコンテンツ用です。
• date_created は、記事が作成された時刻を自動的に保存します。
• __str__ メソッドは、Admin で Post を表示する方法を Django に指示します。

各投稿を "Post object (1)" のように表示する代わりに、投稿のタイトルを表示します。Admin インターフェイスをより使いやすく、理解しやすくするために、__str__ メソッドをモデルに追加することを強くお勧めします。

ステップ 2：Admin でモデルを登録

モデルの準備ができたので、Admin でモデルを登録しましょう。

blog/admin.py を開きます。新しい Django アプリを作成すると、このファイルはデフォルトで空になります。Post モデルを登録する方法を次に示します。

# blog/admin.py
from django.contrib import admin
from .models import Post

admin.site.register(Post)

処理内容：

• まず、Django の admin モジュールをインポートします。
• 次に、モデル（Post）をインポートします。
• 最後に、admin.site.register() を使用して、Django に "このモデルを Admin パネルに表示したい" と伝えます。

ファイルを保存します。Admin サイト（通常は http://127.0.0.1:8000/admin）にアクセスすると、Posts が表示されます。

ステップ 3: (オプション) 管理画面でのモデルの表示をカスタマイズする

デフォルトでは、Django Admin は非常に基本的なテーブルでモデルを表示します。しかし、少しカスタマイズするだけでより良くすることができます。ここでは、タイトルの登録日時を表示する方法を紹介します。

# blog/admin.py
from django.contrib import admin
from .models import Post

class PostAdmin(admin.ModelAdmin):
    list_display = ('title', 'date_created')

admin.site.register(Post, PostAdmin)

この例では：

• list_display は、リストビューに表示するフィールドを Django に指示します。
• PostAdmin クラスを作成して、Post モデルが Admin でどのように動作するかを記述します。
• 登録時に、モデル ( Post ) と管理クラス ( PostAdmin ) の両方を渡します。

Admin をカスタマイズすると、特に多くのエントリを管理している場合にワークフローが大幅に向上します。

よくある質問

1. モデルを追加しましたが、Admin に表示されません。なぜですか？

以下を確認してください。

• admin.py 内でモデルを登録しましたか。
• モデルを変更した場合は、migration を実行しましたか（python manage.py makemigrations と python manage.py migrate）。
• settings.py 内の INSTALLED_APPS にアプリがリストされていることを確認してください。

2. すべてのモデルを個別に登録する必要がありますか？

はい。Admin で管理するモデルごとに登録が必要です。ただし、複数のモデルをまとめて登録することもできます。

from .models import Post, Comment, Category
admin.site.register([Post, Comment, Category])

3. モデルの登録を解除するにはどうすればよいですか？

from django.contrib import admin
from .models import Post
admin.site.unregister(Post)

ほとんどの場合、必要がなくなったら登録を停止するだけで済みます。

まとめ

Django Admin でのモデルの登録は小さなステップのように思えるかもしれませんが、データの操作方法に大きな影響を与えます。これにより、データベースが、技術者以外のユーザーでも使用できる使いやすいダッシュボードに変わります。モデルの登録とカスタマイズに慣れてしまえば、より迅速に作業を進め、アプリをより細かく制御できるようになります。