Использование встроенной админ-панели
Мы уже научились проектировать модели, выполнять миграции и выводить данные в шаблоны. Но пока для добавления записей в базу приходится писать SQL-запросы или использовать консоль Python. В реальной разработке для управления контентом нужен графический интерфейс.
В Django эта задача решена «из коробки». Мы изучим один из самых мощных инструментов фреймворка — встроенную админ-панель.
Что такое админ-панель Django
Админ-панель Django — это готовый интерфейс для администраторов сайта. Она позволяет создавать, редактировать и удалять записи в базе данных без написания кода.
Шаг 1. Создание суперпользователя
Доступ к панели закрыт по умолчанию. Чтобы войти, создайте суперпользователя (superuser) — аккаунт с полными правами.
Откройте терминал в папке проекта, активируйте виртуальное окружение и введите:
python manage.py createsuperuser
Система попросит указать:
- Username: имя (например,
admin). - Email address: можно пропустить (нажать Enter).
- Password: пароль. Символы при вводе не отображаются — это стандарт безопасности.
Запустите сервер командой python manage.py runserver и перейдите по адресу http://127.0.0.1:8000/admin/. Введите данные, которые только что создали.
Шаг 2. Регистрация моделей
После входа вы увидите стандартные разделы «Группы» и «Пользователи», но ваших моделей (например, «Товары») там не будет. Чтобы они появились, нужна регистрация модели.
Все настройки интерфейса хранятся в файле admin.py внутри вашего приложения. Django не отображает модели автоматически: мы должны явно указать, какие таблицы хотим редактировать.
Пример регистрации модели Product:
# shop/admin.py
from django.contrib import admin
from .models import Product
# Самый простой способ регистрации
admin.site.register(Product)Обновите страницу в браузере. Теперь в админке появился раздел вашего приложения. Вы можете добавлять товары, и они сразу сохранятся в базе данных.
Шаг 3. Настройка отображения через метод __str__
Если просто зарегистрировать модель, в списке объектов отобразится невнятное Product object (1). Чтобы видеть понятные названия, добавьте метод __str__ в файл models.py.
# shop/models.py
from django.db import models
class Product(models.Model):
name = models.CharField(max_length=200)
price = models.DecimalField(max_digits=10, decimal_places=2)
def __str__(self):
# Теперь в списке будет отображаться название товара
return self.nameШаг 4. Профессиональная настройка через ModelAdmin
Для тонкой настройки интерфейса используют класс ModelAdmin. Он определяет, какие колонки показывать в таблице, какие добавить фильтры и по каким полям искать записи.
В современной разработке для этого применяют декоратор @admin.register.
Реализуем расширенный интерфейс, как показано в Сравнении 1:
# shop/admin.py
from django.contrib import admin
from .models import Product
@admin.register(Product)
class ProductAdmin(admin.ModelAdmin):
# Колонки в списке товаров
list_display = ('name', 'price', 'created_at', 'is_active')
# Боковая панель с фильтрами
list_filter = ('is_active', 'created_at')
# Поля для поиска
search_fields = ('name', 'description')
# Редактирование прямо в списке (без перехода в карточку товара)
list_editable = ('price', 'is_active')Безопасность в реальных проектах
В крупных проектах стандартный адрес /admin/ часто меняют на секретный (например, /staff-only/), чтобы защититься от ботов, подбирающих пароли. Это делается в файле urls.py проекта.
- Создайте суперпользователя в своем проекте.
- Зарегистрируйте основную модель в
admin.pyчерез декоратор@admin.register. - Настройте
list_display(минимум 3 поля) иsearch_fields. - Добавьте 3–5 записей через интерфейс и проверьте, как работает метод
__str__.
Админ-панель помогает быстро проверить работу моделей. Однако она генерирует формы автоматически. В следующем уроке мы научимся создавать веб-формы самостоятельно, чтобы обычные пользователи могли регистрироваться или оформлять заказы на вашем сайте.