(Proyecto Tienda) Vistas genéricas de lista
1. Relación entre Modelos
Es posible crear relaciones entre modelos, para así generar tablas relacionales
Relación Producto-Categoria (N:1)
-
Configurar Modelos: Crear relación entre los modelos
ProductoyCategoriautilizandoForeignKey#./tienda/models.py from django.db import models ... ... class Producto(models.Model): ... ... categoria = models.ForeignKey('Categoria', on_delete=models.SET_NULL, null=True) ... ... class Categoria(models.Model): ... ... -
Configurar Base de datos: Crear archivos de migración con los cambios realizados y aplicarlos a la base de datos
Migrations for 'tienda': tienda/migrations/0002_producto_categoria.py + Add field categoria to productopython manage.py makemigrationsOperations to perform: Apply all migrations: admin, auth, contenttypes, sessions, tienda Running migrations: Applying tienda.0002_producto_categoria... OKpython manage.py migrate -
Configurar Admin: Agregar el nuevo campo a la clase
ProductoAdmin#./tienda/admin.py from django.contrib import admin from .models import Cliente, Producto, Categoria ... ... class ProductoAdmin(admin.ModelAdmin): list_display = ('id', 'nombre', 'precio', 'stock', 'categoria') ... ... -
Realizar Pruebas: Levantar servidor y verificar nuevo campo
python manage.py runserverhttp://127.0.0.1:8000/admin/tienda/producto/1/change/Figura 1: Relación entre Modelos mediante nuevo campo 'categoria' 
Figura 2: Lista de Productos actualizados 
Relación Categoria-Producto (1:N)
- Como la relación es 1:N, sería ideal que al entrar a una categoría, se puede visualizar la lista de productos correspondiente
- Para esto se realizan las siguientes configuraciones en
admin.py
-
Configurar Admin
- Crear clase
ProductoInline, que permitirá editar productos directamente desde la página de Categoría - Agregar la clase
ProductoInlinea la claseCategoriaAdmin
#./tienda/admin.py from django.contrib import admin from .models import Cliente, Producto, Categoria # Clase de definición de modelos relacionados class ProductoInline(admin.TabularInline): model = Producto extra = 0 ... ... class CategoriaAdmin(admin.ModelAdmin): list_display = ('id', 'nombre',) inlines = [ProductoInline] ... ... - Crear clase
-
Realizar Pruebas: Levantar servidor y verificar cambios
python manage.py runserverhttp://127.0.0.1:8000/admin/tienda/categoria/1/change/Figura 3: Categoría Abarrotes con lista de productos 
2. Template Base (Plantillas Base)
- Una forma de evitar que los desarrolladores dupliquen texto html en cada página, es utilizando plantillas
- El lenguaje de plantillas en Django le permite declarar una plantilla base y luego extenderla, reemplazando solo las porciones que son distintas para cada página específica
Ejemplo: Plantilla base base_generic.html
<!-- base_generic.html -->
<!DOCTYPE html>
<html lang="en">
<head>
{% block title %}<title>Local Library</title>{% endblock %}
</head>
<body>
{% block sidebar %}<!-- insert default navigation text for every page -->{% endblock %}
{% block content %}<!-- default content text (typically empty) -->{% endblock %}
</body>
</html>
<!-- index.html -->
{% extends "base_generic.html" %}
{% block content %}
<h1>Local Library Home</h1>
<p>Welcome to <em>LocalLibrary</em>, a very basic Django website developed as a tutorial example on the Mozilla Developer Network.</p>
{% endblock %}
- Se crea la plantilla base
base_generic.html - Luego en
index.htmlse carga la plantilla base, y se llena los bloques de la plantilla con los bloques deindex.html
3. Vistas Genéricas de lista
- La función de vista se lleva a cabo, a través de la implementación de ésta como una clase Django
- Se hereda desde una función de vista genérica (ListView) existente que ya hace la mayoría de lo que se requiere de una vista
- Para las vistas basadas en clases de Django, se debe acceder a una función de vista apropiada, llama al método de clase
as_view()
Es una alternativa a la forma de trabajo actual, vistas basadas en funciones
Ejemplo: En views.py ahora se usa la clase Book para implementar una vista
from django.views import generic
class BookListView(generic.ListView):
model = Book
- La vista genérica consultará a la base de datos para obtener todos los registros del modelo Book
4. Continuación Proyecto Tienda
Agregar Template Base
-
Configurar Templates (1): Agregar template
base.html<!-- ./tienda/templates/tienda/base.html --> <!DOCTYPE html> <html lang="en"> <head> {% block title %}<title>Tienda de Productos</title>{% endblock title %} <meta charset="utf-8"> <meta name="viewport" content="width=device-width, initial-scale=1"> <link href="https://cdn.jsdelivr.net/npm/bootstrap@5.1.3/dist/css/bootstrap.min.css" rel="stylesheet" integrity="sha384-1BmE4kWBq78iYhFldvKuhfTAU6auU8tT94WrHftjDbrCEXSU1oBoqyl2QvZ6jIW3" crossorigin="anonymous"> <!-- Add additional CSS in static file --> <link rel="stylesheet" href=""> </head> <body> <div class="container-fluid"> <div class="row"> <div class="col-sm-3"> {% block sidebar %} <ul class="sidebar-nav"> <li><a href="{% url "index" %}">Home</a></li> <li><a href="http://localhost:8000/admin">Admin</a></li> <li><a href="">Mostrar Clientes</a></li> <li><a href="">Mostrar Productos</a></li> <li><a href="">Mostrar Categorías</a></li> </ul> {% endblock sidebar %} </div> <div class="col-sm-9 "> {% block content %} {% endblock content %} </div> </div> </div> </body> -
Configurar Templates (2): Modificar
index.htmlpara que acepte el templatebase.html<!-- ./tienda/templates/tienda/index.html --> {% extends "tienda/base.html" %} {% block title %} <title>Tienda de Productos - index</title> {% endblock title%} {% block content %} <h1>Tienda de Productos - Tienda - Base</h1> <p>Bienvenido a la <em><strong>Tiendita</strong></em>, la mejor tienda de productos del país.</p> <h2>Contenido Dinámico</h2> <p>El modelo posee los siguiente datos:</p> <ul> <li><strong>Clientes: {{ cant_clientes }}</strong></li> <li><strong>Productos: {{ cant_productos }}</strong></li> <li><strong>Todas las Categorías: {{cant_categorias }}</strong></li> </ul> {% endblock content%} -
Realizar Pruebas: Levantar servidor y verificar ruta
python manage.py runserverhttp://127.0.0.1:8000/tienda/index/Figura 4: Página 'index' con template base 
Agregar Vistas genéricas de lista (1)
Agregar vista genérica de lista para el modelo Cliente
-
Agregar Datos: añadir datos al modelo
ClienteFigura 5: Datos para el modelo Cliente 
-
Configurar Vistas: Crear la ‘vista genérica de lista’
ClienteListView#./tienda/views.py from django.shortcuts import render from .models import Cliente, Producto, Categoria from django.views import generic def index(request): ... ... # Vistas genéricas de lista class ClienteListView(generic.ListView): model = Cliente -
Configurar Templates (1): Agregar template
cliente_list.htmlpara la ‘vista genérica de lista’ClienteListView<!-- ./tienda/templates/tienda/cliente_list.html--> {% extends "tienda/base.html" %} {% block title %} <title>Tienda de Productos - clientes</title> {% endblock title %} {% block content %} <h1>Lista de clientes</h1> {% if cliente_list %} <ul> {% for cliente in cliente_list %} <li><a href="{{cliente.id}}">{{cliente.nombre}} {{cliente.apellido}}</a> - ({{cliente.id}})</li> {% endfor %} </ul> {% else %} <p>No hay clientes registrados.</p> {% endif %} {% endblock content %} -
Configurar Enrutamiento: Agregar la ruta para la ‘vista genérica de lista’
ClienteListView#./tienda/urls.py from django.urls import path from . import views urlpatterns = [ path("index/", views.index, name="index"), path("clientes/", views.ClienteListView.as_view(), name="clientes"), ] -
Configurar Templates (2): Agregar la ruta
ClienteListViewen el template basebase.html<!-- ./tienda/templates/tienda/base.html --> <!DOCTYPE html> <html lang="en"> <head> ... ... </head> <body> <div class="container-fluid"> <div class="row"> <div class="col-sm-3"> {% block sidebar %} <ul class="sidebar-nav"> ... ... <li><a href="{% url 'clientes' %}">Mostrar Clientes</a></li> ... ... </ul> {% endblock sidebar %} </div> ... ... </div> </div> </body> -
Realizar Pruebas: Levantar servidor y verificar ruta
python manage.py runserverhttp://127.0.0.1:8000/tienda/clientes/Figura 6: Página 'clientes' usando Vistas genéricas de lista 
Agregar Vistas genéricas de lista (2)
Agregar las ‘vistas genéricas de lista’ para los modelos Producto y Categoria
-
Configurar Vistas: Agregar las ‘vistas genéricas de lista’
ProductoListViewyClienteListViewenviews.py#./tienda/views.py from django.shortcuts import render from .models import Cliente, Producto, Categoria from django.views import generic ... ... # Vistas genéricas de lista class ClienteListView(generic.ListView): model = Cliente class ProductoListView(generic.ListView): model = Producto class CategoriaListView(generic.ListView): model = Categoria -
Configurar Templates (1): Agregar los templates
producto_list.htmlycategoria_list.html<!-- ./tienda/templates/tienda/producto_list.html --> {% extends "tienda/base.html" %} {% block title %} <title>Tienda de Productos - productos</title> {% endblock title %} {% block content %} <h1>Lista de productos</h1> {% if producto_list %} <ul> {% for producto in producto_list %} <li><a href="{{producto.id}}">{{producto.nombre}}</a> - ({{producto.id}})</li> {% endfor %} </ul> {% else %} <p>No hay productos registrados.</p> {% endif %} {% endblock content %}<!-- ./tienda/templates/tienda/categoria_list.html --> {% extends "tienda/base.html" %} {% block title %} <title>Tienda de Productos - categorias</title> {% endblock title %} {% block content %} <h1>Lista de categorias</h1> {% if categoria_list %} <ul> {% for categoria in categoria_list %} <li><a href="{{categoria.id}}">{{categoria.nombre}}</a> - ({{categoria.id}})</li> {% endfor %} </ul> {% else %} <p>No hay categorias registradas.</p> {% endif %} {% endblock content %} -
Configurar Enrutamiento: Agregar las rutas para las ‘vistas genéricas de lista’
ProductoViewListyCategoriaViewList#./tienda/urls.py from django.urls import path from . import views urlpatterns = [ path("index/", views.index, name="index"), path("clientes/", views.ClienteListView.as_view(), name="clientes"), path("categorias/", views.CategoriaListView.as_view(), name="categorias"), path("productos/", views.ProductoListView.as_view(), name="productos"), ] -
Configurar Templates (2): Agregar las rutas de Producto y Categoria al template base
base.html<!-- ./tienda/templates/tienda/base.html --> <!DOCTYPE html> <html lang="en"> <head> ... ... </head> <body> <div class="container-fluid"> <div class="row"> <div class="col-sm-3"> {% block sidebar %} <ul class="sidebar-nav"> ... ... <li><a href="{% url 'productos' %}">Mostrar Productos</a></li> <li><a href="{% url 'categorias' %}">Mostrar Categorías</a></li> </ul> {% endblock sidebar %} </div> ... ... </div> </div> </body> -
Realizar Pruebas: Levantar servidor y verificar rutas
python manage.py runserverhttp://127.0.0.1:8000/tienda/productos/Figura 7: Página 'productos' usando Vistas genéricas de lista 
http://127.0.0.1:8000/tienda/categorias/Figura 8: Página 'categorias' usando Vistas genéricas de lista 