=== MV Google Reviews ===
Contributors: maxvalle
Author: Max Valle
Author URI: https://maxvalle.it
Tags: recensioni google, google reviews
Requires at least: 6.0
Tested up to: 6.8
Requires PHP: 7.4
Stable tag: 1.1.1
License: GPL-2.0-or-later

Mostra le recensioni Google sul tuo sito in totale autonomia: rating, totale e carosello di recensioni, aggiornati in automatico via API ufficiale.

== Description ==

MV Google Reviews sostituisce i servizi esterni come TrustIndex: legge le recensioni della tua scheda Google Business tramite l'API ufficiale Google Places, le archivia localmente sul sito e le mostra con lo shortcode `[mv_google_reviews]` in un widget elegante: blocco riepilogo (giudizio, stelle, numero di recensioni, logo Google) e carosello di recensioni con avatar, data, stelle e «Leggi di più».

Caratteristiche principali:

* Dati letti dall'API ufficiale Google Places (New): stabile, nei termini di servizio Google, senza script di terze parti nel sito.
* Archivio locale che cresce nel tempo: l'API fornisce le 5 recensioni più rilevanti a ogni aggiornamento e il plugin le accumula (fino a 60).
* Cache configurabile: default 7 giorni, modificabile da 1 a 90 nelle impostazioni. Tra un aggiornamento e l'altro zero chiamate esterne e zero rallentamenti per i visitatori.
* Aggiornamento automatico via WP-Cron + pulsante «Aggiorna recensioni ora».
* Filtro per valutazione minima e numero massimo di recensioni mostrate.
* Shortcode con parametri: `[mv_google_reviews limit="6" min_rating="5"]`.
* Embed per pagine HTML statiche (anche fuori da WordPress): due righe di codice `<div class="mv-google-reviews"></div>` + `<script async src="https://tuosito.it/?mvgr_embed=1"></script>`, snippet pronto da copiare nella pagina impostazioni.
* CSS leggero stampato inline solo dove serve, tipografia ereditata dal tema.

Il plugin richiede una licenza attiva. Acquisto, rinnovo e supporto tecnico:
https://clienti.maxvalle.it

== Installation ==

1. Carica la cartella `mv-google-reviews` in `/wp-content/plugins/` (oppure installa lo zip da Plugin → Aggiungi nuovo → Carica plugin).
2. Attiva il plugin dal menu Plugin.
3. Vai in Impostazioni → MV Google Reviews e incolla la chiave di licenza ricevuta via email.
4. Verifica che il dominio del sito sia abilitato nella tua area clienti su https://clienti.maxvalle.it.
5. Inserisci API key Google (con Places API New abilitata) e Place ID della tua attività, salva e clicca «Aggiorna recensioni ora».
6. Inserisci lo shortcode `[mv_google_reviews]` dove vuoi mostrare le recensioni.

== Frequently Asked Questions ==

= Dove trovo la mia chiave di licenza? =
Nella tua area clienti su https://clienti.maxvalle.it, alla voce Servizi.

= Ho cambiato dominio, il plugin non funziona più =
Aggiorna il dominio abilitato dalla tua area clienti (o apri un ticket) e poi clicca «Verifica ora» nella pagina impostazioni del plugin.

= Dove trovo API key e Place ID di Google? =
L'API key si crea gratuitamente in Google Cloud Console abilitando «Places API (New)». Il Place ID si trova con il Place ID Finder di Google (link diretto nella pagina impostazioni del plugin).

= Perché vedo solo alcune recensioni e non tutte le 100+? =
L'API ufficiale di Google fornisce le 5 recensioni più rilevanti a ogni chiamata. Il plugin le accumula in un archivio locale che cresce a ogni aggiornamento; il numero totale di recensioni e il rating medio sono comunque sempre quelli reali della scheda Google.

== Changelog ==

= 1.1.1 =
* Migliorato: la pagina impostazioni ora propone due snippet di embed — percorso relativo `/?mvgr_embed=1` per le pagine HTML sullo stesso dominio (nessuna lookup DNS aggiuntiva, riuso della connessione) e URL completo per le pagine su altri domini.

= 1.1.0 =
* Nuovo: modalità embed per pagine HTML statiche, anche fuori da WordPress — snippet `<div class="mv-google-reviews"></div>` + `<script async src="https://tuosito.it/?mvgr_embed=1"></script>` (parametri opzionali limit e min_rating), pronto da copiare dalla pagina impostazioni.
* Refactor interno: markup del widget condiviso tra shortcode ed embed, CSS/JS centralizzati.

= 1.0.0 =
* Prima versione: fetch da Google Places API (New), archivio locale con accumulo, cache configurabile (default 7 giorni), cron giornaliero con fallback admin, shortcode [mv_google_reviews] con carosello, filtri per rating e numero, licenza WHMCS.
