Написание вашего первого приложения Django, часть 7 ¶

Настройка формы администратора ¶

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

Давайте посмотрим, как это работает, изменив порядок полей в форме редактирования. Замените admin.site.register(Question)строку на:

from django.contrib import admin

from .models import Question


class QuestionAdmin(admin.ModelAdmin):
    fields = ['pub_date', 'question_text']

admin.site.register(Question, QuestionAdmin)

Вы будете следовать этому шаблону - создайте класс администратора модели, а затем передайте его в качестве второго аргумента admin.site.register()- каждый раз, когда вам нужно изменить параметры администратора для модели.

Это конкретное изменение выше делает «Дата публикации» перед полем «Вопрос»:

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

И, говоря о формах с десятками полей, вы можете разделить форму на наборы полей:

from django.contrib import admin

from .models import Question


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

admin.site.register(Question, QuestionAdmin)

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

Добавление связанных объектов ¶

Хорошо, у нас есть страница администратора вопросов, но у a Questionесть несколько Choices, а страница администратора не отображает варианты выбора.

Еще.

Есть два способа решить эту проблему. Первый - зарегистрироваться Choice у администратора, как мы это делали Question:

from django.contrib import admin

from .models import Choice, Question
# ...
admin.site.register(Choice)

Теперь «Выбор» доступен в админке Django. Форма «Добавить выбор» выглядит так:

В этой форме поле «Вопрос» представляет собой поле выбора, содержащее каждый вопрос в базе данных. Django знает, что a ForeignKeyдолжен быть представлен в админке в виде <select>поля. В нашем случае на данный момент существует только один вопрос.

Также обратите внимание на ссылку «Добавить еще» рядом с «Вопросом». Каждый объект, имеющий ForeignKeyотношение к другому, получает это бесплатно. Когда вы нажмете «Добавить еще», вы увидите всплывающее окно с формой «Добавить вопрос». Если вы добавите вопрос в это окно и нажмете «Сохранить», Django сохранит вопрос в базе данных и динамически добавит его в качестве выбранного варианта в форму «Добавить вариант», которую вы просматриваете.

Но на самом деле это неэффективный способ добавления Choiceобъектов в систему. Было бы лучше, если бы вы могли добавить кучу вариантов выбора непосредственно при создании Questionобъекта. Сделаем это.

Снимаем register()призыв к Choiceмодели. Затем отредактируйте Question регистрационный код, чтобы он читался:

from django.contrib import admin

from .models import Choice, Question


class ChoiceInline(admin.StackedInline):
    model = Choice
    extra = 3


class QuestionAdmin(admin.ModelAdmin):
    fieldsets = [
        (None,               {'fields': ['question_text']}),
        ('Date information', {'fields': ['pub_date'], 'classes': ['collapse']}),
    ]
    inlines = [ChoiceInline]

admin.site.register(Question, QuestionAdmin)

Это сообщает Django: « Choiceобъекты редактируются на Questionстранице администратора. По умолчанию достаточно полей для 3 вариантов ».

Загрузите страницу «Добавить вопрос», чтобы увидеть, как это выглядит:

Это работает следующим образом: есть три слота для связанных вариантов - как указано extra- и каждый раз, когда вы возвращаетесь на страницу «Изменить» для уже созданного объекта, вы получаете еще три дополнительных слота.

В конце трех текущих слотов вы найдете ссылку «Добавить еще один вариант». Если вы нажмете на нее, будет добавлен новый слот. Если вы хотите удалить добавленный слот, вы можете щелкнуть X в правом верхнем углу добавленного слота. На этом изображении показан добавленный слот:

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

class ChoiceInline(admin.TabularInline):
    #...

При этом TabularInline(вместо StackedInline) связанные объекты отображаются в более компактном табличном формате:

Обратите внимание, что есть дополнительная строка «Удалить?» столбец, который позволяет удалять строки, добавленные с помощью кнопки «Добавить другой вариант», и строки, которые уже были сохранены.

Настройте список изменений администратора ¶

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

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

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

