الصفحة الرئيسية>المتعلقة بالبرمجة>شفرة المصدر الأخرى
تنزيل

Django-admin-Interface

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 django.contrib.admin settings.INSTALLED_APPS . 
 INSTALLED_APPS = (
    #...
    "admin_interface" ,
    "colorfield" ,
    #...
    "django.contrib.admin" ,
    #...
)

X_FRAME_OPTIONS = "SAMEORIGIN"
SILENCED_SYSTEM_CHECKS = [ "security.W019" ]
  • تشغيل python manage.py migrate
  • Run python manage.py collectstatic --clear
  • أعد تشغيل خادم التطبيق الخاص بك

تحذير

إذا كنت ترغب في استخدام Midals بدلاً من Windows المنبثقة ، فتأكد من إضافة إعداد X_FRAME_OPTIONS = "SAMEORIGIN" .

ميزات اختيارية

لجعل مجموعة الحقول توسع مع زر Hide للانهيار ، أضف الفئة "expanded" إلى فصولها: 

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

موضوعات اختيارية

تشحن هذه الحزمة مع سمات اختيارية كإعدادات ، يمكن تثبيتها باستخدام أمر admin LoadData. يتم تنشيط السمات الاختيارية عند التثبيت.

موضوع 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

أضف المزيد من الموضوعات

يمكنك إضافة سمة قمت بإنشائها من خلال المسؤول إلى هذا المستودع عن طريق إرسال العلاقات العامة لنا. فيما يلي خطوات متابعة لإضافة:

  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 .

ترجمة إلى لغة أخرى

  • Run python -m django makemessages --ignore ".tox" --ignore "venv" --add-location "file" --extension "html,py" --locale "it" (مثال على التوطين الإيطالي)

  • تحديث الترجمات في admin_interface/locale/it/LC_MESSAGES/django.po

  • Run 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 جيدة الجودة:

  • ❗ افتح مشكلة ، يرجى عدم تقديم أي علاقات عامة لا تشير إلى مشكلة موجودة.
  • العمل على التغييرات ، ويفضل أن تتم تغطية التغييرات عن طريق اختبارات لتجنب الانحدارات في المستقبل.
  • تحديث ملفات الترجمات .
  • ؟ إجراء اختبارات ضمان عدم وجود أخطاء.
  • ؟ أرسل طلب السحب ووضع علامة عليه على أنه "جاهز للمراجعة" فقط إذا كان يمر CI .

رخصة

صدر تحت رخصة معهد ماساتشوستس للتكنولوجيا.

دعم

  • نجم هذا المشروع على جيثب
  • اتبعني على جيثب
  • ؟ اتبعني على Twitter
  • ؟ راعيني على جيثب

انظر أيضا

  • django-cache-cleaner قم بمسح ذاكرة التخزين المؤقت بالكامل أو ذاكرة التخزين المؤقت الفردية بسهولة باستخدام لوحة المسؤول أو أمر الإدارة. ؟

  • django-colorfield حقل ألوان بسيط للموديلات مع مراكز ألوان لطيفة في المشرف. ؟

  • django-extra-settings تكوين وإدارة إعدادات إضافية مكتوبة باستخدام مسؤول Django فقط.

  • django-maintenance-mode يعرض صفحة خطأ 503 عند تشغيل وضع الصيانة. ؟

  • django-redirects - إعادة توجيه مع التحكم الكامل. ↪

  • django-treenode - ربما أفضل طراز / مسؤول تجريدي لأشياءك القائمة على الأشجار. ؟

  • python-benedict الفئة الفرعية DICT مع دعم Keylist/Keypath ، اختصارات I/O (BASE64 ، CSV ، JSON ، PEACLE ، PLIST ، BLIST ، QUERY-BRY ، TOML ، XML ، YAML) والعديد من الأدوات المساعدة.

  • python-codicefiscale - تشفير/فك شفرة الرموز المالية الإيطالية - Codifica/decodifica del codice fiscale. ؟ ؟

  • python-fontbro - عمليات الخطوط الودية. ؟

  • python-fsutil مرافق نظام الملفات للديفات الكسول. ؟ ‍

يوسع
معلومات إضافية
تطبيقات ذات صلة
نوصي لك
أخبار ذات صلة الكل