Регистрация модели Post в админ панели Django

Администратор сайта должен иметь возможность управлять публикациями (например, удалять сообщения со спамом). Можно делать это через прямые запросы к базе, но не каждый админ на это способен.В Django предусмотрен графический интерфейс для администрирования любой модели: надо только подключить эту модель к админ-зоне. Так и поступим. Модели не добавляются в интерфейс админки автоматически, ведь не все они нужны администратору. По умолчанию в проекте уже есть множество моделей; вы видели, что в результате миграции в базу данных добавилось много таблиц. Но в интерфейсе админки видны только две модели: Groups и Users. Остальные модели — служебные, они не требуют внимания администратора и потому исключены из интерфейса. Чтобы добавить модель Post в интерфейс администратора, её надо зарегистрировать в файле posts/admin.py. Пока что файл posts/admin.py пуст:

from django.contrib import admin

# Register your models here.

Добавьте в него такой код:

from django.contrib import admin
# Из модуля models импортируем модель Post
from .models import Post

admin.site.register(Post)

Сохраните файл, перезагрузите страницу админки — и вы увидите новый раздел:

Все модели, зарегистрированные в admin.py определённого приложения, в админке будут отображаться в разделе этого приложения (при этом сама модель этому приложению может не принадлежать). Например, если зарегистрировать модель Post в admin.py приложения auth, подраздел Posts «переедет» в раздел Authentication and authorization. Перейдите в раздел Posts: там подготовлено место для списка постов и есть кнопка для создания новой публикации. При нажатии откроется форма для создания поста.

Создайте новый пост. Пишите что хотите; в нашем примере всего два слова: «Буду краток». С точки зрения разработчика создание нового поста — это создание нового объекта (экземпляра класса) Post. Но класс Post — это модель, так что свойства, переданные в экземпляр этого класса, станут записями в таблице БД, связанной с моделью. Поле «Автор» обязательно для заполнения. Если не указать автора, то система выдаст сообщение об ошибке. Но если сделать всё правильно, вы создадите на сайте новую запись:

В перечне публикаций строка Post object(1) выглядит некрасиво и неинформативно. Если таких записей будут десятки, то разобраться в постах будет невозможно. Сейчас мы настроим отображение списка получше.

Конфигурация модели в admin.py

Для настройки отображения модели в интерфейсе админки применяют класс ModelAdmin. Он связывается с моделью и конфигурирует отображение данных этой модели. В этом классе можно настроить параметры отображения. Полный список параметров есть в документации. В файле posts/admin.py создайте класс PostAdmin, наследующийся от admin.ModelAdmin, и зарегистрируйте его как источник конфигурации для модели Post. Теперь файл posts/admin.py должен выглядеть так:

from django.contrib import admin

from .models import Post

class PostAdmin(admin.ModelAdmin):
    # Перечисляем поля, которые должны отображаться в админке
    list_display = ('text', 'pub_date', 'author') 
    # Добавляем интерфейс для поиска по тексту постов
    search_fields = ('text',) 
    # Добавляем возможность фильтрации по дате
    list_filter = ('pub_date',) 

# При регистрации модели Post источником конфигурации для неё назначаем
# класс PostAdmin
admin.site.register(Post, PostAdmin)

Сохраните код, обновите страницу и посмотрите, что получилось.Столбцы таблицы в админке изменятся, добавится поле поиска и фильтрация постов по дате публикации. Django понимает, что свойство модели pub_date — это дата, и предложит несколько вариантов фильтрации.

Свойства, которые мы настроили:

list_display — перечень свойств модели, которые мы хотим показать в интерфейсе. Если это свойство не указано, будет отображаться строка Имя_модели(идентификатор), как было с записью Post(1).
search_fields — перечень полей, по которым будет искать поисковая система. Форма поиска отображается над списком элементов.
list_filter — поля, по которым можно фильтровать записи. Фильтры отображаются справа от списка элементов.

Помимо этих параметров, есть много других: например, для управления порядком отображения или количеством элементов на экране.

Пустое поле

В колонку text сейчас выводится содержимое поля text каждого поста. Этот текст — ссылка на форму просмотра и редактирования записи. Но что делать, если у модели нет описательного поля? Вдруг админ и-магазина не заполнит название товара или пост в блоге состоит только из картинки без подписи? Поле в админке окажется пустым, и у администратора не будет ссылки на страницу редактирования записи.Есть несколько способов обыграть эту ситуацию. Прежде всего, у каждой модели существует специальное свойство pk (сокращение от primary key, уникальный идентификатор записи в базе данных). Можно вывести primary key в интерфейс администратора:

class PostAdmin(admin.ModelAdmin):
    # Добавим в начало столбец pk
    list_display = ('pk', 'text', 'pub_date', 'author') 
    search_fields = ('text',) 
    list_filter = ('pub_date',)

В списке постов появится поле с номером записи в базе, каждая запись в админке получит уникальный ID. Другой способ: вместо пустого поля в строке можно подставлять какое-нибудь дефолтное значение, указав его в конфигурации модели:

class PostAdmin(admin.ModelAdmin):
    list_display = ('pk', 'text', 'pub_date', 'author') 
    search_fields = ('text',) 
    list_filter = ('pub_date',)
    # Это свойство сработает для всех колонок: где пусто — там будет эта строка 
    empty_value_display = '-пусто-'

Теперь слово «пусто» станет ссылкой, по которой админ может кликнуть, чтобы перейти на страницу редактирования поста.