首页>编程相关>其他源码
下载

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
  • 在django.contrib.admin之前添加admin_interface和colorfield settings.INSTALLED_APPS 
 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 Admin命令安装它们。可选主题在安装时被激活。

Django主题（默认）：

运行python manage.py loaddata admin_interface_theme_django.json

Bootstrap主题：

运行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 admin命令将确切主题作为固定命令导出： 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"

更新翻译

如果您对项目进行了一些更改，请记住更新翻译，因为如果翻译文件不是最新的，则CI中的lint步骤将失败：

  • 运行tox -e translations

缓存

该软件包使用缓存来改善主题负载时间和整体性能。您可以使用settings.CACHES["admin_interface"]设置自定义应用程序缓存选项，否则将使用"default"缓存： 

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

警告

更具体地说，使用JSONSerializer提出以下错误时，将此包与django-redis一起使用时，存在已知的兼容性问题： TypeError: Object of type Theme is not JSON serializable ，可以减轻此问题，只是为此应用程序使用该应用程序的特定缓存，而该应用程序不使用任何json serialializerserializeers。

常问问题

自定义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

我在管理员中有一个带有一些交联的应用程序，我想在模态窗口而不是同一/新窗口中打开它们，该怎么办？

您只需要在URL中添加_popup=1查询弦参数： 

 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 "

贡献

始终欢迎捐款，请按照以下步骤提交高质量的PR：

  • ❗打开问题，请不要提交任何不参考现有问题的公关。
  • 在变化方面的工作，最好应通过测试涵盖变化，以避免将来回归。
  • 更新翻译文件。
  • ？运行测试确保没有错误。
  • ？提交拉普雷斯，并将其标记为“准备好审查”，仅当它通过CI 。

执照

根据MIT许可发布。

支持

  • 在Github上明星这个项目
  • 在Github上关注我
  • ？在Twitter上关注我
  • ？在github上赞助我

参见

  • django-cache-cleaner使用管理面板或管理命令轻松清除整个缓存或单个缓存。 ？

  • django-colorfield的简单颜色字段，在管理员中具有不错的颜色挑选。 ？

  • django-extra-settings仅使用Django Admin进行配置和管理键入的额外设置。

  • django-maintenance-mode - 显示维护模式打开时显示503错误页面。 ？

  • django-redirects完全控制的重定向。 ↪️

  • django-treenode可能是基于树的东西的最佳抽象模型 /管理员。 ？

  • python-benedict钥匙列表/键盘支持，I/O捷径（Base64，CSV，JSON，PICKLE，PLIST，PLIST，QUERY-String，Toml，XML，Yaml）和许多实用程序。

  • python-codicefiscale编码/解码意大利财政代码 - codifica/decodifica del codice Fiscale。 ？ ？

  • python-fontbro友好的字体操作。 ？

  • python-fsutil懒惰开发人员的文件系统实用程序。 ？‍♂️

展开
附加信息
相关应用
为您推荐
相关资讯 全部