Carrusel de Reseñas de Google para Shopware 6 — Instalación, configuración y uso
Guía completa para instalar, configurar y mostrar el carrusel de reseñas de Google en Shopware 6.5, 6.6 y 6.7: clave API, Place ID, posición, temas, caché y comandos de consola.
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:clearEl plugin aparece entonces en Extensiones > Mis extensiones, listo para configurar.
Obtener tu clave API y tu Place ID
Clave API de Google
- Ve a
console.cloud.google.comy crea (o selecciona) un proyecto. - En API y servicios, activa la API Places.
- En Credenciales, crea una clave API y cópiala.
- 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-cacheAmbos 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:testpara 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/logpara 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 DfGoogleReviewsSi eliges eliminar los datos al desinstalar, toda la configuración (claves DfGoogleReviews.config.*) se limpia automáticamente.