Aprender Django Panel de administración

Panel de administración

El módulo de administración cubre la configuración y personalización del panel de administración de Django: registro de modelos, clase ModelAdmin, fieldsets, filtros, búsqueda, inlines para relaciones y acciones personalizadas en lote.

Configuración inicial

El panel de administración se activa con django.contrib.admin en INSTALLED_APPS. Se registran modelos con el decorador @admin.register(Modelo) o con admin.site.register(Modelo, ModelAdminClass). El superusuario se crea con python manage.py createsuperuser.

ModelAdmin

La clase ModelAdmin controla cómo se muestra y edita cada modelo en el panel. Los atributos principales incluyen list_display, list_filter, search_fields, ordering, list_editable y list_per_page. Para los formularios de edición, fieldsets organiza los campos en secciones, y readonly_fields define campos no editables.

@admin.register(Producto)
class ProductoAdmin(admin.ModelAdmin):
    list_display = ['nombre', 'precio', 'categoria', 'activo']
    list_filter = ['categoria', 'activo']
    search_fields = ['nombre', 'descripcion']
    list_per_page = 25

Inlines

Los inlines permiten editar modelos relacionados dentro del formulario del modelo principal. TabularInline muestra los relacionados en filas de tabla, mientras que StackedInline los presenta como formularios apilados. Son especialmente útiles para relaciones ForeignKey y ManyToMany.

Acciones personalizadas

Las acciones admin se aplican en lote a los registros seleccionados en el listado. Se definen como métodos de ModelAdmin o funciones independientes y se registran en el atributo actions. Permiten operaciones como publicar, archivar o exportar a CSV múltiples registros con un clic.