Главная страница>Связанные с программированием>Другой исходный код
Скачать

Django-admin-интерфейс

Django-Admin-Interface-это современный отзывчивый плоский интерфейс администратора, настраиваемый самим администратором .

Django-admin-interface-preview

Функции

  • Красивая по умолчанию Django-Theme
  • Управление темами и настройка (вы можете настроить заголовок администратора, логотип и цвета )
  • Отзывчивый
  • Связанный модал (вместо старого всплывающего окна)
  • Название среды/маркер
  • Языковой выбор
  • Складные приложения (аккордеоны в панели навигации)
  • Складные полевые наборы могут расширить свое начальное состояние, а не обрушиться
  • NEW складные веретки
  • NEW вкладки и вставки
  • NEW ссылки на удаление фильтра списка
  • NEW список фильтра выделяет выбранные параметры
  • Раскрытие фильтра списка
  • Список фильтра липкой
  • Форма управления липкими (кнопки литчика и сохранения/удаления)
  • Совместимость / оптимизация стиля для:
    • django-ckeditor
    • django-dynamic-raw-id
    • django-json-widget
    • django-modeltranslation
    • django-rangefilter
    • django-streamfield
    • django-tabbed-admin
    • sorl-thumbnail
  • Перевод на многих языках: de , es , fa , fr , it , pl , pt_BR , ru , tr

Установка

  • Запустить pip install django-admin-interface
  • Добавить admin_interface и colorfield в settings.INSTALLED_APPS перед django.contrib.admin 
 INSTALLED_APPS = (
    #...
    "admin_interface" ,
    "colorfield" ,
    #...
    "django.contrib.admin" ,
    #...
)

X_FRAME_OPTIONS = "SAMEORIGIN"
SILENCED_SYSTEM_CHECKS = [ "security.W019" ]
  • Запустить python manage.py migrate
  • Запустить python manage.py collectstatic --clear
  • Перезагрузите сервер приложений

Предупреждение

Если вы хотите использовать модалы вместо всплывающих окон, убедитесь, что добавить настройку X_FRAME_OPTIONS = "SAMEORIGIN" .

Дополнительные функции

Чтобы запустить поля, запускаемое с помощью кнопки Hide для коллапса, добавьте класс "expanded" к его классам: 

 class MyModelAdmin ( admin . ModelAdmin ):
    # ...
    fieldsets = [
        ( "Section title" , {
            "classes" : ( "collapse" , "expanded" ),
            "fields" : (...),
        }),
    ]
    # ...

Необязательные темы

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

Джанго тема (по умолчанию):

Запустить python manage.py loaddata admin_interface_theme_django.json

Тема начальной загрузки:

Запустить python manage.py loaddata admin_interface_theme_bootstrap.json

Фонд Тема:

Запустить python manage.py loaddata admin_interface_theme_foundation.json

Тема стандартов веб -дизайна США:

Запустить python manage.py loaddata admin_interface_theme_uswds.json

Добавьте больше тем

Вы можете добавить тему, которую вы создали через администратора в этот репозиторий, отправив нам PR. Вот шаги, чтобы следовать, чтобы добавить:

  1. Экспортируйте свою точную тему в качестве приспособления, используя команду администратора dumpdata : python manage.py dumpdata admin_interface.Theme --indent 4 -o admin_interface_theme_{{name}}.json --pks=N

  2. Скопируйте сгенерированный файл json в папку светильников (убедитесь, что его имя начинается с admin_interface_theme_ , чтобы избежать столкновений с помощью светильников, которые могут быть предоставлены другими сторонними приложениями) .

  3. Удалите pk из прибора и убедитесь, что active поле установлено на true (таким образом, тема автоматически активируется при установке) .

  4. Отредактируйте раздел выше, чтобы документировать вашу тему.

Добавить поддержку темы сторонним библиотекам

Вы можете добавить поддержку темы в существующие сторонние библиотеки, используя следующие переменные CSS :

Заголовок

  • --admin-interface-header-background-color
  • --admin-interface-header-text-color
  • --admin-interface-header-link-color
  • --admin-interface-header-link_hover-color
  • --admin-interface-title-color
  • --admin-interface-env-color

Логотип

  • --admin-interface-logo-color
  • --admin-interface-logo-default-background-image
  • --admin-interface-logo-max-width
  • --admin-interface-logo-max-height

Модули / ссылки

  • --admin-interface-module-background-color
  • --admin-interface-module-background-selected-color
  • --admin-interface-module-border-radius
  • --admin-interface-module-text-color
  • --admin-interface-module-link-color
  • --admin-interface-module-link-selected-color
  • --admin-interface-module-link-hover-color
  • --admin-interface-generic-link-color
  • --admin-interface-generic-link-hover-color
  • --admin-interface-generic-link-active-color

Кнопки

  • --admin-interface-save-button-background-color
  • --admin-interface-save-button-background-hover-color
  • --admin-interface-save-button-text-color
  • --admin-interface-delete-button-background-color
  • --admin-interface-delete-button-background-hover-color
  • --admin-interface-delete-button-text-color

Связанный модал

  • --admin-interface-related-modal-background-color
  • --admin-interface-related-modal-background-opacity
  • --admin-interface-related-modal-border-radius
  • --admin-interface-related-modal-close-button-display

Скриншоты

Администратор. Вход

Административная панель

Управление темами администраторов

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

Локализация

На данный момент этот пакет был переведен на следующие языки: de , es , fa , fr , it , pl , pt_BR , tr .

