Django Admin — Gestión de artículos

En este capítulo aprenderás a configurar Django Admin, para tener un panel de administración de contenido sin necesidad de escribir código frontend.


¿Qué es Admin?

Django AdminEs una de las funciones integradas más potentes de Django: solo tienes que registrar los modelos y automáticamente se genera un panel de administración completo.

El backend proporciona funciones como crear, leer, actualizar y eliminar artículos, búsqueda, filtrado, paginación, etc., sin necesidad de que escribas ningún código CRUD.


Crear superusuario

Primero se necesita crear una cuenta de administrador para iniciar sesión en el panel de administración:

(venv) $ python manage.py createsuperuser
用户名:admin
电子邮件地址:admin@example.com
Password:        # 输入密码(不会回显)
Password (again): # 重复密码
Superuser created successfully.

Después de iniciar el servidor, visite http://127.0.0.1:8000/admin/ e inicie sesión con la cuenta que acaba de crear.

(venv) $ python manage.py runserver

Registrar el modelo en Admin.

Abrirblog/admin.pyRegistra los modelos Post y Category.

Ejemplo

# Ruta del archivo: blog/admin.py
from django.contrib import admin
from .models import Category, Post

Registrar un modelo de clasificación: la forma más sencilla de registro.
@admin.register(Category)
class CategoryAdmin(admin.ModelAdmin):
    Columnas mostradas en la página de lista
    list_display = ['name', 'slug']

Registro del modelo de artículo: con configuración personalizada
@admin.register(Post)
class PostAdmin(admin.ModelAdmin):
    Columnas mostradas en la página de lista
    list_display = ['title', 'category', 'created_at', 'updated_at']

    # Barra de filtro derecha: filtrar por categoría y tiempo
    list_filter = ['category', 'created_at']

    Cuadro de búsqueda superior: buscar por título y resumen.
    search_fields = ['title', 'summary']

    Navegación jerárquica por tiempo de publicación (año → mes → día)
    date_hierarchy = 'created_at'

    Mostrar 20 registros por página
    list_per_page = 20

admin.py: notas clave de configuración

elemento de configuracióntipoefecto
list_displaylistaEspecificar qué campos mostrar en la página de lista.
list_filterlistaAgregar barra lateral de filtros a la derecha
search_fieldslistaAgregar un cuadro de búsqueda en la parte superior.
date_hierarchycadenaNavegación por jerarquía de fechas
list_per_pagenúmeroCantidad de elementos por página (predeterminado 100)

Actualice la página de administración, haga clic en «Artículos» a la izquierda y podrá ver la lista completa, las funciones de filtrado y búsqueda.


Ingresar datos de prueba mediante Admin

Haga clic en el botón «Agregar artículo» y complete el título, el resumen y el contenido del cuerpo en el formulario.

El campo de clasificación extraerá automáticamente las opciones de la Category ya creada (porque está configurado como ForeignKey).

Ingrese al menos 5 artículos, cubriendo diferentes categorías, para facilitar la visualización de listas y el efecto de filtrado en capítulos posteriores.

El orden de los campos del formulario de Admin es el mismo que el orden de definición de los campos en models.py. Si desea ajustar el orden, puede configurarlo en la clase Admin.fields = ['title', 'category', ...]Especificar explícitamente la permutación.


Edición de texto enriquecido (extensión opcional)

El cuadro de entrada del texto principal es un cuadro de texto sin formato, por lo que ingresar HTML no es muy conveniente.

Se puede instalar.django-summernotePara obtener un editor de texto enriquecido WYSIWYG:

(venv) $ pip install django-summernote

ejemplo

Ruta del archivo: blog_project/settings.py
INSTALLED_APPS = [
    # ...
    'django_summernote',   Registro de aplicación
]

# Límite de tamaño de carga de archivos admitido (opcional)
SUMMERNOTE_CONFIG = {
    'summernote': {
        'width': '100%',
        'height': '480',
    }
}

Luego, en Admin, cambia el campo content al editor Summernote:

Ejemplo

Ruta del archivo: blog/admin.py
from django_summernote.admin import SummernoteModelAdmin

@admin.register(Post)
class PostAdmin(SummernoteModelAdmin):  # Heredar SummernoteModelAdmin
    list_display = ['title', 'category', 'created_at']
    list_filter = ['category']
    search_fields = ['title', 'summary']
    summernote_fields = ['content']     El campo content utiliza un editor de texto enriquecido.

Ahora, al editar un artículo, el área del cuerpo es un editor de texto enriquecido completo, que permite maquetar, insertar imágenes y ajustar el formato.

django-summernoteEs opcional. Si no deseas instalar bibliotecas de terceros, también puedes seguir escribiendo HTML en el cuadro de texto sin formato. El código posterior de este tutorial no tiene relación con si se instala Summernote o no.


Interfaz de administración localizada al chino

Si se establece en settings.pyLANGUAGE_CODE = 'zh-hans'La interfaz de Admin se ha cambiado automáticamente al chino.

en la definición del modeloverbose_nameLos parámetros se usarán para las etiquetas de los campos del formulario de Admin.


Resumen del capítulo

En este capítulo configuraste el panel de administración de Django: creación de superusuario, registro de modelos, configuración de la visualización/búsqueda/filtrado de listas e integración opcional de un editor de texto enriquecido.

Ahora puedes gestionar visualmente el contenido de los artículos en el navegador, sin necesidad de entrar a Shell para ingresar datos manualmente.

Otras extensiones.