Etchenet Reviews for Google Business

Etchenet Reviews for Google Business affiche vos avis Google Business dans un carrousel moderne (Swiper), un badge flottant et un panneau latéral. Idéal pour renforcer la confiance et la preuve sociale sur votre site.

Internationalisation

• Toutes les chaînes traduisibles de l’extension utilisent l’anglais (États-Unis, en_US) comme source, conformément aux exigences de traduction communautaire sur WordPress.org.
• Sur un site dont la locale est en_US, WordPress utilise généralement ces chaînes telles quelles depuis l’extension (aucun fichier anglais séparé n’est nécessaire).
• Les fichiers de traduction en espagnol (es_ES) et en français (fr_FR) sont inclus dans le dossier languages/. Les autres locales peuvent utiliser les packs de langue de wordpress.org lorsqu’ils sont disponibles, ou des fichiers .mo / .l10n.php personnalisés.

Fonctionnalités

• Carrousel – Shortcode [etn_egr_reviews_carousel] avec colonnes, lecture automatique, flèches et points configurables
• Badge flottant – Affiche la note et le nombre total d’avis ; cliquez pour ouvrir le panneau latéral
• Panneau latéral – Liste des avis dans un panneau coulissant (position et styles configurables)
• Avis manuels – Ajoutez et gérez vos propres avis dans l’administration (même structure que Google)
• Importation CSV/Excel – Importation en masse depuis .csv ou .xlsx avec une ligne d’en-tête telle que Author, Text, Stars, Date, Photo URL (minimum : Author, Text). Les noms de colonnes en espagnol (ex. Autor, Texto) sont également reconnus par souci de compatibilité.
• Synchronisation API Google – Synchronisation en un clic avec l’API Google Places (clé API + identifiant de lieu) ; cron quotidien optionnel
• Ordre – Tri par date croissante/décroissante, meilleure/pire note, ou ordre manuel par glisser-déposer dans la liste d’administration
• Personnalisable – Couleurs, longueur de l’extrait, nombre minimum d’étoiles, modale « Lire la suite », Rich Snippets (JSON-LD)
• Traductions – Domaine de texte : etchenet-reviews-for-google-business ; voir Internationalisation ci-dessus

Prérequis

• WordPress 5.0+
• PHP 7.4+
• Clé API Google et identifiant de lieu (pour la synchronisation depuis Google) ; facultatifs en cas d’utilisation avec avis manuels uniquement

Comment les avis sont chargés depuis l’API Google

L’extension utilise l’API Google Places (Place Details). Elle demande le champ reviews pour votre établissement (en utilisant votre clé API et votre identifiant de lieu). Google renvoie un nombre limité d’avis par requête (généralement 5) et ne prend pas en charge la pagination pour les avis.

À chaque synchronisation, l’extension récupère le lot actuel depuis Google, le compare aux avis déjà stockés sur votre site, n’ajoute que les nouveaux (sans doublon), et les fusionne avec la liste existante. Elle ne supprime jamais les avis Google précédemment enregistrés. La réponse de l’API est mise en cache pendant 12 heures pour éviter les requêtes excessives.

Comment obtenir plus d’avis que la limite par défaut de Google

Étant donné que l’API ne renvoie qu’un petit nombre d’avis par appel (généralement 5) et ne prend pas en charge la pagination :

• Synchronisez régulièrement. Utilisez Synchroniser maintenant dans l’onglet Connectivité de temps en temps, ou activez Activer la synchronisation automatique quotidienne (WP-Cron). Chaque synchronisation peut ajouter de nouveaux avis ; l’extension conserve tous ceux qu’elle a reçus et n’ajoute que les nouveaux. Au fil du temps, votre total peut dépasser 5.
• Utilisez les avis manuels et l’importation. Ajoutez des avis manuellement ou importez un fichier CSV/Excel pour obtenir immédiatement un plus grand nombre d’avis ; ils ne sont pas limités par l’API et s’affichent aux côtés des avis Google.

Pour plus de détails, consultez les réglages de l’extension et ce fichier readme.

Services externes

Cette extension se connecte aux services Google pour récupérer et afficher les avis Google Business.

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

– Objectif : récupérer les détails du lieu et les avis publics (évaluation, nombre d’avis, nom de l’entreprise, entrées d’avis). – Données envoyées : place_id configuré, clé de l’API configurée, langue des avis demandée (code à deux lettres dérivé de la fonction get_locale() du site WordPress, par exemple en pour en_US, es pour es_ES), paramètre facultatif reviews_sort. – Envoi : lors de la synchronisation manuelle et de la synchronisation quotidienne optionnelle WP-Cron. Deux requêtes sont effectuées par synchronisation (une triée par pertinence, une par nouveauté) pour maximiser la collecte d’avis dans la limite de 5 avis par requête de Google.

1. Téléchargement distant des photos de profil (URLs d’images hébergées par Google)

– Finalité : mettre en cache localement les photos de profil publiques des auteurs d’avis pour un affichage plus rapide et stable. – Données envoyées : requête HTTP GET vers l’URL de la photo de profil renvoyée par Google pour chaque avis. – Envoi : lors de la synchronisation, lorsque de nouveaux avis sont détectés et incluent une URL de photo de profil.

Aucune donnée personnelle de vos visiteurs n’est envoyée par ces requêtes.

Conditions d’utilisation de Google Maps Platform : https://mapsplatform.google.com/terms/

Politique de confidentialité de Google : https://policies.google.com/privacy