Aggiungere commenti ai siti Shopify
FastComments è disponibile su Shopify App Store. Installa l'app e trascina i blocchi FastComments su qualsiasi post del blog, pagina prodotto o pagina personalizzata dall'editor del tema di Shopify. Non è necessaria alcuna modifica del codice.
Quando installi l'app, Shopify crea il tuo account FastComments, configura il dominio del tuo negozio e collega automaticamente la fatturazione. Non è necessario registrarsi separatamente su fastcomments.com.
Le pagine di questa guida coprono ogni blocco FastComments fornito dall'app, come funziona il single sign-on per i tuoi clienti Shopify e come importare i commenti esistenti di Shopify prima di effettuare il passaggio.
Installa l'app FastComments 
Installa dall'App Store di Shopify
- Apri la pagina di FastComments sull'App Store di Shopify.
- Clicca Add app e scegli il piano che desideri durante il flusso di installazione.
- Shopify ti reindirizza nell'admin di FastComments all'interno di Shopify quando l'installazione è completata.
Questo è tutto per l'installazione. Non c'è nulla da incollare nei file del tuo tema.
Cosa viene configurato per te
L'installazione esegue tutto ciò che altrimenti faresti manualmente:
- Viene creato un tenant FastComments per il tuo negozio e collegato al dominio del tuo shop.
- L'URL del tuo negozio viene aggiunto ai domini autorizzati del tenant, così i commenti vengono caricati senza errori di dominio.
- Viene scritto un metafield del negozio
fastcomments.tenant_idcosì ogni blocco sa contro quale tenant renderizzare. - Il single sign-on per i tuoi clienti Shopify è abilitato per impostazione predefinita.
- La fatturazione avviene tramite Shopify Managed Pricing. Gli addebiti compaiono sul tuo consueto estratto conto Shopify. Effettua upgrade, downgrade o cancellazione da Settings > Apps and sales channels > FastComments nel pannello di amministrazione di Shopify.
Se il tuo negozio era già cliente FastComments prima di installare l'app, l'installazione riutilizza il tenant esistente invece di crearne uno nuovo.
L'admin incorporato
Quando apri l'app FastComments dal pannello di Shopify, arrivi in una dashboard con riquadri ad accesso singolo che portano al backend completo di FastComments:
- Dashboard: impostazioni account, utilizzo e dettagli dell'abbonamento.
- Moderation Queue: approva, rifiuta e rispondi ai commenti in tutto il negozio.
- Customize: regola colori del widget, font, regole di moderazione e configurazione.
- Ratings & Reviews Helper: configura le valutazioni a stelle e le domande di recensione se vuoi usare il blocco Reviews Summary.
Ogni riquadro apre FastComments con un link di accesso ad uso singolo, quindi non è necessario un accesso separato.
Successivo: aggiungi blocchi al tuo negozio
Apri l'editor del tema di Shopify (Negozio online > Temi > Personalizza), apri il template al quale vuoi aggiungere commenti o recensioni e clicca Add block. I blocchi FastComments appaiono sotto App. Il resto di questa guida copre ciascuno di essi.
Aggiungi commenti agli articoli del blog e ai prodotti
Il blocco FastComments è il widget principale per i commenti. Aggiungilo ai template dei post del blog, ai template dei prodotti o a qualsiasi altra pagina in cui vuoi una discussione o una chat in tempo reale.
Aggiungi il blocco
- Apri l'editor del tema di Shopify (Online Store > Themes > Customize).
- Scegli il template sul quale vuoi abilitare i commenti: Blog post, Product, o qualsiasi altro template di pagina o sezione.
- Nella sezione in cui vuoi che appaiano i commenti, clicca Add block.
- Sotto Apps, seleziona FastComments.
- Clicca Save.
Il blocco appare immediatamente. Non c'è nessun Tenant ID da inserire; il tenant del tuo negozio viene configurato automaticamente quando installi l'app.
Impostazioni
| Setting | What it does | Default |
|---|---|---|
| Tenant ID (optional) | Sovrascrive quale tenant di FastComments viene usato per il rendering del blocco. Lascia vuoto per usare il tenant configurato automaticamente per il negozio. Trova un Tenant ID manuale su fastcomments.com/auth/my-account/api-secret. | (blank) |
| SSO | Effettua automaticamente il login del visitatore con il suo account cliente Shopify prima che commenti. Vedi Auto-Login Shopify Customers. | On |
| Commenting Style | Threaded per risposte nidificate e voti, oppure Streaming per un feed chat in tempo reale. | Threaded |
| Custom URL ID | Sovrascrive l'identificatore di pagina rilevato automaticamente. Usalo quando vuoi che due URL condividano lo stesso thread di commenti. | (auto-detected) |
Come viene scelto l'identificatore di pagina
Ogni thread di commenti è indicizzato da un URL ID. Il blocco ne seleziona uno automaticamente:
- Blog post template:
shopify-article-{article.id}, che rimane stabile anche se cambiano lo slug o il titolo. - Product template:
shopify-product-{product.id}, che rimane stabile anche se cambiano lo slug o il titolo. - Altri template: il request path.
Se imposti Custom URL ID, viene usato quel valore al posto dell'identificatore automatico. Usa lo stesso Custom URL ID su più blocchi (per esempio, su una variante localizzata di una pagina prodotto) per condividere un unico thread di commenti.
Threaded vs Streaming
Threaded è il valore predefinito. I visitatori si rispondono a vicenda, votano e gli strumenti di moderazione funzionano come previsto. Ideale per post di blog e recensioni di prodotto.
Streaming elimina l'annidamento e mostra i nuovi commenti in tempo reale appena vengono pubblicati, come un feed di chat. Ideale per lanci di prodotto, eventi in diretta e pagine community.
Più blocchi sulla stessa pagina
Il blocco può essere aggiunto più di una volta allo stesso template. Per esempio, un riepilogo delle recensioni in cima a una pagina prodotto e un blocco FastComments in fondo. I blocchi condividono un URL ID, quindi il riepilogo riflette i commenti sottostanti.
Suggerimenti
- Il blocco si nasconde nella preview dell'editor del tema con una nota gialla se non riesce a trovare un tenant. Se questo appare nel tuo negozio live, reinstalla l'app FastComments.
- Per una pagina prodotto, il blocco FastComments funge anche da widget per le recensioni del prodotto. Abbinalo a FastComments - Reviews Summary per un riepilogo delle valutazioni a stelle in cima alla pagina.
Aggiungi un badge con il conteggio dei commenti
Il blocco FastComments - Comment Count visualizza un piccolo conteggio dei commenti per una singola pagina. Usalo nelle liste di post del blog, nelle schede prodotto o in qualsiasi template che colleghi a una pagina con commenti, così i visitatori possono vedere quanto è attiva ogni discussione prima di aprirla.
Add the block
- Apri l'editor del tema di Shopify.
- Apri il template in cui vuoi che appaia il conteggio. Per esempio, il template Blog (l'elenco dei post) o una sezione di elenco prodotti.
- Clicca su Aggiungi blocco nella sezione che visualizza ogni elemento.
- Sotto Apps, seleziona FastComments - Comment Count.
- Clicca su Salva.
Impostazioni
| Impostazione | Cosa fa | Predefinito |
|---|---|---|
| ID tenant (opzionale) | Sovrascrive da quale tenant FastComments il conteggio legge i dati. Lascia vuoto per usare il tenant configurato automaticamente per il negozio. | (vuoto) |
| ID URL personalizzato | Sovrascrive l'identificatore di pagina che il conteggio cerca. Usalo quando il conteggio si trova in una pagina diversa rispetto al blocco FastComments che monitora. | (rilevato automaticamente) |
Come il conteggio corrisponde alla discussione dei commenti
Il blocco Comment Count utilizza la stessa logica di rilevamento automatico del blocco FastComments:
- Template dei post del blog:
shopify-article-{article.id} - Template prodotto:
shopify-product-{product.id} - Altri template: il percorso della richiesta
Se imposti un ID URL personalizzato sul blocco FastComments in una pagina, imposta lo stesso ID URL personalizzato sul blocco Comment Count affinché puntino alla stessa discussione.
Suggerimenti
- I conteggi per ogni elemento della pagina vengono recuperati con una sola richiesta, quindi aggiungere il blocco a ogni elemento in una lista lunga non comporta richieste aggiuntive.
- L'uso previsto è un blocco Comment Count per articolo o prodotto in un elenco; il blocco può essere aggiunto tutte le volte che ti serve.
Aggiungi un feed dei commenti recenti
Il blocco FastComments - Recent Comments mostra i commenti più recenti di tutto il tuo negozio. Usalo per mostrare attività fresca in una barra laterale, nel footer o in una sezione della homepage.
Aggiungi il blocco
- Apri l'editor del tema Shopify.
- Apri il template in cui vuoi il feed. Una sezione della barra laterale, la homepage o l'indice del blog funzionano tutti bene.
- Fai clic su Aggiungi blocco nella sezione che dovrebbe contenerlo.
- Sotto App, seleziona FastComments - Recent Comments.
- Fai clic su Salva.
Impostazioni
| Setting | What it does | Default |
|---|---|---|
| Tenant ID (opzionale) | Sovrascrivi il tenant FastComments da cui il feed legge. Lasciare vuoto per usare il tenant configurato automaticamente del negozio. | (vuoto) |
| Number of comments | Quanti commenti recenti mostrare. Intervallo da 1 a 50. | 5 |
Suggerimenti
- Ogni commento rimanda alla pagina in cui è stato pubblicato, quindi il blocco funge anche da suggerimento di navigazione "di cosa le persone stanno parlando in questo momento".
- Il feed è a livello di negozio. Per mostrare i commenti recenti di una singola pagina, usa invece il blocco FastComments su quella pagina.
Aggiungi un feed delle discussioni recenti
Il blocco FastComments - Recent Discussions elenca le pagine del tuo negozio con l'attività di commento più recente, una voce per pagina. Usalo quando vuoi che i visitatori scoprano le discussioni attive piuttosto che i singoli commenti.
Aggiungi il blocco
- Apri l'editor del tema Shopify.
- Apri il template dove vuoi il feed, ad esempio una barra laterale, il footer, l'indice del blog o una sezione della homepage.
- Fai clic su Add block nella sezione che deve contenerlo.
- Sotto Apps, seleziona FastComments - Recent Discussions.
- Fai clic su Save.
Impostazioni
| Impostazione | Cosa fa | Predefinito |
|---|---|---|
| Tenant ID (opzionale) | Sovrascrive quale tenant FastComments il feed legge. Lascia vuoto per usare il tenant configurato automaticamente del negozio. | (blank) |
| Numero di commenti | Quante discussioni recenti mostrare. Intervallo da 1 a 50. | 20 |
Recent Discussions vs Recent Comments
Entrambi i blocchi prelevano gli stessi dati, ma mostrano viste diverse:
- Recent Comments: un elenco piatto dei commenti più recenti. Ideale per "ciò che è stato appena detto".
- Recent Discussions: una voce per pagina, ordinata per l'attività più recente. Ideale per "quali discussioni sono attive in questo momento".
Puoi usare entrambi nello stesso negozio. Per esempio, Recent Comments nella barra laterale del blog e Recent Discussions nella homepage.
Aggiungi un elenco delle pagine principali
Il blocco FastComments - Top Pages elenca le pagine del tuo negozio con la maggiore attività di commenti complessiva. Usalo per mettere in evidenza i post o i prodotti più discussi.
Aggiungi il blocco
- Apri l'editor del tema Shopify.
- Apri il template dove vuoi inserire la lista, come una barra laterale, il footer o la sezione indice del blog.
- Clicca Add block nella sezione che deve contenerlo.
- Sotto Apps, seleziona FastComments - Top Pages.
- Clicca Save.
Impostazioni
| Impostazione | Cosa fa | Predefinito |
|---|---|---|
| Tenant ID (optional) | Sovrascrive il tenant FastComments da cui la lista legge i dati. Lascia vuoto per usare il tenant configurato automaticamente dal negozio. | (blank) |
Top Pages vs Recent Discussions
- Top Pages ordina per engagement totale, quindi gli stessi post tendono a rimanere in cima per un po'. Ideale per una barra laterale "popular posts".
- Recent Discussions ordina per attività più recente, quindi la lista cambia frequentemente. Ideale per un pannello "what's hot right now".
Aggiungi un riepilogo delle recensioni
Il blocco FastComments - Riepilogo Recensioni mostra un punteggio aggregato a stelle e la suddivisione delle recensioni per una pagina. Abbinalo al blocco FastComments nei template dei prodotti per il layout standard delle recensioni: riepilogo in alto, modulo per le recensioni e recensioni sotto.
Prerequisito: configura Valutazioni e Recensioni
Il blocco Riepilogo recensioni mostra le domande di valutazione che hai configurato per il tuo negozio. Configurale prima:
- Apri l'app FastComments nel tuo pannello di amministrazione Shopify.
- Clicca sulla tessera Assistente Valutazioni e Recensioni (o apri direttamente Ratings & Reviews Helper).
- Aggiungi le domande che vuoi che ogni recensore risponda (valutazione complessiva a stelle, "com’è la vestibilità", ecc.).
Senza domande configurate, il blocco riepilogo non ha nulla da aggregare.
Aggiungi il blocco
- Apri l'editor del tema di Shopify.
- Apri il template Product (o il template di pagina dove vuoi il riepilogo).
- Clicca su Aggiungi blocco vicino alla parte superiore della sezione pagina, sopra il punto dove sarà il blocco FastComments.
- In App, seleziona FastComments - Riepilogo Recensioni.
- Aggiungi un blocco FastComments più in basso sulla stessa pagina se non lo hai già fatto, così i visitatori possono lasciare recensioni.
- Clicca su Salva.
Impostazioni
| Setting | What it does | Default |
|---|---|---|
| Tenant ID (optional) | Sovrascrive da quale tenant FastComments il riepilogo legge. Lascia vuoto per usare il tenant automaticamente configurato per il negozio. | (vuoto) |
| Custom URL ID | Sovrascrive l'identificatore della pagina su cui il riepilogo si aggrega. Usalo quando il riepilogo si trova in una pagina diversa rispetto al blocco FastComments che riflette. | (rilevato automaticamente) |
Come il riepilogo corrisponde alle recensioni
Il blocco Riepilogo recensioni usa la stessa logica di rilevamento automatico del blocco FastComments:
- Product template:
shopify-product-{product.id} - Blog post template:
shopify-article-{article.id} - Other templates: the request path
Per una pagina prodotto normale, il riepilogo e il thread di commenti condividono automaticamente un ID URL, senza necessità di configurazione.
Suggerimenti
- Il riepilogo è in sola lettura. Per raccogliere recensioni, hai bisogno di un blocco FastComments sulla stessa pagina.
- Se modifichi le domande di valutazione nell’Assistente Valutazioni e Recensioni dopo aver raccolto recensioni, il riepilogo si ricalcola rispetto al nuovo set di domande.
Accesso automatico per i clienti Shopify
The FastComments block supporta il single sign-on in modo che i tuoi clienti Shopify possano commentare come se stessi senza creare un account FastComments separato.
Come funziona
Quando un visitatore che ha effettuato l'accesso al tuo negozio apre una pagina con il blocco FastComments:
- Il blocco rileva l'oggetto Shopify
customer. - Invia il nome e l'email del cliente a FastComments tramite una richiesta app proxy firmata.
- FastComments crea o associa un utente identificato da
shopify-{customerId}, così lo stesso cliente viene sempre mappato allo stesso utente FastComments tra sessioni e reinstallazioni. - Il loro nome appare nei commenti. Non viene loro richiesto di effettuare nuovamente l'accesso.
Se il visitatore non ha effettuato l'accesso al negozio, il blocco ricade sui commenti anonimi (o sul flusso di accesso di FastComments, a seconda della configurazione del widget).
Disattivare SSO
SSO è attivato per impostazione predefinita per ogni blocco FastComments. Per disattivarlo su uno specifico blocco:
- Apri l'editor del tema Shopify.
- Apri il template che contiene il blocco e fai clic sul blocco per selezionarlo.
- Deseleziona SSO.
- Fai clic su Salva.
Disattiva SSO se vuoi che i commentatori scelgano un'identità separata per la conversazione. Ad esempio, una pagina di community interna dove il personale commenta con un nome visualizzato diverso.
Cosa riceve FastComments
Il payload SSO inviato per ogni cliente contiene:
- Un ID utente derivato dall'ID cliente Shopify (
shopify-{customerId}). - L'email del cliente (usata per identificare l'utente; non visualizzata pubblicamente).
- Il nome visualizzato del cliente (usato come autore del commento).
Non vengono inviati dati di cronologia ordini, pagamenti o indirizzi. Il payload è firmato lato server; il browser del cliente non vede mai una credenziale.
Link di accesso e disconnessione
Quando SSO è attivato, i link di accesso e disconnessione del widget dei commenti puntano a /account/login e /account/logout, le rotte standard dell'account cliente Shopify. Non c'è nulla da configurare. I link funzionano per qualsiasi negozio con gli account cliente abilitati.
Importa commenti esistenti
Se hai già commenti nei tuoi post del blog Shopify e vuoi conservarli, importali in FastComments prima di disabilitare il sistema di commenti nativo di Shopify.
L'importazione deve essere eseguita mentre i commenti nativi di Shopify sono ancora attivi e visibili. Una volta che li disabiliti, FastComments non potrà più leggerli.
Come avviare un'importazione
- Assicurati che l'app FastComments sia installata nel tuo negozio.
- Lascia per ora i commenti nativi di Shopify abilitati.
- Apri un ticket di supporto e comunicaci quali blog importare.
L'importazione viene completata in meno di un giorno.
Una volta che i tuoi commenti esistenti sono in FastComments, aggiungi il blocco FastComments al modello del tuo post del blog e rimuovi o disabilita i commenti nativi di Shopify. Vedi Aggiungere commenti ai post del blog e ai prodotti.
Se non hai bisogno di conservare i commenti esistenti, puoi saltare questa pagina.
Personalizzazione
Colori, caratteri, regole di moderazione, HTML consentito e i commenti anonimi sono tutti configurabili per adattarsi al branding del tuo negozio.
Apri l'app FastComments nel pannello di amministrazione di Shopify e fai clic sulla tessera Personalizza per aprire la schermata di personalizzazione del widget. Utilizza un link di accesso monouso, quindi non è necessario un accesso separato.
Per l'elenco completo delle opzioni di personalizzazione, consulta la guida alle personalizzazioni e alla configurazione.
Errori di dominio
Se hai installato FastComments dallo Shopify App Store, il dominio del tuo negozio viene aggiunto automaticamente ai domini autorizzati del tenant e non dovresti vedere un errore relativo al dominio. Questa pagina si applica se hai seguito il percorso di installazione manuale, o se il tuo storefront è servito su un dominio personalizzato che non era registrato con Shopify al momento dell'installazione dell'app.
Potresti ricevere un errore di autorizzazione simile a questo:
Questo significa che FastComments non riconosce il dominio su cui viene caricato il widget come autorizzato per il tuo tenant.
Per risolvere, aggiungi il dominio al tuo account FastComments: Configura domini.
Installazione manuale (avanzata)
Se non puoi installare l'app dello Shopify App Store, puoi comunque aggiungere FastComments modificando il tuo tema. Questo percorso è utile quando vuoi collegare un tenant FastComments che già possiedi, oppure quando stai incorporando su una vetrina Shopify dove l'app non è un'opzione.
L'installazione tramite app è il percorso supportato per la maggior parte dei negozi. Usalo solo se l'app non è adatta.
Step 1: Disable Shopify's native comments
Nel pannello di amministrazione di Shopify, vai a Blog posts > Manage blogs, apri ogni blog e imposta Comments are disabled nel pannello a destra. Salva.
Questo impedisce che il sistema di commenti integrato di Shopify venga mostrato insieme a FastComments.
Step 2: Open the blog theme template
Nel pannello di amministrazione di Shopify:
- Vai a Online Store > Themes.
- Sotto il tema corrente, clicca Actions > Edit code.
- Nel file browser a sinistra, apri Sections e clicca
main-article.liquid.
Questo è il template che Shopify renderizza per un singolo articolo del blog.
Step 3: Paste the FastComments snippet
Scorri fino a circa la riga 100 di main-article.liquid, subito dopo la chiusura </div> del corpo dell'articolo. Incolla il seguente snippet:
Sostituisci "demo" con il tuo Tenant ID da fastcomments.com/auth/my-account/api-secret. Clicca Save.
Step 4: Authorize your shop domain
Apri un post del blog sul tuo negozio live. Se vedi un errore di autorizzazione invece del widget dei commenti, FastComments ha bisogno di sapere che il tuo negozio è autorizzato a usare questo tenant. Vedi Errori di dominio.
Adding FastComments to other pages
Lo stesso snippet funziona su qualsiasi template Liquid, incluse le pagine prodotto, le pagine personalizzate e la homepage. Incollalo dove vuoi che compaiano i commenti e regola urlId se desideri un identificatore stabile per pagina (ad esempio, urlId: "{{ product.id }}" in un template prodotto).