Создаём своё первое приложение с Django, часть 2

Продолжаем начатое в первой части учебника. Мы продолжим разрабатывать приложение для голосования и создадим интерфейс администратора.

Philosophy

Создание интерфейса администратора для добавления, изменения и удаления содержимого сайта – в основном скучная не креативная задача. Django значительно автоматизирует и упрощает эту задачу.

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

Интерфейс администратора не предназначен для использования пользователями. Он создан для менеджеров и администраторов сайта.

Запускаем сервер для разработки

Интерфейс администратора включен по умолчанию. Давайте запустим встроенный сервер для разработки и посмотрим на него.

Напомним, что сервер для разработки запускается следующим образом:

$ python manage.py runserver

Откроем “/admin/” локального домена в браузере – например, http://127.0.0.1:8000/admin/. Вы должны увидеть страницу авторизации интерфейса администратора:

Django admin login screen

Т.к. translation включен по умолчанию, страница авторизации может быть на вашем родном языке, зависит от настроек браузера и наличия перевода для вашего языка.

Doesn’t match what you see?

Если вместо страницы авторизации вы получили ошибку:

ImportError at /admin/
cannot import name patterns
...

значит вы используете неверную версию Django. Смотрите учебник для используемой версии или обновите Django.

Заходим в интерфейс администратора

Теперь авторизируемся. Вы создали суперпользователя в первой части учебника, помните? Если вы этого не сделали или забыли пароль, создайте еще одного.

Настроим главную страницу интерфейса администратора:

Django admin index page

Вы должны увидеть несколько разделов: группы и пользователи. Они предоставлены приложением авторизации Django django.contrib.auth.

Добавим приложение голосования в интерфейс администратора

А где же наше приложение голосования? Оно не отображается в интерфейсе администратора.

Нам нужно указать, что объекты модели Poll могут редактироваться в интерфейсе администратора. Для этого создадим файл polls/admin.py, и отредактируем следующим образом:

from django.contrib import admin
from polls.models import Poll

admin.site.register(Poll)

Изучим возможности интерфейса администратора

После регистрации модели Poll Django отобразит ее на главной странице:

Django admin index page, now with polls displayed

Нажмите “Polls”. Вы попали на страницу “списка объектов” для голосований. Эта страница содержит все объекты из базы данных и позволяет выбрать один из них для редактирования. Мы видим голосование “What’s up?”, которое создали в первой части учебника:

Polls change list page

Нажмите “What’s up?” чтобы отредактировать его:

Editing form for poll object

Заметим:

  • Поля формы формируются на основе описания модели Poll.

  • Для различных типов полей модели (DateTimeField, CharField) используются соответствующие HTML поля. Каждое поле знает как отобразить себя в интерфейсе администратора.

  • К полям DateTimeField добавлен JavaScript виджет. Для даты добавлена кнопка “Сегодня” и календарь, для времени добавлена кнопка “Сейчас” и список распространенных значений.

В нижней части страницы мы видим несколько кнопок:

  • Save – сохранить изменения и вернуться на страницу списка объектов.

  • Save and continue editing – сохранить изменения и снова загрузить страницу редактирования текущего объекта.

  • Save and add another – Сохранить изменения и перейти на страницу создания нового объекта.

  • Delete – Показывает страницу подтверждения удаления.

Если значение “Date published” не совпадает с временем создания объекта в первой части учебника, возможно вы не верно определили настройку TIME_ZONE. Измените ее и перезагрузите страницу.

Измените “Date published” нажав “Today” и “Now”. Затем нажмите “Save and continue editing.” Теперь нажмите “History” в правом верхнем углу страницы. Вы увидите все изменения объекта сделанные через интерфейс администратора, время изменений и пользователя, который их сделал:

History page for poll object

Настройка формы

Потратим несколько минут чтобы полюбоваться кодом, который нам не пришлось писать самостоятельно. После регистрации модели Poll используя admin.site.register(Poll), Django создал форму для модели. Скорее всего вам захочется изменить ее. Вы можете это сделать используя параметры при регистрации модели.

Вот как это работает. Давайте поменяем порядок полей в форме. Замените admin.site.register(Poll) на:

from django.contrib import admin
from polls.models import Poll

class PollAdmin(admin.ModelAdmin):
    fields = ['pub_date', 'question']

admin.site.register(Poll, PollAdmin)

Создаем объект ModelAdmin и предаем его в admin.site.register().

Теперь поле “Publication date” отображается перед полем “Question”:

Fields have been reordered

Для нескольких полей это выглядит не очень внушительно, но при большом количестве полей порядок может значительно повысить удобство.

Для форм с большим количеством полей можно разбить форму на группу полей:

from django.contrib import admin
from polls.models import Poll

class PollAdmin(admin.ModelAdmin):
    fieldsets = [
        (None,               {'fields': ['question']}),
        ('Date information', {'fields': ['pub_date']}),
    ]

admin.site.register(Poll, PollAdmin)

Первый элемент кортежа в fieldsets – название группы полей. Вот как будет выглядеть наша форма:

Form has fieldsets now

Вы можете добавить HTML классы для каждой группы полей. Django предоставляет класс "collapse", который отображает группу полей изначально скрытой. Это полезно, если форма содержит поля, которые редко редактируются:

from django.contrib import admin
from polls.models import Poll

class PollAdmin(admin.ModelAdmin):
    fieldsets = [
        (None,               {'fields': ['question']}),
        ('Date information', {'fields': ['pub_date'], 'classes': ['collapse']}),
    ]
Fieldset is initially collapsed

Настройка страницы списка объектов

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

