Etchenet Reviews for Google Business

Descripción

Etchenet Reviews for Google Business muestra tus reseñas de Google Business en un carrusel moderno (Swiper), una insignia flotante y un panel lateral. Ideal para generar confianza y prueba social en tu sitio.

Internacionalización

• Todas las cadenas traducibles del plugin usan inglés (Estados Unidos, en_US) como fuente del mensaje, tal como se requiere para la traducción comunitaria en WordPress.org.
• En un sitio cuyo locale sea en_US, WordPress normalmente usa esas cadenas del plugin tal cual (no hace falta un archivo de inglés aparte).
• Los archivos de traducción al español (es_ES) y al francés (fr_FR) están incluidos en languages/. Otros locales pueden usar paquetes de idioma de wordpress.org cuando estén disponibles, o archivos personalizados .mo / .l10n.php.

Características

• Carrusel – Shortcode [etn_egr_reviews_carousel] con columnas, reproducción automática, flechas y puntos configurables
• Insignia flotante – Muestra la valoración y el total de reseñas; haz clic para abrir el panel lateral
• Panel lateral – Lista de reseñas en un panel deslizable (posición y estilos configurables)
• Reseñas manuales – Añade y gestiona tus propias reseñas en la administración (misma estructura que Google)
• Importación CSV/Excel – Importación en lote desde .csv o .xlsx con una fila de encabezado como Author, Text, Stars, Date, Photo URL (mínimo: Author, Text). También se reconocen nombres de columnas en español (p. ej. Autor, Texto) por compatibilidad.
• Sincronización con la API de Google – Sincronización con un clic con Google Places API (clave de API + Place ID); cron diario opcional
• Orden – Ordena por más recientes, más antiguas, mejor/peor valoración, o usa orden manual de arrastrar y soltar en la lista de administración
• Personalizable – Colores, longitud del extracto, estrellas mínimas, modal “Leer más”, fragmentos enriquecidos (JSON-LD)
• Traducciones – Dominio de texto: etchenet-reviews-for-google-business; consulta Internacionalización arriba

Requisitos

• WordPress 5.0+
• PHP 7.4+
• Clave de API de Google y Place ID (para sincronizar desde Google); opcional para uso solo manual

Cómo se cargan las reseñas desde la API de Google

El plugin usa la Google Places API (Place Details). Solicita el campo reviews de tu lugar (usando tu clave de API y tu Place ID). Google devuelve un número limitado de reseñas por solicitud (normalmente 5) y no admite paginación para las reseñas.

En cada sincronización, el plugin obtiene el lote actual desde Google, lo compara con las reseñas ya almacenadas en tu sitio, añade solo las nuevas (sin duplicados) y las fusiona con la lista existente. Nunca elimina reseñas de Google guardadas previamente. La respuesta de la API se almacena en caché durante 12 horas para evitar solicitudes excesivas.

Cómo obtener más reseñas que el límite predeterminado de Google

Como la API solo devuelve un conjunto pequeño por llamada (normalmente 5) y no tiene paginación:

• Sincroniza con regularidad. Usa Sincronizar ahora en la pestaña Conectividad de vez en cuando, o activa Activar sincronización automática diaria (WP-Cron). Cada sincronización puede añadir nuevas reseñas; el plugin conserva todas las que ha recibido y solo añade las nuevas. Con el tiempo, el total puede superar las 5.
• Usa reseñas manuales e importación. Añade reseñas manualmente o importa CSV/Excel para obtener de inmediato un conjunto más amplio; no están limitadas por la API y se muestran junto con las reseñas de Google.

Para obtener todos los detalles, revisa los ajustes del plugin y este archivo readme.

Servicios externos

Este plugin se conecta a servicios de Google para obtener y mostrar reseñas de Google Business.

1. Google Places API (maps.googleapis.com)

– Finalidad: obtener los detalles del lugar y las reseñas públicas (valoración, número de reseñas, nombre de la empresa, entradas de reseñas).
– Datos enviados: place_id configurado, clave de API configurada, idioma solicitado para las reseñas (código de dos letras derivado de get_locale() de WordPress del sitio, p. ej. en para en_US, es para es_ES), parámetro opcional reviews_sort.
– Cuándo se envía: durante la sincronización manual y durante la sincronización diaria opcional mediante WP-Cron. Se hacen dos solicitudes por sincronización (una ordenada por relevancia y otra por las más recientes) para maximizar la recopilación de reseñas dentro del límite de Google de 5 reseñas por solicitud.

1. Descarga remota de fotos de perfil (URLs de imágenes alojadas en Google)

– Finalidad: almacenar en caché localmente las imágenes públicas de perfil de los autores de las reseñas para una visualización más rápida/estable.
– Datos enviados: solicitud HTTP GET a la URL de la foto de perfil devuelta por Google para cada reseña.
– Cuándo se envía: durante la sincronización, cuando se detectan nuevas reseñas e incluyen una URL de foto de perfil.

Estas solicitudes no envían datos personales de los visitantes de tu sitio.

Términos del Servicio de Google Maps Platform:
https://mapsplatform.google.com/terms/

Política de privacidad de Google:
https://policies.google.com/privacy