# Reseñas

Las reseñas de los clientes permiten a los compradores valorar productos y compartir su experiencia. Cada página de producto muestra una valoración media en estrellas, el número total de reseñas y la lista de todas las reseñas dejadas por compradores verificados. Los administradores de la tienda pueden navegar y moderar todas las reseñas desde un panel dedicado.

## Cómo funcionan las reseñas

- Solo los clientes que **han comprado** el producto pueden dejar una reseña. El pedido debe estar en estado **Paid**, **Shipped** o **Delivered**.
- Cada cliente puede dejar **una reseña por producto**. Puede editarla o eliminarla en cualquier momento.
- Una reseña consta de una **valoración de 1 a 5 estrellas**, un **título** (hasta 200 caracteres) y un **cuerpo** (hasta 2000 caracteres).
- La **valoración media** y el **número de reseñas** del producto se recalculan automáticamente cada vez que se crea, actualiza o elimina una reseña.

> **Consejo:** La propia reseña del cliente siempre queda fijada en la parte superior de la lista en la página del producto, para que pueda encontrarla fácilmente.

## Lo que ven los clientes

![Reseñas en la página del producto](/features/reviews/storefront-product-reviews.png)

En cada página de producto, la sección **Customer Reviews** muestra:

- La valoración media en estrellas y el número total de reseñas del producto
- Una lista de reseñas (5 por página) con el nombre del autor, la valoración, el título, el contenido y la fecha
- Una etiqueta **edited** junto a cualquier reseña que el autor haya actualizado
- Botones **Edit** y **Delete** junto a la reseña del propio cliente
- Un formulario **Write a Review**, pero solo para clientes con sesión iniciada que han comprado el producto y aún no lo han reseñado

Los clientes que intentan reseñar un producto que no han comprado ven el mensaje **"You must purchase this product to leave a review."** Los visitantes sin sesión iniciada ven **"Sign in to write a review."**

## Moderar reseñas

Abra **Reviews** en la barra lateral del administrador para ver todas las reseñas dejadas por sus clientes.

![Lista de reseñas en el administrador](/features/reviews/admin-reviews-list.png)

La tabla muestra el producto, el título, el cliente, la valoración y la fecha de cada reseña. Haga clic en el **nombre del producto** para abrir la página del producto en una nueva pestaña.

| Columna | Descripción                                                              |
| ------- | ------------------------------------------------------------------------ |
| Product | El producto reseñado (enlaza con la página de la tienda)                 |
| Title   | El título que el cliente le dio a su reseña                              |
| User    | El cliente que dejó la reseña                                            |
| Rating  | Valoración de 1 a 5 estrellas (ordenable)                                |
| Date    | Cuándo se creó la reseña (ordenable)                                     |
| Actions | Menú desplegable con las opciones **View Detail** y **Delete**           |

Puede ordenar por **Rating** o **Date** haciendo clic en el encabezado de la columna.

### Filtrar

Haga clic en **Filter** encima de la tabla para filtrar la lista por valoración o por producto.

![Filtrar reseñas](/features/reviews/admin-reviews-filter.png)

| Filtro  | Opciones                                       |
| ------- | ---------------------------------------------- |
| Rating  | 1 ★, 2 ★, 3 ★, 4 ★ o 5 ★                       |
| Product | Cualquier producto con al menos una reseña    |

Haga clic en **Save changes** para aplicar los filtros, o en **Clear filters** para reiniciarlos.

### Ver la reseña completa

Abra el menú de acciones en cualquier fila y elija **View Detail** para leer la reseña completa en un diálogo. Esto es útil cuando el título o el cuerpo es más largo que la vista previa de la tabla.

![Detalle de la reseña](/features/reviews/admin-reviews-detail.png)

El diálogo muestra la valoración en estrellas, el nombre del cliente, el cuerpo completo de la reseña y la fecha de creación.

### Eliminar una reseña

Para eliminar una sola reseña, abra el menú de acciones en la fila y seleccione **Delete**. Aparecerá un diálogo de confirmación antes de la eliminación definitiva.

Para eliminar varias a la vez, marque las casillas a la izquierda de cada fila para mostrar la barra de acciones en lote y haga clic en **Delete Selected**.

![Eliminación en lote de reseñas](/features/reviews/admin-reviews-bulk.png)

> **Importante:** Eliminar una reseña es permanente. Después de la eliminación, la valoración media y el número de reseñas del producto se recalculan automáticamente.

## Correos de solicitud de reseña

Una semana después de que un pedido se marque como **Delivered**, Capyshop envía automáticamente un correo al cliente pidiéndole que reseñe los productos que compró. El correo lo lleva directamente a la página del producto, donde puede dejar una valoración.

Esto le da al cliente tiempo suficiente para usar realmente el producto antes de pedirle su opinión y elimina la necesidad de que usted tenga que reclamar reseñas manualmente.

## Consejos

- Filtre regularmente por **1 ★** para detectar problemas de calidad o de envío que sus clientes están señalando.
- La valoración en estrellas se almacena en el propio producto, por lo que aparece al instante en cualquier lugar donde su tienda muestre productos — sin necesidad de recalcular manualmente.
- Las reseñas están vinculadas a compras verificadas, por lo que no necesita moderar spam de visitantes aleatorios.