class QuestionAdmin(admin.ModelAdmin):
    # ...
    list_display = ('question_text', 'pub_date')

Для удобства давайте также включим was_published_recently()метод из Урока 2 :

class QuestionAdmin(admin.ModelAdmin):
    # ...
    list_display = ('question_text', 'pub_date', 'was_published_recently')

Теперь страница со списком смены вопросов выглядит так:

Вы можете щелкнуть заголовки столбцов, чтобы отсортировать их по этим значениям, за исключением was_published_recentlyзаголовка, поскольку сортировка по выходным данным произвольного метода не поддерживается. Также обратите внимание, что заголовок столбца was_published_recentlyпо умолчанию - это имя метода (с символами подчеркивания, замененными пробелами), и что каждая строка содержит строковое представление вывода.

Вы можете улучшить это, используя display() декоратор для этого метода (in polls/models.py) следующим образом:

from django.contrib import admin

class Question(models.Model):
    # ...
    @admin.display(
        boolean=True,
        ordering='pub_date',
        description='Published recently?',
    )
    def was_published_recently(self):
        now = timezone.now()
        return now - datetime.timedelta(days=1) <= self.pub_date <= now

Дополнительные сведения о свойствах, настраиваемых с помощью декоратора, см list_display. В разделе .

Отредактируйте polls/admin.pyфайл еще раз и добавьте улучшение на Questionстраницу списка изменений: фильтры с использованием list_filter. Добавьте следующую строку QuestionAdmin:

list_filter = ['pub_date']

Это добавляет боковую панель «Фильтр», которая позволяет пользователям фильтровать список изменений по pub_dateполю:

Тип отображаемого фильтра зависит от типа поля, по которому вы фильтруете. Поскольку pub_dateэто a DateTimeField, Django знает, что нужно указать соответствующие параметры фильтра: «Любая дата», «Сегодня», «За последние 7 дней», «В этом месяце», «В этом году».

Это хорошо складывается. Добавим возможность поиска:

search_fields = ['question_text']

Это добавляет поле поиска вверху списка изменений. Когда кто-то вводит условия поиска, Django будет искать в этом question_textполе. Вы можете использовать столько полей, сколько захотите, хотя, поскольку он использует LIKEзапрос за кулисами, ограничение количества полей поиска разумным числом упростит поиск в вашей базе данных.

А теперь самое время отметить, что списки изменений дают вам бесплатную разбивку на страницы. По умолчанию на странице отображается 100 элементов. , , , , И все работают вместе , как вы думаете , что они должны.Change list paginationsearch boxesfiltersdate-hierarchiescolumn-header-ordering

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

Ясно, что «Администрирование Django» в верхней части каждой административной страницы просто смешно. Это просто текст-заполнитель.

Однако вы можете изменить его, используя систему шаблонов Django. Администратор Django работает на самом Django, а его интерфейсы используют собственную систему шаблонов Django.

TEMPLATES = [
    {
        'BACKEND': 'django.template.backends.django.DjangoTemplates',
        'DIRS': [BASE_DIR / 'templates'],
        'APP_DIRS': True,
        'OPTIONS': {
            'context_processors': [
                'django.template.context_processors.debug',
                'django.template.context_processors.request',
                'django.contrib.auth.context_processors.auth',
                'django.contrib.messages.context_processors.messages',
            ],
        },
    },
]

$ python -c "import django; print(django.__path__)"

... \> py -c "import django; print (django .__ path__)"

{% block branding %}
<h1 id="site-name"><a href="{% url 'admin:index' %}">Polls Administration</a></h1>
{% endblock %}

Настройте страницу индекса администратора ¶

Аналогичным образом вы можете захотеть настроить внешний вид страницы индекса администратора Django.

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

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

Что дальше? ¶

На этом урок для начинающих заканчивается. А пока вы можете узнать, что делать дальше .

Если вы знакомы с упаковкой Python и хотите узнать, как превратить опросы в «многоразовое приложение», ознакомьтесь с Расширенным руководством: Как писать многоразовые приложения .