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
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ón | tipo | efecto |
|---|---|---|
| list_display | lista | Especificar qué campos mostrar en la página de lista. |
| list_filter | lista | Agregar barra lateral de filtros a la derecha |
| search_fields | lista | Agregar un cuadro de búsqueda en la parte superior. |
| date_hierarchy | cadena | Navegación por jerarquía de fechas |
| list_per_page | número | Cantidad 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
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
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.