Beranda>Terkait pemrograman>Kode sumber lainnya
Unduh

django-admin-antarmuka

Django-Admin-Interface adalah antarmuka admin flat responsif modern yang dapat disesuaikan oleh admin itu sendiri .

Django-Admin-Interface-Preview

Fitur

  • Django-bertema default yang indah
  • Manajemen dan kustomisasi tema (Anda dapat menyesuaikan judul, logo, dan warna admin )
  • Responsif
  • Modal terkait (bukan jendela popup lama)
  • Nama/penanda lingkungan
  • Pemilih bahasa
  • Aplikasi lipat (akordeon di bilah navigasi)
  • Fieldset yang dapat dilipat dapat meluasnya keadaan awalnya bukannya runtuh
  • Inline NEW yang dapat dilipat
  • Fieldset dan inline tab NEW
  • Tautan Penghapusan Filter Daftar NEW
  • Daftar Filter NEW Sorot Opsi yang Dipilih
  • Daftar dropdown filter
  • Daftar filter lengket
  • Kontrol bentuk lengket (pagination dan simpan/hapus tombol)
  • Optimalisasi kompatibilitas / gaya untuk:
    • django-ckeditor
    • django-dynamic-raw-id
    • django-json-widget
    • django-modeltranslation
    • django-rangefilter
    • django-streamfield
    • django-tabbed-admin
    • sorl-thumbnail
  • Diterjemahkan dalam banyak bahasa: de , es , fa , fr , it , pl , pt_BR , ru , tr

Instalasi

  • Jalankan pip install django-admin-interface
  • Tambahkan admin_interface dan colorfield ke settings.INSTALLED_APPS sebelum django.contrib.admin 
 INSTALLED_APPS = (
    #...
    "admin_interface" ,
    "colorfield" ,
    #...
    "django.contrib.admin" ,
    #...
)

X_FRAME_OPTIONS = "SAMEORIGIN"
SILENCED_SYSTEM_CHECKS = [ "security.W019" ]
  • Jalankan python manage.py migrate
  • Jalankan python manage.py collectstatic --clear
  • Mulai ulang server aplikasi Anda

Peringatan

Jika Anda ingin menggunakan modal alih -alih jendela popup, pastikan untuk menambahkan pengaturan X_FRAME_OPTIONS = "SAMEORIGIN" .

Fitur opsional

Untuk membuat fieldset mulai diperluas dengan tombol Hide untuk runtuh, tambahkan kelas "expanded" ke kelasnya: 

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

Tema opsional

Paket ini dikirimkan dengan tema opsional sebagai perlengkapan, mereka dapat diinstal menggunakan perintah LoadData Admin. Tema opsional diaktifkan saat instalasi.

Tema django (default):

Jalankan python manage.py loaddata admin_interface_theme_django.json

Tema Bootstrap:

Jalankan python manage.py loaddata admin_interface_theme_bootstrap.json

Tema Yayasan:

Jalankan python manage.py loaddata admin_interface_theme_foundation.json

Tema Standar Desain Web AS:

Jalankan python manage.py loaddata admin_interface_theme_uswds.json

Tambahkan lebih banyak tema

Anda dapat menambahkan tema yang telah Anda buat melalui admin ke repositori ini dengan mengirimi kami PR. Berikut adalah langkah -langkah yang harus diikuti untuk ditambahkan:

  1. Ekspor tema persis Anda sebagai perlengkapan menggunakan perintah admin dumpdata : python manage.py dumpdata admin_interface.Theme --indent 4 -o admin_interface_theme_{{name}}.json --pks=N

  2. Salin file JSON yang dihasilkan ke folder Fixtures (pastikan namanya dimulai dengan admin_interface_theme_ untuk menghindari bentrokan dengan perlengkapan yang mungkin disediakan oleh aplikasi pihak ketiga lainnya) .

  3. Lepaskan pk dari fixture dan pastikan bidang active diatur ke true (dengan cara ini tema diaktifkan secara otomatis saat diinstal) .

  4. Edit bagian di atas untuk mendokumentasikan tema Anda.

Tambahkan dukungan tema ke perpustakaan pihak ketiga

Anda dapat menambahkan dukungan tema ke perpustakaan pihak ketiga yang ada menggunakan variabel CSS berikut:

Header

  • --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

Logo

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

Modul / tautan

  • --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

Tombol

  • --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

Modal terkait

  • --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

Tangkapan layar

Login Admin

Dasbor Admin

Manajemen Tema Admin

Kustomisasi Tema Admin

Lokalisasi

Saat ini, paket ini telah diterjemahkan ke dalam bahasa -bahasa berikut: de , es , fa , fr , it , pl , pt_BR , tr .

