# Carrusel de Reseñas de Google para Shopware 6 — Instalación, configuración y uso

> El plugin Carrusel de Reseñas de Google muestra las reseñas de Google de tu establecimiento como un carrusel responsive en el storefront de Shopware 6. Genera automáticamente el marcado Schema.org…

- Página: <https://www.datafirefly.com/es/documentation/carrousel-avis-google-shopware/>
- Idioma: es
- Actualizado el: 2026-07-07
- Otros idiomas: [fr](https://www.datafirefly.com/documentation/carrousel-avis-google-shopware/index.md), [en](https://www.datafirefly.com/en/documentation/carrousel-avis-google-shopware/index.md), [de](https://www.datafirefly.com/de/documentation/carrousel-avis-google-shopware/index.md), [it](https://www.datafirefly.com/it/documentation/carrousel-avis-google-shopware/index.md), [pl](https://www.datafirefly.com/pl/documentation/carrousel-avis-google-shopware/index.md), [nl](https://www.datafirefly.com/nl/documentation/carrousel-avis-google-shopware/index.md), [pt](https://www.datafirefly.com/pt/documentation/carrousel-avis-google-shopware/index.md)
- Índice: <https://www.datafirefly.com/es/documentation/llms.txt>

El plugin **Carrusel de Reseñas de Google** muestra las reseñas de Google de tu establecimiento como un carrusel responsive en el storefront de Shopware 6. Genera automáticamente el marcado Schema.org (LocalBusiness + AggregateRating + Review), almacena las reseñas en caché y ofrece dos temas integrados. No requiere ningún build de administración: se instala en cualquier alojamiento, incluido el compartido.

## Requisitos

- Shopware 6.5.x, 6.6.x o 6.7.x
- PHP 8.1 o superior
- Una clave API de Google Cloud con la **API Places** activada (gratuita hasta un amplio volumen de solicitudes)
- El **Place ID** de tu establecimiento de Google

## Instalación

Sube el archivo ZIP mediante _Extensiones > Mis extensiones > Cargar extensión_, o copia la carpeta `DfGoogleReviews` en `custom/plugins/`. Luego ejecuta:

```
bin/console plugin:refresh
bin/console plugin:install --activate DfGoogleReviews
bin/console cache:clear
```

El plugin aparece entonces en _Extensiones > Mis extensiones_, listo para configurar.

## Obtener tu clave API y tu Place ID

### Clave API de Google

1. Ve a `console.cloud.google.com` y crea (o selecciona) un proyecto.
2. En _API y servicios_, activa la **API Places**.
3. En _Credenciales_, crea una clave API y cópiala.
4. Recomendado: restringe la clave a la API Places y a tu dominio.

### Place ID

Utiliza el _Place ID Finder_ de Google (documentación de Google Maps Platform) para obtener el identificador de tu establecimiento. Tiene el aspecto `ChIJ...`.

## Configuración

Abre _Extensiones > Mis extensiones > Carrusel de reseñas de Google > Configurar_. Todos los ajustes se gestionan **por canal de venta**: selecciona el sales channel correspondiente en la parte superior de la página antes de configurar.

### Conexión Google

- **Activar el carrusel de reseñas**: interruptor principal.
- **Clave API de Google**: tu clave con la API Places activada.
- **Place ID**: el identificador de tu establecimiento.
- **Idioma de las reseñas**: código de idioma (p. ej. `fr`, `de`, `en`) transmitido a la API para los textos y fechas relativas. Déjalo vacío para el valor por defecto de Google.

### Visualización

- **Posición**: _Página de inicio_ (encima del footer), _Todas las páginas_, o _Manual_ (ver la sección siguiente).
- **Título**: título del carrusel (vacío = título traducido por defecto, incluido en 5 idiomas).
- **Tema**: Light o Dark.
- **Desplazamiento automático** e **intervalo** (en milisegundos): pausa automática al pasar el ratón y al enfocar.
- **Número máximo de reseñas**: hasta 10 (la API de Google devuelve 5 como máximo).
- **Valoración mínima**: solo muestra las reseñas por encima del umbral (p. ej. 4 para conservar solo las de 4 y 5 estrellas).

### Caché

- **Duración de la caché**: de 1 hora a 7 días (24 horas recomendado).

## Mostrar el carrusel

### Modo automático

Con la posición _Página de inicio_ o _Todas las páginas_, el carrusel se inserta automáticamente encima del footer. No es necesaria ninguna modificación del tema.

El modo automático utiliza el bloque `base_footer`. Si un tema personalizado sobrescribe completamente este bloque sin llamar a `parent()`, usa el modo manual a continuación.

### Modo manual (include Twig)

Elige la posición _Manual_, luego incluye el componente donde quieras en tu tema storefront:

```
{% sw_include '@DfGoogleReviews/storefront/component/df-google-reviews.html.twig' %}
```

Es ideal para colocar las reseñas en una página CMS concreta, dentro de una Shopping Experience o en un lugar específico de tu maquetación.

## Comandos de consola

Dos comandos facilitan el mantenimiento:

```
# Probar la conexión API y previsualizar las reseñas (caché ignorada)
bin/console df:google-reviews:test

# Vaciar la caché de las reseñas
bin/console df:google-reviews:clear-cache
```

Ambos aceptan la opción `--sales-channel-id=...` para apuntar a la configuración de un canal de venta concreto. El comando de prueba muestra el nombre del establecimiento, la valoración global y la lista de reseñas devueltas — práctico para validar la clave API y el Place ID antes de publicar.

## SEO y Schema.org

En cada visualización, el plugin inyecta un marcado JSON-LD completo: `LocalBusiness` (nombre, valoración global), `AggregateRating` (media y número total de reseñas) y un bloque `Review` por reseña. Este marcado puede hacer aparecer las estrellas en los resultados de Google (rich snippets). Al renderizarse el contenido del lado del servidor, las reseñas siguen siendo legibles por los robots de indexación y los usuarios sin JavaScript; el carrusel es solo una mejora progresiva.

## Rendimiento

El CSS (~2 KB) y el JavaScript (~2 KB, vanilla JS) se inyectan únicamente en las páginas donde se muestra el carrusel. Sin librerías de terceros, sin jQuery. Las llamadas a la API de Google Places se almacenan en la caché de objetos de Shopware según la duración configurada.

**Degradación elegante**: si la API de Google no está disponible momentáneamente, las últimas reseñas válidas en caché siguen mostrándose. El storefront nunca se rompe por el widget.

## Resolución de problemas

- **El carrusel no aparece**: comprueba que el plugin está activado, que la casilla «Activar el carrusel de reseñas» está marcada, y que la clave API y el Place ID están rellenados. Ejecuta `bin/console df:google-reviews:test` para diagnosticar.
- **Error de API**: asegúrate de que la API Places está activada en Google Cloud y que la clave no está demasiado restringida. Consulta `var/log` para los detalles.
- **Las reseñas no se actualizan**: vacía la caché con `bin/console df:google-reviews:clear-cache` (de todas formas la API de Google solo devuelve las 5 reseñas más recientes).
- **Modo automático invisible en un tema personalizado**: cambia al modo manual y añade el include Twig.

## Desinstalación

Desactiva y luego desinstala el plugin desde _Extensiones > Mis extensiones_, o mediante:

```
bin/console plugin:uninstall DfGoogleReviews
```

Si eliges eliminar los datos al desinstalar, toda la configuración (claves `DfGoogleReviews.config.*`) se limpia automáticamente.