Перевести на другой язык

  • Запустите python -m django makemessages --ignore ".tox" --ignore "venv" --add-location "file" --extension "html,py" --locale "it" (пример для локализации итальянской локализации)

  • Обновление переводов в admin_interface/locale/it/LC_MESSAGES/django.po

  • Запустить python -m django compilemessages --ignore ".tox" --ignore "venv"

Обновление переводов

Если вы внесете некоторые изменения в проект, не забудьте обновлять переводы, потому что, если файлы переводов не являются актуальными, шаг lint в CI потерпит неудачу:

  • Запустить tox -e translations

Кэширование

Этот пакет использует кэширование для улучшения времени загрузки темы и общей производительности. Вы можете настроить параметры кэширования приложения, используя настройку settings.CACHES["admin_interface"] "default" 

 CACHES = {
    # ...
    "admin_interface" : {
        "BACKEND" : "django.core.cache.backends.locmem.LocMemCache" ,
        "TIMEOUT" : 60 * 5 ,
    },
    # ...
}

Предупреждение

При использовании этого пакета с django-redis существует известная проблема совместимости, используя JSONSerializer Следующая ошибка поднята: TypeError: Object of type Theme is not JSON serializable , чтобы смягчить эту проблему, просто используйте конкретный кэш для этого приложения, которое не использует сериализатор json .

Часто задаваемые вопросы

Пользовательский base-site.html

У меня уже есть пользовательская base_site.html , как я могу заставить его работать?

Вы можете использовать django-apptemplates, затем добавить {% extends "admin_interface:admin/base_site.html" %} в свой base_site.html

Пользовательское предупреждение LocaleMiddleware

Я использую подкласс django.middleware.locale.LocaleMiddleware , но я вижу ненужное предупреждение о пропущенном django.middleware.locale.LocaleMiddleware , что я могу сделать?

Вы можете просто игнорировать предупреждение (это обсуждалось здесь) 

 import warnings

warnings . filterwarnings ( "ignore" , module = "admin_interface.templatetags.admin_interface_tags" )

Выбор языка не показывает

Я включил выбор языка , но он не виден в администраторе, что мне делать?

Вы должны правильно настроить settings и urls с несколькими языками: 

 LANGUAGES = (
    ( "en" , _ ( "English" )),
    ( "it" , _ ( "Italiano" )),
    ( "fr" , _ ( "Français" )),
    # more than one language is expected here
)
LANGUAGE_CODE = "en"
USE_I18N = True
MIDDLEWARE = [
    # ...
    "django.middleware.locale.LocaleMiddleware" ,
    # ...
]
 from django . conf . urls . i18n import i18n_patterns
from django . contrib import admin
from django . urls import include , path

# ...

urlpatterns = [
    path ( "i18n/" , include ( "django.conf.urls.i18n" )),
]
urlpatterns += i18n_patterns ( path ( "admin/" , admin . site . urls ))

Откройте любой URL в модальном окне

У меня есть приложение с некоторыми поперечными связями в администраторе, и я хотел бы открыть их в модальных окнах вместо того же/нового окна, как я могу сделать?

Вам просто нужно добавить _popup=1 параметр строки запросов в URL: 

 url = reverse ( f"admin:myapp_mymodel_change" , args = [ mymodel_instance . pk ])
url = f" { url } ?_popup=1"

Тестирование 

 # clone repository
git clone https://github.com/fabiocaccamo/django-admin-interface.git && cd django-admin-interface

# create virtualenv and activate it
python -m venv venv && . venv/bin/activate

# upgrade pip
python -m pip install --upgrade pip

# install requirements
pip install -r requirements.txt -r requirements-test.txt

# install pre-commit to run formatters and linters
pre-commit install --install-hooks

# run tests
tox
# or
python runtests.py
# or
python -m django test --settings " tests.settings "

Внося

Взносы всегда приветствуются, пожалуйста, следуйте этим шагам для подачи хорошего качества PRS:

  • ❗ Откройте проблему , пожалуйста, не отправляйте ни одного PR, который не относится к существующей проблеме.
  • Работая над изменениями , изменения должны быть предпочтительно покрыты тестами, чтобы избежать регрессий в будущем.
  • Обновите файлы переводов .
  • ? Запустите тесты, гарантируя, что ошибки нет.
  • ? Отправьте запрос и отметьте его как «готовый к рассмотрению», только если он пройдет CI .

Лицензия

Выпущено по лицензии MIT.

Поддержка

  • Светь этот проект на GitHub
  • Следуй за мной на GitHub
  • ? Следуй за мной в Твиттере
  • ? Спонсировать меня на GitHub

Смотрите также

  • django-cache-cleaner -легко очистите весь кэш или отдельные кэши, используя панель администратора или команду управления. ?

  • django-colorfield -простое цветовое поле для моделей с красивым цветом в администраторе. ?

  • django-extra-settings -конфигурация и управление напечатанными дополнительными настройками, используя только администратор Django.

  • django-maintenance-mode -показывает страницу ошибки 503, когда включен режим обслуживания. ?

  • django-redirects - перенаправления с полным контролем. ↪

  • django-treenode - вероятно, лучшая абстрактная модель / администратор для ваших деревьев. ?

  • python-benedict -DICT Subclass с поддержкой ключа/клавиш, сочетания ввода/вывода (Base64, CSV, JSON, Pickle, Plist, Query String, Toml, XML, YAML) и многие утилиты.

  • python-codicefiscale - Encode/Decode Итальянские фискальные коды - Codifica/Decodifica del Codice Fiscale. ?? ?

  • python-fontbro - дружелюбные операции шрифта. ?

  • python-fsutil -Утилиты файловой системы для ленивых разработчиков. ? ‍♂️

Расширять
Дополнительная информация
Связанные приложения
Рекомендуем вам
Связанные новости Все