Lograr que un botón de "agregar al pedido" funcione correctamente en Django requiere conectar varias piezas: una URL, una vista basada en clases, un formulario y la lógica para asociar el producto con la orden del usuario. A continuación se explica paso a paso cómo construir ese flujo completo, incluyendo los errores más comunes y cómo resolverlos.
¿Cómo configurar la URL y la vista para agregar un producto?
El primer paso es definir una nueva ruta en el archivo urls.py con un path descriptivo, por ejemplo agregar-producto [0:08]. Luego se crea la vista correspondiente en views.py, que hereda de CreateView [0:22].
CreateView es una vista genérica de Django diseñada para manejar la creación de objetos. Requiere tres atributos principales:
template_name: la plantilla HTML que se renderizará.form_class: el formulario que validará los datos.success_url: la URL a la que se redirige tras una operación exitosa.
Para el success_url se utiliza reverse_lazy [2:08], una función de django.urls que resuelve el nombre de una URL de forma diferida. Esto es necesario porque al momento de cargar la clase, las URLs aún no están completamente cargadas en memoria.
¿Qué es un ModelForm y por qué usarlo?
Django ofrece dos tipos principales de formularios: Form y ModelForm [1:08]. Mientras que Form requiere declarar cada campo manualmente, ModelForm se conecta directamente a un modelo y genera los campos automáticamente.
Para configurarlo se define una clase Meta dentro del formulario [1:22], donde se especifica:
model: el modelo de datos asociado, en este caso OrderProduct.fields: una lista con los campos que se quieren exponer en el formulario.
python
from django import forms
from .models import OrderProduct
class OrderProductForm(forms.ModelForm):
class Meta:
model = OrderProduct
fields = ['product']
Django inspecciona el tipo de campo en el modelo y selecciona automáticamente el widget HTML adecuado [1:40]. En este caso, como el producto se envía de forma oculta desde el botón, se utilizará un input de tipo hidden.
¿Cómo funciona el método form_valid y get_or_create?
El formulario solo envía el producto, pero el modelo OrderProduct también necesita la orden y la cantidad. Para completar esos datos se sobreescribe el método form_valid [3:10], que se ejecuta cuando el formulario pasa todas las validaciones.
Dentro de este método se utiliza get_or_create [3:52], un método del ORM de Django que intenta obtener un registro con los filtros indicados; si no lo encuentra, lo crea automáticamente. Devuelve una tupla con dos valores: el objeto y un booleano (created) que indica si fue creado o encontrado.
python
def form_valid(self, form):
order, _ = Order.objects.get_or_create(
is_active=True,
user=self.request.user
)
form.instance.order = order
form.instance.quantity = 1
form.save()
return super().form_valid(form)
El guion bajo (_) se usa como convención para variables que no se necesitan [5:48]. Además, es fundamental llamar a super().form_valid(form) para que las funcionalidades heredadas de CreateView y LoginRequiredMixin se ejecuten correctamente [5:22].
¿Por qué usar LoginRequiredMixin?
Si el usuario no ha iniciado sesión, self.request.user devuelve un usuario anónimo [4:22], lo que causaría errores. Al agregar LoginRequiredMixin a la vista, Django redirige automáticamente al login cuando un usuario no autenticado intenta acceder.
¿Cómo se conecta el botón en el template?
En la plantilla de listado de productos se crea un formulario con método POST [6:20] que apunta a la URL de agregar producto. Incluye:
- El csrf_token obligatorio para protección contra ataques CSRF.
- Un input oculto con el nombre
product y el valor {{ product.id }} [7:00].
html
<form method="post" action="{% url 'add_product' %}">
{% csrf_token %}
<input type="hidden" name="product" value="{{ product.id }}">
<button type="submit">Agregar al pedido</button>
</form>
Como el formulario está dentro de un for, cada botón envía el ID del producto correspondiente [7:16].
¿Cuáles son los errores comunes al implementar esto?
Durante la prueba surgieron dos errores típicos [8:10]:
- Parámetros incorrectos en form_valid: al llamar
super().form_valid(self, form) se pasan tres argumentos en lugar de dos. La solución es no pasar self explícitamente.
- Falta de return: si no se retorna el resultado de
super().form_valid(form), Django lanza un error indicando que la vista no devuelve un HttpResponse [8:38].
Estos errores permitieron que form.save() se ejecutara tres veces antes de la redirección, creando registros duplicados. La solución fue eliminar los registros sobrantes desde el admin de Django [9:20] y corregir el código.
Con este flujo completo ya es posible que los usuarios agreguen productos a su pedido desde la interfaz, mientras el administrador gestiona el catálogo desde el panel de Django. ¿Qué otros features agregarías a este sistema? Compártelo en los comentarios.
