Admingo – настраиваемый шаблон панели администратора Django.

Основные особенности

📱 Адаптивный дизайн
🌙 Cветлая и тёмная темы
⚙️ Настройка шаблона
🔍 Настраиваемый поиск
📁 Упорядочивание приложений и моделей
🕵️‍♂️ Скрытие приложений и моделей
🍔 Сворачивание бокового меню
🔗 Поддержка внешних ссылок

Установка

1. Клонируйте репозиторий:

git clone https://github.com/khaustova/admingo.git

2. Добавьте приложение в список установленных приложений в файле settings.py, разместив его перед django.contrib.admin:

# django-project/settings.py
...

INSTALLED_APPS = [
    'admingo',
    'django.contrib.admin',
    ...
]

Настройка шаблона

Для настройки внешнего вида и поведения шаблона добавьте словарь ADMINGO_CUSTOMIZATION в файл настроек проекта settings.py и укажите в нём нужные параметры.

ADMINGO_CUSTOMIZATION = {
    # Название, , которое будет отображаться в боковой панели:
    'dashboard_name': 'Админпанель',

    # Заголовок главной страницы:
    'dashboard_title': 'Панель администратора',

    # Модель для поиска, поле которого находится в верхней навигации:
    'search_model': '',

    # Иконки для приложений в боковой панели. 
    # Если не указать, то будет использоваться стандартная иконка-круг:
    'sidebar_icons': {
        'auth.user': 'person', 
        'auth.group': 'groups',
    },

    # Приложения, которые будут скрыты в боковой панели и в списке приложений
    'hidden_apps': [],

    # Модели, которые будут скрыты в боковой панели и в списке приложений
    'hidden_models': [],

    # Порядок приложений и моделей в боковой панели и в списке приложений. 
    # Можно указать не все приложения, остальные будут отсортированы по алфавиту:
    'apps_order': [],
    
    # Дополнительные ссылки, которые будут отображены на боковой панели. 
    # Каждая ссылка представлена в виде списка словарей, где ключем является приложение,
    # а значением - список параметров этой ссылки:
    # {
    #   'app_label': [
    #       {
    #           'name': 'Название внутренней ссылки', 
    #           'url': '/admin/internal-link/', 
    #           'icon': 'circle'
    #       },
    #       {
    #           'name': 'Название внешней ссылки', 
    #           'url': 'https://external.link/', 
    #           'icon': 'circle'
    #       },
    #    ]
    # }
    'extra_links': [],
}

Иконки для боковой панели берутся из коллекции Material Symbols.

Пример конфигурации для блога

# django-project/settings.py
...

ADMINGO_CUSTOMIZATION = {
    'search_model': 'blog.article',
    'sidebar_icons': {
        'auth.user': 'person',
        'auth.group': 'groups',
        'blog.article': 'article',
        'blog.tag': 'bookmark',
        'blog.comment': 'chat',
        'manager.emailsubscription': 'email',
        'django_celery_results.taskresult': 'task',
    },
    'hidden_apps': [
        'admingo',
    ],
    'hidden_models': [
        'auth.group', 
        'django_celery_results.groupresult',
    ],
    'apps_order': [
        'blog.article', 
        'blog.tag', 
        'manager.emailsubscription', 
        'django_celery_results', 
        'auth',
    ],
    'extra_links': [
        {
            'manager': [
                {
                    'name': 'Документация', 
                    'admin_url': '/admin/doc/', 
                    'icon': 'description'
                },
                {
                    'name': 'Яндекс Метрика', 
                    'admin_url': 'https://metrika.yandex.ru/', 
                    'icon': 'monitoring'
                }
            ]
        },
    ],
}

Скриншоты

Страницы

Документация

Светлая тема

Авторизация