Привет, Хабр. Изучая безграничные просторы интернета интернета, заметил явное отсутствие обучающих статей на тему кастомизации админ‑панели в /Django/, а уж поверьте. Её довольно старое для современных рамок стилизация — не приговор. И делается это буквально в пару кликов, без лишнего .css кода. На который как раз таки гайдов полно. Зачем засорять папку со статическими файлами лишним кодом, если можно сделать это в пару кликов.

Главное преимущества /Python/, заключается в том, то что пишется на других язык программирования в десять строк, можно написать на нашем любимом языке в две строчки. Поэтому варианты с самостоятельной кастомизацией, затрагивать не будем. Хотя данная библиотека, не ограничивает вас в написание своего кода для кастомизации. Всё написанное, лишь подключенная библиотека на /Python/ для /Django/.

ВАЖНО! Инструкция применима, если у вас уже есть какой-либо проект на /Django/ и вы хотите более современную админ-панель под свой проект. Есть аналоги, но при использование именно этой библиотеки, я получил самое большое удовольствие. К тому же ставится она в пару кликов мышки, и имеет довольно гибкую систему, которая позволяет модифицировать её под свои нужды.

Так же важно понимать, что Unfold не заменяет стандартную админку Django, а стилизует её, добавляя новые возможности через:

• Кастомные шаблоны.

• CSS/JS на основе Tailwind CSS.

• JavaScript-логику для динамических элементов.

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

pip install django-unfold

После установки библиотеки. Мы можем наконец-то приступить к работе. Перейдем в директорию проекта, файл settings.py. Нам нужно сделать несколько поправок в файле настроек /Django/. Начнем с INSTALLED_APPS.

ОБЯЗАТЕЛЬНО СОХРАНЯЙТЕ ПОРЯДОК ПРИЛОЖЕНИЙ:

INSTALLED_APPS = [
    "unfold",  # Обязательно должно быть, перед django.contrib.admin
    "django.contrib.admin",
    # ... остальные приложения ...
]

Затем, нам нужно создать словарь, которая поможет вписать ваши настройки темы.

UNFOLD = {
    # Последний пункт, необязателен. Будут доступны все темы для админ-панели
    "SITE_TITLE": "Название вашего проекта",  # Заголовок в браузере
    "SITE_HEADER": "Админ-панель",           # Заголовок в шапке
    "SITE_ICON": "/static/logo.svg",         # Путь к логотипу (SVG/PNG)
    "THEME": "light",  # "light", "dark" или "auto" (автоопределение)
}

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

Так же она поддерживает любой язык, который поддерживает /Django/. В моем случае указано в settings.py — LANGUAGE_CODE="ru" и он перевел всю админ-панель на выбранный мною язык в настройках самого /Django/.

Библиотека довольно гибкая, лично для меня — это фаворит, если будет стоять выбор между комфортом и качеством. В пару кликов, можно изменить цветовую палитру админ-панил.

UNFOLD = {
    "COLORS": {
        "primary": {
            "50": "#f0fdf4",
            "100": "#dcfce7",
            # ... другие оттенки ...
        },
    },
}

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

Поэтому, давайте закончим перечислением плюсов данной билбиотеки.

• Современный UI

  • Минималистичный, но современный дизайн

  • Адаптивность (корректно отображается на мобильных устройствах).

• Темная/светлая тема

  • Автоматическое переключение.

  • Ручной выбор темы.

• Гибкая настройка

  • Изменение цветов, логотипа, заголовков.

  • Кастомизация сайдбара, верхнего меню, форм.

• Дополнительные компоненты

  • Улучшенные фильтры (unfold.contrib.filters).

  • Красивые формы (unfold.contrib.forms).

  • Поддержка Tabler Icons и Material Icons.

• Простота установки

  • Работает /из коробки/ без переписывания существующего кода.

Искренне надеюсь, то что помог людям, которые искали решение данной проблемы. Всем хорошего дня!