Вот как она выглядит сейчас:

Polls change list page

По умолчанию Django отображает результат выполнения str() для каждого объекта. Но чаще всего хочется показывать список полей. Для этого используйте параметр list_display, который является кортежем состоящим из названий полей модели:

class PollAdmin(admin.ModelAdmin):
    # ...
    list_display = ('question', 'pub_date')

Для примера давайте еще и добавим метод was_published_recently из Части 1 учебника:

class PollAdmin(admin.ModelAdmin):
    # ...
    list_display = ('question', 'pub_date', 'was_published_recently')

Теперь страница списка объектов Poll выглядит следующим образом:

Polls change list page, updated

Вы можете нажать на заголовок колонки чтобы отсортировать записи по полю – но не для was_published_recently, так как сортировка по методу не поддерживается. Название колонки для was_published_recently по умолчанию равно названию метода (нижние подчеркивание заменяется на пробелы), а значение равно строковому представлению результата выполнения метода.

Вы можете исправить это добавив несколько атрибутов (в polls/models.py) этому методу:

class Poll(models.Model):
    # ...
    def was_published_recently(self):
        return self.pub_date >= timezone.now() - datetime.timedelta(days=1)
    was_published_recently.admin_order_field = 'pub_date'
    was_published_recently.boolean = True
    was_published_recently.short_description = 'Published recently?'

Отредактируем файл polls/admin.py снова и добавим на страницу Фильтры. Добавьте следующую строку в PollAdmin:

list_filter = ['pub_date']

Это добавляет “Фильтр” по полю pub_date в боковой панели:

Polls change list page, updated

Тип фильтра зависит от типа поля. Так как pub_date является DateTimeField, Django отображает соответствующие варианты для фильтрации: “Any date,” “Today,” “Past 7 days,” “This month,” “This year.”

Теперь добавим поиск:

search_fields = ['question']

Это добавляет поле для поиска в верхней части страницы. При вводе запроса, Django будет искать по полю question. Вы можете использовать любое количество полей – учтите что используется запрос LIKE, так что постарайтесь не перегрузить вашу базу данных.

Страница списка объектов также содержит постраничное отображение. По умолчанию отображается 100 объектов на страницу.

Настраиваем внешний вид

“Django administration” в “шапке” страницы выглядит нелепо. Это просто замещающий текст.

Его очень легко заменить, используя систему шаблонов Django. Интерфейс администратора работает благодаря Django и использует систему шаблонов Django.

Переопределение шаблонов проекта

Создайте каталог templates в каталоге проекта. Шаблоны могут располагаться где угодно, главное чтобы Django имел доступ к ним. (Django запускается под юзером, под которым запущен сервер.) Но мы советуем располагаеть шаблоны внутри проекта.

Откройте файл настроек (напомним это mysite/settings.py) и найдите настройку TEMPLATE_DIRS:

TEMPLATE_DIRS = [os.path.join(BASE_DIR, 'templates')]

TEMPLATE_DIRS являет собой итерируемый объект путей к каталогам, который указывает Django будет искать шаблоны.

Теперь создайте каталог admin в каталоге templates, и скопируйте шаблон admin/base_site.html из встроенных шаблонов в исходниках Django (django/contrib/admin/templates) в этот каталог.

Where are the Django source files?

Если вы не знаете где лежат исходники Django, выполните следующую команду:

python -c "
import sys
sys.path = sys.path[1:]
import django
print(django.__path__)"

Отредактируйте файл и замените текст по умолчанию на название вашего сайта.

Этот шаблон содержит текст подобный {% block branding %} и {{ title }}. Теги {% и {{ – это части синтаксиса системы шаблонов Django. При выполнении шаблона admin/base_site.html Django создаст HTML страницу. Не волнуйтесь если ничего не понимаете в этом – в шаблонах Django мы разберемся в Части 3.

Любой шаблон интерфейса администратора можно переопределить. Чтобы переопределить шаблон, сделайте тоже что и с base_site.html – скопируйте его в каталог с шаблонами проекта и внесите изменения.

Кастомизация шаблонов приложения

Внимательные читатели спросят: если TEMPLATE_DIRS пустая по умолчанию, как Django находит шаблоны интерфейса администратора по умолчанию? Django пытается найти шаблон в подкаталоге templates/ каждого приложении, если шаблон не найден другим способом, а как мы знаем, django.contrib.admin это приложение.

Наше приложение простое и не требует переопределения шаблонов. Но если оно станет большим и сложным, и нам понадобится изменить его шаблоны, логичнее изменить шаблоны для приложения, а не для проекта. В таком случае вы сможете добавить приложения для голосования в любой проект и переопределенные шаблоны будут работать.

Смотрите раздел о загрузке шаблонов, чтобы узнать как Django ищет шаблоны.

Настроим главную страницу

Возможно вам понадобится настроить главную страницу интерфейса администратора.

По умолчанию она показывает все приложения в алфавитном порядке из настройки INSTALLED_APPS, которые зарегистрированы в интерфейсе администратора. Главная страница очень важна и должна быть удобной.

Для главной страницы используется шаблон admin/index.html. (Сделайте тоже что и с шаблоном admin/base_site.html из раздела выше – скопируйте его из приложения Django в каталог шаблонов проекта.) Откройте файл и вы увидите использование переменной app_list. Эта переменная содержит все отображаемые приложения. Вместо нее вы можете явно указать ссылки на нужные страницы. Опять же, не волнуйтесь что вы ничего не понимаете, шаблоны будут обсуждаться в Части 3.

Если вы освоили интерфейс администратора, переходите к третьей части этого учебника.