Inicio>Relacionado con la programación>Otro código fuente
Descargar

interfaz django-admin

La interfaz Django-Admin es una interfaz de administrador plana de respuesta moderna personalizable por el propio administrador .

Django-admin-interfaz-preview

Características

  • Hermoso thema de django predeterminado
  • Gestión de temas y personalización (puede personalizar el título de administración, el logotipo y los colores )
  • Sensible
  • Modal relacionado (en lugar de la antigua ventana emergente)
  • Nombre/marcador del entorno
  • Selector de idiomas
  • Aplicaciones plegables (acordeones en la barra de navegación)
  • Los campos plegables pueden expandirse su estado inicial en lugar de colapsar
  • NEW incrustaciones plegables
  • NEW campos de campos y incrustaciones
  • NEW enlaces de eliminación de filtros de lista
  • NEW filtro de lista resalta las opciones seleccionadas
  • Descipiente del filtro de la lista
  • Filtro de lista Sticky
  • Formulario Controla Sticky (botones de paginación y guardado/eliminación)
  • Optimizaciones de compatibilidad / estilo para:
    • django-ckeditor
    • django-dynamic-raw-id
    • django-json-widget
    • django-modeltranslation
    • django-rangefilter
    • django-streamfield
    • django-tabbed-admin
    • sorl-thumbnail
  • Traducido en muchos idiomas: de , es , fa , fr , it , pl , pt_BR , ru , tr

Instalación

  • Ejecutar pip install django-admin-interface
  • Agregue admin_interface y colorfield a settings.INSTALLED_APPS antes de django.contrib.admin 
 INSTALLED_APPS = (
    #...
    "admin_interface" ,
    "colorfield" ,
    #...
    "django.contrib.admin" ,
    #...
)

X_FRAME_OPTIONS = "SAMEORIGIN"
SILENCED_SYSTEM_CHECKS = [ "security.W019" ]
  • Ejecutar python manage.py migrate
  • Ejecutar python manage.py collectstatic --clear
  • Reinicie su servidor de aplicaciones

Advertencia

Si desea usar modales en lugar de ventanas emergentes, asegúrese de agregar X_FRAME_OPTIONS = "SAMEORIGIN" .

Características opcionales

Para hacer que un campos comience a expandirse con un botón Hide para colapsar, agregue la clase "expanded" a sus clases: 

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

Temas opcionales

Este paquete se envía con temas opcionales como accesorios, se pueden instalar utilizando el comando LoadData Admin. Los temas opcionales se activan en la instalación.

Tema Django (predeterminado):

Ejecutar python manage.py loaddata admin_interface_theme_django.json

Tema de bootstrap:

Ejecutar python manage.py loaddata admin_interface_theme_bootstrap.json

Tema de la base:

Ejecutar python manage.py loaddata admin_interface_theme_foundation.json

Tema de estándares de diseño web de EE. UU.:

Ejecutar python manage.py loaddata admin_interface_theme_uswds.json

Agregar más temas

Puede agregar un tema que ha creado a través del administrador a este repositorio enviándonos un PR. Aquí están los pasos a seguir para agregar:

  1. Exporte su tema exacto como accesorio utilizando el comando dumpdata Admin: python manage.py dumpdata admin_interface.Theme --indent 4 -o admin_interface_theme_{{name}}.json --pks=N

  2. Copie el archivo JSON generado en la carpeta de accesorios (asegurándose de que su nombre comience con admin_interface_theme_ para evitar enfrentamientos con accesorios que podrían proporcionar otras aplicaciones de terceros) .

  3. Retire el pk del accesorio y asegúrese de que el campo active esté configurado en true (de esta manera, se activa automáticamente un tema cuando se instala) .

  4. Edite la sección anterior para documentar su tema.

Agregar soporte de tema a las bibliotecas de terceros

Puede agregar soporte de tema a las bibliotecas de terceros existentes utilizando las siguientes variables CSS :

Encabezamiento

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

Módulos / enlaces

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

Botones

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

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

Capturas de pantalla

Inicio de sesión de administrador

Tablero de administración

Gestión de temas de administrador

Personalización de temas de administración

Localización

Por el momento, este paquete se ha traducido a los siguientes idiomas: de , es , fa , fr , it , pl , pt_BR , tr .

