首頁>編程相關>其他源碼
下載

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懶惰開發人員的文件系統實用程序。 ？ ‍♂️

展開
附加信息
相關應用
爲您推薦
相關資訊 全部