Terjemahkan ke dalam bahasa lain

  • Jalankan python -m django makemessages --ignore ".tox" --ignore "venv" --add-location "file" --extension "html,py" --locale "it" (contoh untuk lokalisasi Italia)

  • Perbarui terjemahan di admin_interface/locale/it/LC_MESSAGES/django.po

  • Jalankan python -m django compilemessages --ignore ".tox" --ignore "venv"

Perbarui terjemahan

Jika Anda melakukan beberapa perubahan pada proyek, ingatlah untuk memperbarui terjemahan, karena jika file terjemahan tidak terkini, langkah lint dalam CI akan gagal:

  • Jalankan tox -e translations

Caching

Paket ini menggunakan caching untuk meningkatkan waktu pemuatan tema dan kinerja keseluruhan. "default" dapat menyesuaikan opsi caching aplikasi menggunakan settings.CACHES["admin_interface"] . 

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

Peringatan

Ada masalah kompatibilitas yang diketahui saat menggunakan paket ini dengan django-redis , lebih khusus, menggunakan JSONSerializer kesalahan berikut ini dinaikkan: TypeError: Object of type Theme is not JSON serializable , untuk mengurangi masalah ini, cukup gunakan cache spesifik untuk aplikasi ini yang tidak menggunakan serializer json apa pun.

FAQ

base-site.html

Saya sudah memiliki base_site.html khusus, bagaimana cara membuatnya bekerja?

Anda dapat menggunakan Django-AppTemplates, lalu tambahkan {% extends "admin_interface:admin/base_site.html" %} ke base_site.html Anda

Peringatan LocaleMiddleware Kustom

Saya menggunakan django.middleware.locale.LocaleMiddleware subclass, tapi saya melihat peringatan yang tidak perlu karena hilang django.middleware.locale.LocaleMiddleware , apa yang bisa saya lakukan?

Anda bisa mengabaikan peringatan (ini telah dibahas di sini) 

 import warnings

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

Pemilih bahasa tidak menunjukkan

Saya telah mengaktifkan pemilih bahasa , tetapi tidak terlihat di admin, apa yang harus saya lakukan?

Anda harus mengonfigurasi settings dan urls multilanguage dengan benar: 

 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 ))

Buka URL di Jendela Modal

Saya memiliki aplikasi dengan beberapa tautan silang di admin dan saya ingin membukanya di jendela modal, bukan jendela yang sama/baru, bagaimana saya bisa melakukannya?

Anda hanya perlu menambahkan _popup=1 parameter string kueri ke URL: 

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

Pengujian 

 # 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 "

Berkontribusi

Kontribusi selalu diterima, silakan ikuti langkah -langkah ini untuk mengirimkan PR berkualitas baik:

  • ❗ Buka suatu masalah , tolong jangan mengirimkan PR apa pun yang tidak merujuk pada masalah yang ada.
  • Bekerja pada perubahan , perubahan sebaiknya dicakup oleh tes untuk menghindari regresi di masa depan.
  • Perbarui file terjemahan .
  • ? Jalankan tes memastikan bahwa tidak ada kesalahan.
  • ? Kirimkan permintaan tarik dan tandai sebagai "siap untuk ditinjau" hanya jika melewati CI .

Lisensi

Dirilis di bawah lisensi MIT.

Mendukung

  • Bintang Proyek ini di GitHub
  • Ikuti saya di GitHub
  • ? Ikuti saya di Twitter
  • ? Mensponsori saya di github

Lihat juga

  • django-cache-cleaner -Bersihkan seluruh cache atau cache individual dengan mudah menggunakan panel admin atau perintah manajemen. ?

  • django-colorfield -Bidang warna sederhana untuk model dengan pemisahan warna yang bagus di admin. ?

  • django-extra-settings -Konfigurasi dan kelola pengaturan tambahan yang diketik menggunakan hanya admin Django.

  • django-maintenance-mode -Menampilkan halaman kesalahan 503 saat mode pemeliharaan aktif. ?

  • django-redirects - Redirects dengan kontrol penuh. ↪️

  • django-treenode - Mungkin model / admin abstrak terbaik untuk barang -barang berbasis pohon Anda. ?

  • python-benedict -Dikt Subkelas dengan Dukungan KeyList/Keypath, pintasan I/O (Base64, CSV, JSON, Pickle, Plist, Query-String, Toml, XML, YAML) dan banyak utilitas.

  • python-codicefiscale - Encode/Decode Kode Fiskal Italia - Codifica/Decodifica del Codice Fiscale. ?? ?

  • python-fontbro - Operasi Font Friendly. ?

  • python-fsutil -Utilitas File-System untuk Devs Lazy. ? ‍♂️

Memperluas
Informasi Tambahan
Aplikasi Terkait
Direkomendasikan untuk Anda
Informasi Terkait Semua