К плану
Урок
12+

Использование встроенной админ-панели

Мы уже научились проектировать модели, выполнять миграции и выводить данные в шаблоны. Но пока для добавления записей в базу приходится писать SQL-запросы или использовать консоль Python. В реальной разработке для управления контентом нужен графический интерфейс.

В Django эта задача решена «из коробки». Мы изучим один из самых мощных инструментов фреймворка — встроенную админ-панель.

Что такое админ-панель Django

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

Шаг 1. Создание суперпользователя

Доступ к панели закрыт по умолчанию. Чтобы войти, создайте суперпользователя (superuser) — аккаунт с полными правами.

Откройте терминал в папке проекта, активируйте виртуальное окружение и введите:

python manage.py createsuperuser

Система попросит указать:

  1. Username: имя (например, admin).
  2. Email address: можно пропустить (нажать Enter).
  3. 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 проекта.

  1. Создайте суперпользователя в своем проекте.
  2. Зарегистрируйте основную модель в admin.py через декоратор @admin.register.
  3. Настройте list_display (минимум 3 поля) и search_fields.
  4. Добавьте 3–5 записей через интерфейс и проверьте, как работает метод __str__.

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

Сохраните прогресс в Telegram.Продолжить в Telegram