Reacties toevoegen aan Shopify-sites
FastComments is beschikbaar in de Shopify App Store. Installeer de app en plaats FastComments-blokken op elk blogbericht, productpagina of aangepaste pagina vanuit de thema-editor van Shopify. Geen codebewerking vereist.
Wanneer je de app installeert, voorziet Shopify je FastComments-account, koppelt je winkel-domein en verbindt de facturering automatisch. Je hoeft je niet apart aan te melden op fastcomments.com.
De pagina's in deze gids behandelen elk FastComments-blok dat de app biedt, hoe single sign-on werkt voor je Shopify-klanten, en hoe je bestaande Shopify-opmerkingen kunt importeren voordat je overschakelt.
Installeer de FastComments-app 
Installeren vanuit de Shopify App Store
- Open de FastComments-pagina in de Shopify App Store.
- Klik op Add app en kies tijdens de installatieflow het gewenste abonnement.
- Shopify verwijst je terug naar de FastComments-beheeromgeving binnen Shopify wanneer de installatie is voltooid.
Dat is de volledige installatie. Er hoeft niets in je thema-bestanden geplakt te worden.
Wat er voor je wordt ingesteld
De installatie voert alles uit wat je anders handmatig zou moeten doen:
- Er wordt een FastComments-tenant aangemaakt voor je winkel en gekoppeld aan je shopdomein.
- De store-URL van je shop wordt toegevoegd aan de geautoriseerde domeinen van de tenant, zodat reacties laden zonder domeinfout.
- Er wordt een
fastcomments.tenant_idshop-metavelden geschreven zodat elk blok weet tegen welke tenant het moet renderen. - Single sign-on voor je Shopify-klanten is standaard ingeschakeld.
- De facturering loopt via Shopify Managed Pricing. Kosten verschijnen op je reguliere Shopify-factuur. Upgrade, downgrade of annuleer via Instellingen > Apps en verkoopkanalen > FastComments in je Shopify-beheer.
Als je shop al klant was bij FastComments voordat je de app installeerde, hergebruikt de installatie de bestaande tenant in plaats van een nieuwe aan te maken.
De ingebedde beheeromgeving
Wanneer je de FastComments-app vanuit je Shopify-beheer opent, kom je op een dashboard met één-klik-tegels naar de volledige FastComments-backend:
- Dashboard: accountinstellingen, gebruik en abonnementsgegevens.
- Moderation Queue: reacties door je hele winkel goedkeuren, afwijzen en beantwoorden.
- Customize: widgetkleuren, lettertypen, moderatieregels en configuratie aanpassen.
- Ratings & Reviews Helper: sterbeoordelingen en reviewvragen instellen als je de Reviews Summary-blok wilt gebruiken.
Elke tegel opent FastComments met een éénmalige loginlink, zodat je geen apart aanmeldaccount nodig hebt.
Volgende stap: blokken toevoegen aan je winkel
Open je Shopify-thema-editor (Online Store > Themes > Customize), open de template waarin je reacties of beoordelingen wilt toevoegen en klik op Add block. De FastComments-blokken verschijnen onder Apps. De rest van deze gids behandelt elk blok afzonderlijk.
Reacties toevoegen aan blogberichten en producten
Het FastComments-blok is de hoofdwidget voor reacties. Voeg het toe aan blogpost-templates, product-templates, of elke andere pagina waar je een discussiethread of een live chat wilt.
Het blok toevoegen
- Open de Shopify theme editor (Online Store > Themes > Customize).
- Kies de template waar je reacties op wilt: Blog post, Product, of een andere pagina- of sectie-template.
- Klik in de sectie waar je reacties wilt laten verschijnen op Add block.
- Onder Apps, selecteer FastComments.
- Klik op Save.
Het blok verschijnt direct. Er hoeft geen Tenant ID te worden ingevuld; de tenant van je winkel wordt automatisch gekoppeld wanneer je de app installeert.
Instellingen
| Instelling | Wat het doet | Standaard |
|---|---|---|
| Tenant ID (optioneel) | Overschrijf tegen welke FastComments-tenant het blok rendert. Laat leeg om de automatisch geconfigureerde tenant van de winkel te gebruiken. Een handmatige tenant ID vind je op fastcomments.com/auth/my-account/api-secret. | (leeg) |
| SSO | Logt de bezoeker automatisch in met zijn Shopify-klantaccount voordat er gereageerd wordt. Zie Auto-Login Shopify Customers. | Aan |
| Commenting Style | Threaded voor geneste reacties en stemmen, of Streaming voor een realtime chatfeed. | Threaded |
| Custom URL ID | Overschrijf de automatisch gedetecteerde pagina-identificatie. Gebruik dit wanneer je wilt dat twee URL's één commentaardelen. | (automatisch gedetecteerd) |
Hoe de pagina-identificatie wordt gekozen
Elke commentaarthread is gekoppeld aan een URL ID. Het blok kiest er automatisch één:
- Blogpost-template:
shopify-article-{article.id}, wat stabiel blijft bij wijzigingen in slug en titel. - Product-template:
shopify-product-{product.id}, wat stabiel blijft bij wijzigingen in slug en titel. - Andere templates: het request-pad.
Als je Custom URL ID instelt, wordt die waarde in plaats daarvan gebruikt. Gebruik dezelfde Custom URL ID over meerdere blokken (bijvoorbeeld op een gelokaliseerde variant van een productpagina) om één commentaarthread te delen.
Threaded vs Streaming
Threaded is de standaard. Bezoekers reageren op elkaar, kunnen stemmen en de moderatietools werken zoals verwacht. Ideaal voor blogposts en productreviews.
Streaming laat het threaden vallen en toont nieuwe reacties in realtime zodra ze geplaatst worden, zoals een chatfeed. Ideaal voor productlanceringen, live events en communitypagina's.
Meerdere blokken op dezelfde pagina
Het blok kan meer dan eens aan dezelfde template worden toegevoegd. Bijvoorbeeld een Reviews Summary bovenaan een productpagina en een FastComments-blok onderaan. De blokken delen een URL ID, dus de samenvatting weerspiegelt de reacties eronder.
Tips
- Het blok verbergt zichzelf in de theme editor preview met een gele melding als het geen tenant kan vinden. Als dat in je live winkel verschijnt, installeer de FastComments-app opnieuw.
- Voor een productpagina dient het FastComments-blok tevens als je productreviews-widget. Combineer het met FastComments - Reviews Summary voor een sterrenbeoordelingssamenvatting bovenaan de pagina.
Een reactietellerbadge toevoegen
Het FastComments - Comment Count-blok toont een klein aantal reacties voor één pagina. Gebruik het in blogpostlijsten, productkaarten of elke template die linkt naar een pagina met reacties, zodat bezoekers kunnen zien hoe actief elke discussie is voordat ze doorklikken.
Het blok toevoegen
- Open de Shopify-thema-editor.
- Open de template waar je het aantal wilt laten verschijnen. Bijvoorbeeld de Blog-template (de postlijst) of een productoverzichtsectie.
- Klik op Add block in de sectie die elk item weergeeft.
- Onder Apps, selecteer FastComments - Comment Count.
- Klik op Save.
Instellingen
| Instelling | Wat het doet | Standaard |
|---|---|---|
| Tenant ID (optioneel) | Overschrijf van welke FastComments-tenant het aantal wordt gelezen. Laat leeg om de automatisch geconfigureerde tenant van de winkel te gebruiken. | (leeg) |
| Custom URL ID | Overschrijf de pagina-identificatie waar het aantal naar zoekt. Gebruik dit wanneer het aantal zich op een andere pagina bevindt dan het FastComments-blok dat het volgt. | (automatisch gedetecteerd) |
Hoe het aantal overeenkomt met de discussie
Het Comment Count-blok gebruikt dezelfde auto-detectielogica als het FastComments-blok:
- Blogpost-template:
shopify-article-{article.id} - Product-template:
shopify-product-{product.id} - Andere templates: het verzoekpad
Als je een Custom URL ID instelt op het FastComments-blok op een pagina, stel dan dezelfde Custom URL ID in op het Comment Count-blok zodat ze naar dezelfde discussie verwijzen.
Tips
- De aantallen voor elk item op de pagina worden in één verzoek opgehaald, dus het toevoegen van het blok aan elk item in een lange lijst heeft geen extra round-trip-kosten.
- Eén Comment Count-blok per artikel of product in een overzicht is het verwachte gebruik; het blok kan zo vaak worden toegevoegd als je nodig hebt.
Een feed met recente reacties toevoegen
De FastComments - Recent Comments-blok toont de meest recente reacties in je hele winkel. Gebruik het om recente activiteit in een zijbalk, voettekst of op de startpagina weer te geven.
Voeg het blok toe
- Open de Shopify-thema-editor.
- Open het template waar je de feed wilt hebben. Een zijbalksectie, de startpagina of de blogindex werken allemaal goed.
- Klik op Add block in de sectie die het moet bevatten.
- Onder Apps, selecteer FastComments - Recent Comments.
- Klik op Save.
Instellingen
| Instelling | Wat het doet | Standaard |
|---|---|---|
| Tenant ID (optional) | Overschrijf welke FastComments-tenant de feed uitleest. Laat leeg om de automatisch geconfigureerde tenant van de winkel te gebruiken. | (blank) |
| Number of comments | Hoeveel recente reacties worden weergegeven. Bereik 1 tot 50. | 5 |
Tips
- Elke reactie linkt naar de pagina waarop deze is geplaatst, dus het blok dient ook als een "waar mensen het nu over hebben" navigatiehint.
- De feed geldt winkelbreed. Om recente reacties voor één pagina te tonen, gebruik in plaats daarvan het FastComments-blok op die pagina.
Een feed met recente discussies toevoegen
Het FastComments - Recent Discussions blok toont de pagina's in je winkel met de meest recente commentaaractiviteit, één vermelding per pagina. Gebruik het wanneer je bezoekers actieve discussies wilt laten ontdekken in plaats van individuele reacties.
Het blok toevoegen
- Open de Shopify thema-editor.
- Open de template waar je de feed wilt hebben, zoals een zijbalk, footer, blogindex of homepage-sectie.
- Klik op Blok toevoegen in de sectie die het moet bevatten.
- Onder Apps, selecteer FastComments - Recent Discussions.
- Klik op Opslaan.
Instellingen
| Instelling | Wat het doet | Standaard |
|---|---|---|
| Tenant ID (optioneel) | Overschrijf van welke FastComments tenant de feed leest. Laat leeg om de automatisch geconfigureerde tenant van de winkel te gebruiken. | (leeg) |
| Aantal reacties | Hoeveel recente discussies er getoond worden. Bereik 1 tot 50. | 20 |
Recent Discussions vs Recent Comments
Beide blokken halen hun data uit dezelfde bron, maar tonen verschillende weergaven:
- Recent Comments: een platte lijst van de laatste individuele reacties. Ideaal voor "wat is er net gezegd".
- Recent Discussions: één vermelding per pagina, gesorteerd op meest recente activiteit. Ideaal voor "welke discussies zijn nu actief".
Je kunt beide in dezelfde winkel gebruiken. Bijvoorbeeld, Recent Comments in de zijbalk van de blog en Recent Discussions op de homepage.
Een lijst met toppagina's toevoegen
Het FastComments - Top Pages blok toont de pagina's op je winkel met de meeste commentaaractiviteit in het algemeen. Gebruik het om je meest besproken berichten of producten onder de aandacht te brengen.
Het blok toevoegen
- Open de Shopify thema-editor.
- Open de template waar je de lijst wilt hebben, zoals een sidebar, footer of blogindex-sectie.
- Klik op Blok toevoegen in de sectie die het moet bevatten.
- Onder Apps, selecteer FastComments - Top Pages.
- Klik op Opslaan.
Instellingen
| Instelling | Wat het doet | Standaard |
|---|---|---|
| Tenant ID (optioneel) | Overschrijf van welke FastComments tenant de lijst leest. Laat leeg om de automatisch geconfigureerde tenant van de winkel te gebruiken. | (leeg) |
Top Pages vs Recent Discussions
- Top Pages rangschikt op totale betrokkenheid, dus dezelfde berichten blijven vaak een tijdje bovenaan. Geschikt voor een "populaire berichten" sidebar.
- Recent Discussions rangschikt op meest recente activiteit, dus de lijst verandert voortdurend. Geschikt voor een "wat is er nu populair" paneel.
Een samenvatting van beoordelingen toevoegen
Het FastComments - Reviews Summary blok toont een geaggregeerde sterrenbeoordeling en een overzicht van reviews voor een pagina. Combineer het met het FastComments blok op producttemplates voor de standaard reviews-layout: samenvatting bovenaan, reviewformulier en reviews eronder.
Vereiste: stel Ratings & Reviews in
Het Reviews Summary blok toont de beoordelingsvragen die je voor je winkel hebt geconfigureerd. Stel die eerst in:
- Open de FastComments app in je Shopify-beheerdersomgeving.
- Klik op de tegel Ratings & Reviews Helper (of open Ratings & Reviews Helper rechtstreeks).
- Voeg de vragen toe die elke reviewer moet beantwoorden (algemene sterrenbeoordeling, "hoe was de pasvorm", enz.).
Zonder geconfigureerde vragen heeft het samenvattingsblok niets om samen te vatten.
Voeg het blok toe
- Open de Shopify theme editor.
- Open de Product template (of de paginatemplate waar je de samenvatting wilt).
- Klik op Add block bovenaan de paginasectie, boven de plek waar het FastComments blok komt.
- Kies onder Apps voor FastComments - Reviews Summary.
- Voeg lager op dezelfde pagina een FastComments blok toe als je die nog niet hebt, zodat bezoekers reviews kunnen achterlaten.
- Klik op Save.
Instellingen
| Instelling | Wat het doet | Standaard |
|---|---|---|
| Tenant ID (optioneel) | Overschrijf van welke FastComments tenant de samenvatting leest. Laat leeg om de automatisch geconfigureerde tenant van de winkel te gebruiken. | (leeg) |
| Custom URL ID | Overschrijf de pagina-identificatie waarop de samenvatting aggregeert. Gebruik dit wanneer de samenvatting op een andere pagina staat dan het FastComments blok waarop deze betrekking heeft. | (automatisch gedetecteerd) |
Hoe de samenvatting de reviews matcht
Het Reviews Summary blok gebruikt dezelfde auto-detectielogica als het FastComments blok:
- Producttemplate:
shopify-product-{product.id} - Blogposttemplate:
shopify-article-{article.id} - Andere templates: het request-pad
Op een normale productpagina delen de samenvatting en de commentthread automatisch een URL ID, zonder configuratie.
Tips
- De samenvatting is read-only. Om reviews te verzamelen, heb je een FastComments blok op dezelfde pagina nodig.
- Als je beoordelingsvragen in Ratings & Reviews Helper wijzigt nadat er reviews zijn verzameld, berekent de samenvatting opnieuw op basis van de nieuwe set vragen.
Automatisch inloggen voor Shopify-klanten
Het FastComments-blok ondersteunt single sign-on, zodat je Shopify-klanten kunnen reageren als zichzelf zonder een apart FastComments-account aan te maken.
Hoe het werkt
Wanneer een bezoeker die is ingelogd op je winkel een pagina opent met het FastComments-blok:
- Het blok detecteert het Shopify
customer-object. - Het stuurt de naam en het e-mailadres van de klant naar FastComments via een ondertekend app proxy-verzoek.
- FastComments maakt een gebruiker aan of koppelt deze op basis van
shopify-{customerId}, zodat dezelfde klant altijd wordt gemapt naar dezelfde FastComments-gebruiker, over sessies en herinstallaties heen. - De naam van de bezoeker verschijnt bij diens reacties. Er wordt niet opnieuw gevraagd in te loggen.
Als de bezoeker niet is ingelogd op de winkel, valt het blok terug op anoniem reageren (of de FastComments-aanmeldflow, afhankelijk van je widgetconfiguratie).
SSO uitschakelen
SSO staat standaard aan voor elk FastComments-blok. Om het uit te schakelen voor een specifiek blok:
- Open de Shopify theme editor.
- Open de template die het blok bevat en klik op het blok om het te selecteren.
- Vink SSO uit.
- Klik op Save.
Schakel SSO uit als je wilt dat commenters een aparte identiteit kiezen voor het gesprek. Bijvoorbeeld een interne community-pagina waar medewerkers reageren onder een andere weergavenaam.
Wat FastComments ontvangt
De SSO-payload die per klant wordt verzonden bevat:
- Een gebruikers-ID afgeleid van het Shopify-klant-ID (
shopify-{customerId}). - Het e-mailadres van de klant (gebruikt om de gebruiker te identificeren; niet openbaar weergegeven).
- De weergavenaam van de klant (gebruikt als naam van de reactie-auteur).
Er worden geen orderhistorie-, betalings- of adresgegevens verzonden. De payload wordt server-side ondertekend; de browser van de klant ziet nooit een credential.
Inlog- en uitloglinks
Wanneer SSO is ingeschakeld, verwijzen de inlog- en uitloglinks van de reactiewidget naar /account/login en /account/logout, de standaard Shopify-klantenaccountroutes. Er hoeft niets geconfigureerd te worden. De links werken voor elke winkel met klantaccounts ingeschakeld.
Bestaande reacties importeren
Als u al reacties op uw Shopify-blogposts heeft en deze wilt behouden, importeer ze dan in FastComments voordat u de ingebouwde opmerkingen van Shopify uitschakelt.
De import moet worden uitgevoerd terwijl de ingebouwde opmerkingen van Shopify nog actief en zichtbaar zijn. Zodra u ze uitschakelt, kan FastComments ze niet meer lezen.
Hoe een import te starten
- Zorg ervoor dat de FastComments-app op uw winkel is geïnstalleerd.
- Laat de ingebouwde opmerkingen van Shopify voorlopig ingeschakeld.
- Open een supportticket en vertel ons welke blogs geïmporteerd moeten worden.
De import wordt in minder dan een dag uitgevoerd.
Zodra uw bestaande reacties in FastComments staan, voeg het FastComments-blok toe aan uw blogposttemplate en verwijder of schakel de ingebouwde opmerkingen van Shopify uit. Zie Reacties toevoegen aan blogposts en producten.
Als u bestaande reacties niet hoeft te behouden, kunt u deze pagina overslaan.
Aanpassing
Kleuren, lettertypen, moderatieregels, toegestane HTML en anonieme reacties zijn allemaal configureerbaar om bij de huisstijl van je winkel te passen.
Open de FastComments-app in je Shopify-beheer en klik op de tegel Aanpassen om het scherm voor het aanpassen van de widget te openen. Het gebruikt een eenmalige inloglink, dus je hebt geen aparte aanmelding nodig.
Voor de volledige lijst met aanpassingsopties, zie de Gids voor aanpassingen en configuratie.
Domeinfouten
Als u FastComments via de Shopify App Store hebt geïnstalleerd, wordt uw shopdomein automatisch toegevoegd aan de geautoriseerde domeinen van de tenant en zou u geen domeinfout moeten zien. Deze pagina is van toepassing als u de handmatige installatieweg hebt gevolgd, of als uw storefront wordt gehost op een aangepast domein dat niet bij Shopify was geregistreerd op het moment dat de app werd geïnstalleerd.
Mogelijk krijgt u een autorisatiefout die er als volgt uitziet:
Dit betekent dat FastComments het domein waarop de widget wordt geladen niet herkent als geautoriseerd voor uw tenant.
Om dit op te lossen, voeg het domein toe aan uw FastComments-account: Domeinen configureren.
Handmatige installatie (geavanceerd)
Als je de Shopify App Store-app niet kunt installeren, kun je FastComments nog steeds toevoegen door je thema te bewerken. Dit pad is nuttig wanneer je een FastComments-tenant die je al bezit wilt aansluiten, of wanneer je embedt op een Shopify-winkel waar de app geen optie is.
De installatie via de app is de ondersteunde methode voor de meeste winkels. Gebruik deze methode alleen als de app niet geschikt is.
Stap 1: Schakel de native reacties van Shopify uit
In je Shopify-beheer, ga naar Blogberichten > Blogs beheren, open elke blog en stel Comments are disabled in het rechterpaneel. Sla op.
Dit voorkomt dat de ingebouwde reacties van Shopify naast FastComments worden weergegeven.
Stap 2: Open het themasjabloon voor blogs
In je Shopify-beheer:
- Ga naar Online winkel > Thema's.
- Onder je huidige thema klik je op Acties > Code bewerken.
- In de bestandsbrowser aan de linkerkant, open Sections en klik op
main-article.liquid.
Dit is het sjabloon dat Shopify weergeeft voor een enkel blogartikel.
Stap 3: Plak de FastComments-snippet
Scroll ongeveer naar regel 100 van main-article.liquid, direct na de afsluitende </div> van de artikeltekst. Plak de volgende snippet:
Vervang "demo" door je eigen Tenant ID van fastcomments.com/auth/my-account/api-secret. Klik op Opslaan.
Stap 4: Autoriseer je winkeldomein
Open een blogbericht op je live winkel. Als je in plaats van de commentaarwidget een autorisatiefout ziet, moet FastComments weten dat je winkel is toegestaan om deze tenant te gebruiken. Zie Domeinfouten.
FastComments toevoegen aan andere pagina's
Dezelfde snippet werkt op elk Liquid-sjabloon, inclusief productpagina's, aangepaste pagina's en de startpagina. Plak het waar je wilt dat reacties verschijnen en pas urlId aan als je een stabiele identifier per pagina wilt (bijvoorbeeld, urlId: "{{ product.id }}" in een producttemplate).
Polls toevoegen aan uw Shopify-winkel
Zodra FastComments op je Shopify-winkel staat, kun je ook live peilingen uitvoeren direct in de reacties. Schakel Enable Polls in je widget‑aanpassingsinstellingen in en er verschijnt een peilingknop in de reactie‑werkbalk. Peilingen kunnen 2 tot 10 opties bevatten, resultaten worden live bijgewerkt voor iedereen op de pagina, en je kiest wie peilingen kan maken en of stemmen een login vereist. Er is verder niets te installeren op Shopify.
Probeer de Live Polls-demo of lees de Polls-documentatie om ze in te stellen.