Instalación y Uso de Django Jazzmin

💅 Poniéndole Estilo al Admin: ¡Hola, Django Jazzmin!

Hemos avanzado un montón con nuestro panel de administración de Django. Ya podemos ver nuestros proveedores, filtrarlos, buscarlos... ¡es súper funcional! Pero, seamos honestos, la apariencia por defecto del admin de Django, aunque limpia, es un poquito... digamos... "clásica".

Afortunadamente, la comunidad de Django es enorme y creativa, y existen librerías de terceros que nos permiten "enchular" (mejorar estéticamente) nuestro panel de administración de forma muy sencilla. Hoy vamos a conocer una de las más populares y atractivas: Django Jazzmin.

Django Jazzmin le da un toque moderno y personalizable a tu panel de administración.

Jazzmin es una librería gratuita que reemplaza el tema visual del administrador de Django por uno mucho más moderno, personalizable y con una interfaz más amigable. ¡Le da un lavado de cara increíble!

1. Instalando el Módulo Adicional con Pip

Como cualquier otra librería externa de Python que queramos usar en nuestro proyecto, el primer paso es instalarla usando pip. Recuerda:

1. Abre tu terminal.
2. Navega a la carpeta raíz de tu proyecto (donde está manage.py).
3. ¡Activa tu entorno virtual! (ej: venv\Scripts\activate o source venv/bin/activate).
4. Si tienes el servidor corriendo, deténlo con Control + C.

Una vez listos, ejecutamos el comando para instalar Django Jazzmin:

pip install django-jazzmin

Pip se encargará de descargar e instalar Jazzmin y cualquier otra cosita que necesite para funcionar, todo dentro de tu entorno virtual.

2. Presentando Jazzmin al Proyecto: settings.py

Una vez instalado, necesitamos decirle a nuestro proyecto Django que queremos usar Jazzmin para el panel de administración. ¿Adivinas dónde hacemos eso? ¡Exacto! En nuestro archivo de configuraciones settings.py (que está en agenda/settings.py).

Abre settings.py y busca la lista INSTALLED_APPS. Aquí viene un detalle muy importante: para que Jazzmin funcione correctamente y pueda reemplazar el tema del admin por defecto de Django, debemos agregar 'jazzmin' a la lista antes de 'django.contrib.admin'.

Así es como debería quedar (aproximadamente):

# Application definition

INSTALLED_APPS = [
    'jazzmin',  # ¡Jazzmin primero!
    'django.contrib.admin',
    'django.contrib.auth',
    'django.contrib.contenttypes',
    'django.contrib.sessions',
    'django.contrib.messages',
    'django.contrib.staticfiles',
    'libreta', 
    # ... otras apps que puedas tener ...
]
                        

El orden aquí es crucial. Al poner 'jazzmin' primero, le estamos diciendo a Django: "Cuando alguien pida el panel de administración, usa las plantillas y estilos de Jazzmin en lugar de los tuyos por defecto".

¡No olvides guardar el archivo settings.py después de hacer este cambio!

3. ¡Magia! El Nuevo Look del Admin

Ahora, simplemente corre tu servidor de desarrollo de nuevo:

python manage.py runserver

Abre tu navegador y ve a http://127.0.0.1:8000/admin. ¡Deberías ver una interfaz completamente renovada! El inicio de sesión y todo el panel de administración ahora tendrán el estilo moderno y elegante de Jazzmin.

¡El panel de administración con el look de Django Jazzmin! Mucho más moderno, ¿verdad?

Notarás que los filtros y el buscador que configuramos en el capítulo anterior ahora se ven integrados de una manera diferente, generalmente más agradable a la vista. Jazzmin ofrece muchas opciones de personalización adicionales (colores, logo, menú lateral, etc.) que puedes explorar en su documentación oficial si te interesa profundizar.

En el video correspondiente, te muestro cómo instalar Jazzmin y cómo se ve el cambio en el panel de administración.

¡Ya casi llegamos al final de este maratón de configuraciones iniciales! En el último capítulo de este episodio, haremos un breve repaso y te propondré un ejercicio para que pongas en práctica todo lo aprendido.