=== Reputando Reviews Widget === Contributors: ajaychandanit,ajaychandani003 Requires at least: 5.6 Tested up to: 7.1 Requires PHP: 7.0 Stable tag: 3.8.0 License: GPLv3 or later License URI: https://www.gnu.org/licenses/gpl-3.0.html Display customer reviews from your Reputando profile on any WordPress page or post using a simple shortcode. == Description == The **Reputando Reviews Widget** plugin allows you to showcase customer reviews collected via the Reputando platform directly on your WordPress site. This is ideal for businesses who want to build trust by showing real customer feedback from various review channels in one unified widget. Whether you're running an eCommerce site, local business, or a service company, this plugin helps you boost conversions by making reviews visible where they matter most. You can easily embed reviews using a simple shortcode and customize how they look to match your site’s style. ### Key Features - ✅ Display customer reviews from your Reputando account - 🔄 Automatically syncs new reviews - 🧩 Lightweight and easy to configure - 🔧 Simple shortcode to embed reviews anywhere - 🎨 Minimal and responsive design == SHORTCODE == Use the following shortcode to embed your reviews: `[reputando_reviews id="{id}"]` Replace `{id}` with your Reputando shortcode post ID. Example: `[reputando_reviews id="1234"]` Header bar only (for the header of your theme or page builder): `[reputando_header id="1234"]` == Installation == 1. Upload the entire `reputando-reviews-widget` folder to the `/wp-content/plugins/` directory. 2. Activate the plugin through the **Plugins** screen (**Plugins > Installed Plugins**). **OR** 1. Visit **Plugins > Add New** 2. Search for **"Reputando"** 3. Install and activate **Reputando Reviews Widget** == Usage == 1. After activating the plugin, go to **Reputando > Collegamento** in your WordPress dashboard. 2. Connect the plugin to your Reputando account to pull in your latest reviews. 3. Then go to **Reputando > Widget** to create a widget and customize it with the live preview. 4. Copy the generated shortcode and paste it into any page or post where you want the reviews to appear. 5. Save the page and view it on the front end to see your reviews live. == External Services == This plugin connects to the Reputando API (https://app.reputando.com) to fetch and manage business reviews. The plugin sends the following data to the Reputando API: - User credentials (email, password) for login and token generation. - Business identifiers to retrieve and manage reviews. - Review replies and publishing actions from the WordPress admin. The API is required for the core functionality of this plugin — including viewing reviews, syncing them, and replying to them. This service is provided by Reputando. - Terms of Use: https://app.reputando.com/terms - Privacy Policy: https://app.reputando.com/privacy == Frequently Asked Questions == = Does the widget work with WP Rocket, LiteSpeed Cache and other optimization plugins? = Yes. Since version 3.0 reviews are visible and scrollable even before (or without) JavaScript, the widget has no jQuery dependency and the small script is excluded automatically from WP Rocket "Delay JavaScript execution". Page caches of the most common plugins are cleared once after each update. = When does the carousel start scrolling? = Only when at least 30% of the widget is visible on screen, so visitors always see the most recent review first. It pauses when it leaves the screen, on mouse hover and on keyboard focus. It never starts for visitors who enabled "reduce motion". = How do I show the Header bar on every page? = Open any widget, go to the «Header» tab, enable the bar and «In cima a tutte le pagine del sito, in automatico». The bar is placed at the very top of the page without editing the theme (wp_body_open, Betheme's top hook, or a footer fallback moved to the top). With «Tienila fissa in alto mentre si scorre la pagina» the bar stays visible while scrolling and fixed theme headers are moved just below it. Alternatively, paste [reputando_header id="…"] into your builder's header. = How can I go back to the old carousel (version 2.x)? = Add `add_filter( 'reputando_use_legacy_carousel', '__return_true' );` to a small mu-plugin or to the theme's functions.php. This compatibility option will be removed in a future version. == Screenshots == 1. Widget editor: layout choice with live preview. 2. Widget editor: channels and review filters. 3. Widget editor: Header bar options (rating for each channel, click behaviour). == Changelog == = 3.8.0 = * Collegamento: nella scelta dell'attività da collegare c'è un campo di ricerca con la lente. L'elenco si restringe mentre si scrive, la parte trovata è evidenziata, maiuscole e accenti non contano («citroen» trova «Citroën»). Conteggio dei risultati, frecce e Invio da tastiera, ✕ per cancellare, messaggio se non c'è nessun risultato. * Comprende tutte le novità della 3.7.0. = 3.7.0 = * Riga riassuntiva sopra carosello, griglia, elenco e colonna laterale: su sfondo scuro diventa automaticamente chiara (voto e «by» in bianco, logo Reputando chiaro, loghi dei canali nel cerchio bianco). Le card non cambiano. * Il riconoscimento guarda lo sfondo vero dietro il widget, risalendo i contenitori fino al primo con un colore di sfondo (altrimenti la pagina). Lo fa il browser mentre la pagina si carica: funziona anche con la cache e senza salti visibili. * Nuova opzione in Aspetto → Riga riassuntiva: «Colore della riga riassuntiva» Automatico (predefinito) / Chiaro / Scuro, per i casi con un'immagine di sfondo. = 3.6.1 = * Barra Header fissa: correzione per gli header del tema che diventano fissi con un'animazione (es. Betheme su smartphone). L'header poteva restare sotto la barra finché non si scorreva di nuovo; ora viene sistemato appena finisce l'animazione. = 3.6.0 = * Barra Header: nuova opzione «Tienila fissa in alto mentre si scorre la pagina» (spenta di default), con «Anche su smartphone». La barra resta sempre visibile e gli header fissi del tema (es. Betheme con action bar e header sticky) si mettono subito sotto, anche quando diventano fissi durante lo scorrimento. * Da loggati la barra fissa si mette sotto la barra di amministrazione di WordPress. = 3.5.1 = * Correzione: con i temi che tengono fissi in alto l'action bar o l'header (es. Betheme con «action bar» fissa), la barra Header «in cima a tutte le pagine» finiva sotto e non si vedeva ai visitatori da computer. Ora gli elementi fissi del tema vengono spostati sotto la barra finché è visibile, e tornano al loro posto appena la barra esce dallo schermo. = 3.5.0 = * Recensioni con sole stelle (senza testo): al posto dello spazio vuoto compare una frase scritta, in corsivo e un po' più chiara: «Mario Rossi ha valutato questa attività con 5 stelle» (1 stella al singolare). Booking ed Expedia: «Mario Rossi ha valutato questa attività 9 su 10». * Nella frase i nomi scritti tutto in maiuscolo diventano normali («ISIDORO ORABONA» → «Isidoro Orabona»). Se il nome è nascosto nel widget: «Ha valutato questa attività con 5 stelle». = 3.4.2 = * Barra Header un po' più alta e leggibile: più spazio sopra e sotto (+3 px su computer, +2 px su smartphone), testo da 14 a 15,5 px (da 13 a 14 px su smartphone), stelle e loghi in proporzione. = 3.4.1 = * Correzione: sulla pagina delle recensioni il clic sulla barra Header non scorreva fino al widget in alcuni browser (Chrome con Betheme). = 3.4.0 = * Riga riassuntiva e barra Header: niente più media unica. Ogni canale ha il suo logo, le sue stelle e il suo voto sulla sua scala (es. Google 4,5 · Booking 8,6 · Tripadvisor 4,0), affiancati e separati da una linea sottile. * Il voto è solo il numero dopo le stelle («4,5», non «4,5 su 5») e le stelle sono riempite esattamente in proporzione, come su Google. Tolto il testo «15 recensioni Google». * Su sfondo scuro i loghi dei canali stanno in un cerchio bianco, così si vedono tutti (anche il gufo nero di Tripadvisor). * Su smartphone, con più canali, la barra Header mostra logo e voto; nella riga sopra il widget i canali vanno a capo senza separatori. * Badge: per Booking ed Expedia il voto è sulla loro scala (su 10). = 3.3.1 = * Barra Header, «Va alle recensioni»: se è scelta una pagina delle recensioni il clic porta sempre lì, anche dalle pagine che hanno già un widget (es. il carosello in home); scorre fino al widget solo quando si è già su quella pagina. Senza pagina scelta (sito one page) scorre fino al widget della pagina. * «Non fa niente» rinominato in «La barra non è cliccabile»; spiegazione più chiara sotto la scelta della pagina. = 3.3.0 = * Barra Header, nuova scelta «Al clic sulla barra»: non fa niente, va alle recensioni oppure apre un link a scelta. * «Va alle recensioni» (predefinito): se nella pagina c'è un widget Reputando scorre fino alle recensioni, altrimenti apre la pagina delle recensioni scelta dall'elenco delle pagine del sito, già posizionata sul widget. Senza pagina scelta, sulle pagine senza widget la barra non è cliccabile. * I widget con un link già impostato nella barra continuano ad aprire quel link. * Arrivando alle recensioni il widget lascia spazio sopra, così non finisce sotto un header fisso. * Nell'anteprima dell'editor i link della barra e del badge non portano più via dalla pagina. = 3.2.0 = * La barra Header non è più un tipo di widget ma un'opzione di ogni widget: nuova scheda «Header» nell'editor. Ora puoi avere carosello (o griglia, elenco, colonna, badge) e barra insieme, con gli stessi canali. * La barra ha colori propri (sfondo, testo, stelle) e un link facoltativo, separati da quelli delle card. * Nuovo shortcode [reputando_header id="…"] per mettere solo la barra nell'header del tema o del builder (Betheme, Elementor). * «In cima a tutte le pagine» ora funziona anche con Betheme e con i temi che non usano wp_body_open: il plugin prova il punto di Betheme e, come ultima risorsa, sposta la barra in cima alla pagina. * I widget creati con il layout Header della 3.1.0 vengono convertiti in automatico: carosello con la barra attiva e gli stessi colori della barra. * Nell'elenco dei widget la colonna Layout indica quando la barra Header è attiva. = 3.1.0 = * Nuovo tipo di widget «Header»: barra sottile a tutta larghezza con logo del canale, stelle, «4,9 su 5 · 127 recensioni Google» e «by Reputando», da inserire sopra o dentro l'header (anche fisso). Colori personalizzabili; su smartphone diventa «4,9 (127)». Opzione per mostrarlo in cima a tutte le pagine senza modificare il tema. * Nuova riga riassuntiva sopra carosello, griglia, elenco e colonna laterale, sempre centrata: voto medio, numero di recensioni e «by Reputando». Si può disattivare dall'editor (Aspetto → Riga riassuntiva). * Voto medio e numero di recensioni calcolati su tutte le recensioni dei canali scelti, con cache che si aggiorna a ogni sincronizzazione. * Su sfondi scuri il logo Reputando diventa automaticamente viola chiaro. * Nuovi loghi dei canali: simboli nitidi della stessa misura per tutti i canali (Facebook rotondo, gufo Tripadvisor, stella Trustpilot, aereo Expedia, simbolo Airbnb, «i» di Indeed); Amazon resta in scritta. * Carosello: rimosso il pulsante di pausa; lo scorrimento automatico continua a fermarsi con il mouse sopra, con il focus da tastiera e quando il widget è fuori schermo. * Editor, sezione Canali: canali importati spuntati di default (Google compreso, ma si può togliere), numero di recensioni per canale, spiegazione quando è presente un solo canale; non si può più salvare un widget senza canali (eliminata la regola «nessun canale = tutti»). * Pagina Collegamento: pulsante «Disconnetti account» rosso. = 3.0.2 = * Carosello: pulsante di pausa spostato a destra, dopo la freccia «avanti». * Carosello e griglia: la risposta dell'attività parte alla stessa altezza in tutte le card (spazio del testo fisso a 4 righe, anche per le recensioni con sole stelle). * Nuova pagina Collegamento: stato dell'account, location, recensioni importate e ultima sincronizzazione; pulsanti «Vai ai widget» e «Sincronizzazione e impostazioni»; «Disconnetti account» come azione secondaria. * Editor del widget: anteprima ferma durante le modifiche (scorre solo nella scheda «Scorrimento»), rimossa la barra di scorrimento interna, nascosta la riga «Visibilità», suggerimento per usare il carattere del sito. * Pulsante «Sincronizza recensioni» in italiano; il suo script segue la versione del plugin e non resta più bloccato in cache. * Impostazioni: testo della disinstallazione aggiornato («recensioni, widget e impostazioni»). = 3.0.1 = * Card più regolari: «Leggi tutto» e logo Reputando sempre allineati in fondo, testo su 4 righe e risposta su 2; nella card gli a capo diventano spazi (restano nella finestra «Leggi tutto»). * «Leggi tutto» più discreto: niente grassetto, colore del testo attenuato. * Rimossi i pallini sotto il carosello: restano le frecce e il pulsante di pausa. = 3.0.0 = * Nuovo carosello senza Owl Carousel e senza jQuery (CSS scroll-snap e circa 4 KB di JavaScript): le recensioni sono visibili e scorrevoli anche se uno script viene ritardato o bloccato da plugin di cache e ottimizzazione. * Lo scorrimento automatico parte solo quando il widget è visibile sullo schermo; si ferma quando esce dallo schermo, con il mouse sopra, con il focus da tastiera, a scheda del browser nascosta e con il nuovo pulsante di pausa. Intervallo configurabile (predefinito 5 secondi). Disattivato per chi usa «riduci movimento». * Stili isolati: logo del canale, pulsanti e testi non vengono più modificati dal tema (risolve logo Google ingrandito e pallini invisibili). Il CSS aggiunto nei temi per correggere la 2.x non serve più. * Accessibilità: frecce, pallini e pausa sono veri pulsanti con etichette in italiano e area cliccabile di almeno 24 px; carosello navigabile con le frecce della tastiera; finestra «Leggi tutto» accessibile (dialog nativo). * SEO: il nome del recensore non è più un titolo H2 ma un paragrafo; il tag è configurabile (p, div, span, H2–H6). * Il carosello si adatta allo spazio del widget e non solo allo schermo: funziona in colonne, sidebar e builder. * «Leggi tutto» apre il testo completo senza richieste al server: funziona anche sulle pagine in cache. Rimosso il doppio HTML del popup. * «Carica altre recensioni» senza nonce: non si blocca più sulle pagine in cache. * CSS e JavaScript caricati solo nelle pagine con il widget; icone dei canali da circa 3 KB invece di 50–520 KB. * Admin completamente in italiano. Nuovo editor del widget su una sola pagina, con schede e anteprima dal vivo con le recensioni reali (vista computer e smartphone). * Widget e recensioni non hanno più pagine pubbliche, archivi né pulsante dei page builder. * Aggiornamento automatico del plugin attivato una volta all'installazione, con interruttore in Reputando > Impostazioni. * WP Rocket: rimossa l'esclusione di jQuery dal defer su tutto il sito e lo svuotamento della cache a ogni login di un amministratore. Dopo l'aggiornamento le cache più diffuse vengono svuotate una sola volta. * Corretta la posizione del logo del canale («a destra» lo mostrava a sinistra). * Rimosso il codice dei dati strutturati, che veniva preparato ma mai stampato. * Compatibilità: shortcode, ID e impostazioni dei widget esistenti restano invariati. Filtro `reputando_use_legacy_carousel` per tornare temporaneamente al carosello classico. = 2.3.5 = * Svuotata la cache WP Rocket a ogni login di un amministratore. Nessuno svuotamento ripetuto durante la navigazione in Bacheca o per login di utenti senza manage_options. = 2.3.4 = * Escluse dal LazyLoad le immagini del widget. * Esclusi i CSS del widget da Remove Unused CSS e caricamento asincrono, inclusi i percorsi non normalizzati. Preservati gli stili inline. * Svuotata automaticamente la cache WP Rocket al primo accesso amministrativo dopo aggiornamento. Rafforzata la regola sulle proporzioni delle icone. = 2.3.3 = * Corrette le proporzioni delle icone delle recensioni quando sono presenti attributi HTML width/height: eliminato lo spazio verticale anomalo nei popup. * Uniformata la dimensione delle icone medie anche nei popup. = 2.3.2 = * WP Rocket: corretto il caso in cui WordPress passa insieme script inline prima/dopo e script esterno al filtro script_loader_tag. Tutti i tag del carosello vengono protetti con nowprocket, anche quando uno dei tag è già escluso. * Aggiunti test per output combinato, conservazione del JavaScript e degli attributi CSP, assenza di duplicazioni e isolamento dagli script estranei. = 2.3.1 = * WP Rocket: esclusione automatica dell’intera cartella del plugin da Delay JS e Defer JS, includendo le dipendenze jQuery e jQuery Migrate. * Attributo nowprocket sugli script del carosello e sui relativi script inline generati da WordPress; protetta anche la configurazione AJAX inline. * Dopo l’aggiornamento svuotare la cache WP Rocket e le eventuali cache server/CDN per rigenerare le pagine pubbliche. = 2.3.0 = * Release consolidata delle correzioni di sincronizzazione, backend, anteprime e layout responsive delle versioni 2.2.4–2.2.9. * Include il filtro per mostrare solo recensioni con testo e la visualizzazione vuota delle recensioni con solo voto, mantenendo l’eventuale risposta dell’attività. * Completata la verifica locale di sintassi PHP/JavaScript, regressioni funzionali e interazioni browser su desktop, tablet e mobile. = 2.2.9 = * Sincronizzazione: tentativi automatici limitati dopo errori temporanei, rinnovo del blocco e rilascio solo da parte della richiesta proprietaria. * Rifiutate date vuote, relative o non valide e identificativi API malformati prima dell’importazione. * Carosello: larghezza coerente con Owl, box model indipendente dal tema e frecce in una riga dedicata, senza sovrapposizioni al contenuto. * Corretti popup con allineamento a destra/centro, navigazione Sidebar con una sola recensione e badge con nomi lunghi su mobile. * Corretti link annidati nel badge e icona di riserva per canali sconosciuti. * Backend: anteprime concorrenti annullate, campi opzionali gestiti, login ripetibile dopo errori di rete e protezione dai salvataggi prima del caricamento della risposta. * Popup backend responsive, chiusura con Escape e ripristino del focus; migliorati contrasto e formattazione dei testi. * Corretto il filtro date disattivato; aggiunti controlli sui permessi per i dettagli delle recensioni. = 2.2.8 = * Le recensioni senza testo lasciano vuota la parte del cliente, senza messaggi sostitutivi. L’eventuale risposta dell’attività resta visibile sotto. = 2.2.7 = * Nuova opzione per ogni shortcode: "Mostra solo le recensioni con testo". Disattivata per default, include anche le recensioni con solo voto. * Il filtro considera il testo del cliente, non le risposte dell’attività, e si applica prima del limite e della paginazione in tutti i layout. = 2.2.6 = * Sincronizzazione: accettate recensioni con testo nullo (sola valutazione) senza interrompere l’importazione delle recensioni successive. * Ripristinate le anteprime Slider e Sidebar nella scelta del layout e unificata l’inizializzazione delle anteprime aggiornate via AJAX. * Distinte esplicitamente le risposte dell’attività dal testo dei clienti. Quando il testo è assente, viene mostrata un’indicazione invece di una scheda apparentemente composta dalla sola risposta. * Recupero del testo dai metadati quando il contenuto del post è vuoto e il testo importato è ancora disponibile. = 2.2.5 = * Carosello: frecce disponibili anche quando le recensioni sono tante quante le slide visibili (es. 3 su desktop), con scorrimento circolare. Una sola recensione non mostra frecce. * Pulsanti di navigazione dello slider posizionati entro il contenitore per evitare il taglio nei page builder. = 2.2.4 = * Sicurezza: convalida dei valori grafici e protezione degli attributi HTML, anche per impostazioni già salvate e anteprime. * Sicurezza: la pubblicazione delle risposte verifica il tipo di contenuto, il permesso sulla recensione e quello di pubblicazione. * Sincronizzazione a blocchi con ripresa, protezione dalle esecuzioni concorrenti e aggiornamento delle recensioni esistenti. Le risposte locali da pubblicare vengono preservate. * Corretti paginazione, limite totale, valori predefiniti e filtri con valutazioni decimali. * Corretti login con caratteri speciali, errori nel recupero location e falsi avvisi di token scaduto per risposte inattese o limiti di richieste. * Popup indipendenti per ogni widget, controlli da tastiera, gestione del focus e rispetto delle preferenze di movimento ridotto. * Rimossi gli effetti globali su paragrafi, tabelle e link della pagina. Versionamento stabile degli asset e rimozione del font remoto non necessario. * Booking ed Expedia: conversione proporzionale dalla scala 0–10 a 0–5; badge con cinque stelle anche per valutazioni frazionarie. * La disconnessione con eliminazione recensioni conserva gli shortcode. La cancellazione completa alla disinstallazione è una scelta esplicita nelle impostazioni, disattivata per default. * Ripristinata la compatibilità della sintassi con PHP 7.0. = 2.2.3 = * Sicurezza (critica): il plugin aggiungeva il tag