Traducir a otro idioma

  • Ejecutar python -m django makemessages --ignore ".tox" --ignore "venv" --add-location "file" --extension "html,py" --locale "it" (ejemplo para la localización italiana)

  • Actualizar traducciones en admin_interface/locale/it/LC_MESSAGES/django.po

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

Actualizar traducciones

Si realiza algunos cambios en el proyecto, recuerde actualizar las traducciones, porque si los archivos de traducciones no están actualizados, el paso lint en el CI fallará:

  • Ejecutar tox -e translations

Almacenamiento en caché

Este paquete utiliza almacenamiento en caché para mejorar el tiempo de carga del tema y el rendimiento general. Puede personalizar las opciones de almacenamiento en caché de la aplicación usando la configuración settings.CACHES["admin_interface"] , de lo contrario se utilizará el caché "default" : 

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

Advertencia

Existe un problema de compatibilidad conocido cuando se usa este paquete con django-redis , más específicamente, utilizando el JSONSerializer se plantea el siguiente error: TypeError: Object of type Theme is not JSON serializable , para mitigar este problema, simplemente use un caché específico para esta aplicación que no usa ningún serializador json .

Preguntas frecuentes

base-site.html Custom.html

Ya tengo una base_site.html personalizada, ¿cómo puedo hacer que funcione?

Puede usar django-appSplates, luego agregar {% extends "admin_interface:admin/base_site.html" %} a su base_site.html

ADVERTENCIA LocaleMiddleware

Estoy usando una subclase django.middleware.locale.LocaleMiddleware , pero veo una advertencia innecesaria para faltar django.middleware.locale.LocaleMiddleware , ¿qué puedo hacer?

Simplemente puede ignorar la advertencia (esto se ha discutido aquí) 

 import warnings

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

El selector de idiomas no se muestra

He habilitado el selector de idiomas , pero no es visible en el administrador, ¿qué debo hacer?

Debe configurar settings y urls de varios idiomas correctamente: 

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

Abra cualquier URL en la ventana modal

Tengo una aplicación con algunos enlaces cruzados en el administrador y me gustaría abrirlos en ventanas modales en lugar de la misma/nueva ventana, ¿cómo puedo hacerlo?

Solo necesita agregar _popup=1 parámetro de cuerda de consulta a las URL: 

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

Pruebas 

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

Que contribuye

Las contribuciones siempre son bienvenidas, siga estos pasos para enviar PRS de buena calidad:

  • ❗ Abra un problema , no envíe ningún PR que no se refiera a un problema existente.
  • Trabajar en los cambios , los cambios deben estar preferiblemente cubiertos por las pruebas para evitar regresiones en el futuro.
  • Actualizar los archivos de traducciones .
  • ? Ejecute pruebas asegurando que no haya errores.
  • ? Envíe una solicitud de extracción y marquelo como "listo para la revisión" solo si pasa el CI .

Licencia

Liberado bajo la licencia MIT.

Secundario

  • Estrella este proyecto en Github
  • Sígueme en Github
  • ? Sígueme en Twitter
  • ? Patrocinándome en github

Ver también

  • django-cache-cleaner : borre todo el caché o los cachés individuales fácilmente usando el panel de administración o el comando de administración. ?

  • django-colorfield : campo de color simple para modelos con un bonito recipiente de color en el administrador. ?

  • django-extra-settings : configure y administre configuraciones adicionales tipadas utilizando solo el administrador de Django.

  • django-maintenance-mode : muestra una página de error 503 cuando el modo de mantenimiento está encendido. ?

  • django-redirects : redirige con control total. ↪️

  • django-treenode : probablemente el mejor modelo / administrador abstracto para sus cosas basadas en árboles. ?

  • python-benedict : subclase DICT con soporte de keylist/keypath, atajos de E/S (Base64, CSV, JSON, Pickle, Plist, Consulta, TomL, XML, YAML) y muchas utilidades.

  • python-codicefiscale - Codos fiscales italianos de Code/Decode - Codifica/Decodifica del Codice Fiscale. ? ?

  • python-fontbro : operaciones de fuentes amigables. ?

  • python-fsutil -Utilidades del sistema de archivos para desarrolladores perezosos. ? ‍️

Expandir
Información adicional
Aplicaciones relacionadas
Recomendado para ti
Información relacionada Todo