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.
Voeg reacties toe aan blogposts en producten
De FastComments-blok is de hoofdreactie-widget. Voeg het toe aan blogpost-sjablonen, productsjablonen of elke andere pagina waar je een discussiedraad of een livechat wilt.
Blok toevoegen
- Open de Shopify-thema-editor (Online Store > Themes > Customize).
- Kies het sjabloon waar je reacties op wilt: Blog post, Product, of een ander pagina- of sectiesjabloon.
- Klik in de sectie waar je reacties wilt laten verschijnen op Add block.
- Kies onder Apps voor FastComments.
- Klik op Save.
Het blok verschijnt onmiddellijk. Er is geen Tenant ID om in te voeren; de tenant van je winkel wordt automatisch gekoppeld wanneer je de app installeert.
Instellingen
| Setting | What it does | Default |
|---|---|---|
| Tenant ID (optional) | Overschrijf welke FastComments-tenant het blok weergeeft. Laat leeg om de automatisch geconfigureerde tenant van de winkel te gebruiken. Vind een handmatig tenant ID op fastcomments.com/auth/my-account/api-secret. | (leeg) |
| SSO | Logt de bezoeker automatisch in als hun Shopify-klantaccount voordat ze reageren. Zie Automatisch inloggen van Shopify-klanten. | On |
| Commenting Style | Threaded voor geneste antwoorden 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 reactiedraad delen. | (automatisch gedetecteerd) |
Hoe de pagina-identificatie wordt gekozen
Elke reactiedraad heeft een sleutel op basis van een URL-ID. Het blok kiest er automatisch één:
- Blog post template:
shopify-article-{article.id}, which is stable across slug and title changes. - Product template:
shopify-product-{product.id}, which is stable across slug and title changes. - Other templates: the request path.
Als je Custom URL ID instelt, wordt die waarde in plaats daarvan gebruikt. Gebruik dezelfde Custom URL ID in meerdere blokken (bijvoorbeeld op een gelokaliseerde variant van een productpagina) om één reactiedraad te delen.
Threaded vs Streaming
Threaded is de standaard. Bezoekers reageren op elkaar, stemmen en moderatietools werken zoals verwacht. Het beste voor blogposts en productrecensies.
Streaming laat threading weg en toont nieuwe opmerkingen realtime zodra ze geplaatst worden, zoals een chatfeed. Het beste voor productlanceringen, live-evenementen en communitypagina's.
Meerdere blokken op dezelfde pagina
Het blok kan meer dan eens worden toegevoegd aan hetzelfde sjabloon. Bijvoorbeeld een Reviews Summary bovenaan een productpagina en een FastComments-blok onderaan. De blokken delen een URL-ID, dus de samenvatting weerspiegelt de opmerkingen hieronder.
Tips
- Het blok verbergt zichzelf in de thema-editor-voorbeeldweergave 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 fungeert het FastComments-blok tevens als je widget voor productrecensies. Combineer het met FastComments - Reviews Summary voor een sterrenbeoordelingssamenvatting bovenaan de pagina.
Voeg een badge met aantal reacties toe
De FastComments - Comment Count block toont een klein aantal reacties voor een enkele pagina. Gebruik het in blogpostlijsten, productkaarten of elk template dat naar een pagina met reacties linkt, zodat bezoekers kunnen zien hoe actief elk onderwerp is voordat ze doorklikken.
Add the block
- Open de Shopify thema-editor.
- Open het template waar je het aantal wilt laten verschijnen. Bijvoorbeeld de Blog template (de berichtlijst) of een productlijstsectie.
- Klik op Add block in de sectie die elk item weergeeft.
- Onder Apps, selecteer FastComments - Comment Count.
- Klik op Save.
Settings
| Setting | What it does | Default |
|---|---|---|
| Tenant ID (optional) | Overschrijf van welke FastComments-tenant het aantal wordt gelezen. Laat leeg om de automatisch geconfigureerde tenant van de winkel te gebruiken. | (blank) |
| Custom URL ID | Overschrijf de pagina-identifier waarnaar het aantal zoekt. Gebruik dit wanneer het aantal zich op een andere pagina bevindt dan het FastComments-blok dat het volgt. | (auto-detected) |
How the count matches the comment thread
De Comment Count block gebruikt dezelfde autodetectielogica als het FastComments-blok:
- Blog post template:
shopify-article-{article.id} - Product template:
shopify-product-{product.id} - Other templates: the request path
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 hetzelfde onderwerp verwijzen.
Tips
- 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 veroorzaakt geen extra netwerkverkeer.
- Eén Comment Count-blok per artikel of product in een lijst is het verwachte gebruik; het blok kan zo vaak worden toegevoegd als je nodig hebt.
Voeg een feed met recente reacties toe
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.
Voeg een feed met recente discussies toe
De FastComments - Recent Discussions-blok toont de pagina's in je winkel met de meest recente commentaaractiviteit, één item per pagina. Gebruik het wanneer je wilt dat bezoekers actieve threads ontdekken in plaats van individuele opmerkingen.
Voeg het blok toe
- Open de Shopify theme editor.
- Open de template waar je de feed wilt hebben, zoals een zijbalk, voettekst, blogindex of startpagina-sectie.
- Klik op Add block in de sectie die het moet bevatten.
- Onder Apps, selecteer FastComments - Recent Discussions.
- Klik op Save.
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 worden weergegeven. Bereik 1 tot 50. | 20 |
Recent Discussions vs Recent Comments
Beide blokken halen data uit dezelfde bron, maar tonen verschillende weergaven:
- Recent Comments: een platte lijst van de meest recente individuele reacties. Het meest geschikt voor "wat er net gezegd is".
- Recent Discussions: één item per pagina, gerangschikt op meest recente activiteit. Het meest geschikt voor "welke threads nu actief zijn".
Je kunt beide op dezelfde winkel gebruiken. Bijvoorbeeld Recent Comments in de blogzijbalk en Recent Discussions op de startpagina.
Voeg een lijst met populairste pagina's toe
De FastComments - Top Pages block toont de pagina's in je winkel met de meeste commentaaractiviteit in het algemeen. Gebruik het om je meest besproken berichten of producten naar voren te halen.
Add the block
- Open de Shopify-thema-editor.
- Open de template waar je de lijst wilt hebben, zoals een zijbalk, voettekst of blogindexsectie.
- Klik op Add block in de sectie die het moet bevatten.
- Onder Apps, selecteer FastComments - Top Pages.
- Klik op Save.
Settings
| Setting | What it does | Default |
|---|---|---|
| Tenant ID (optional) | Overschrijf welke FastComments-tenant de lijst uitleest. 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 meestal een tijdje bovenaan. Handig voor een "populaire berichten" zijbalk.
- Recent Discussions rangschikt op meest recente activiteit, waardoor de lijst snel wisselt. Handig voor een "wat er nu populair is" paneel.
Voeg een overzicht van beoordelingen toe
The FastComments - Reviews Summary block shows an aggregated star rating and review breakdown for a page. Pair it with the FastComments block on product templates for the standard reviews layout: summary up top, review form and reviews below.
Vereiste: stel Ratings & Reviews in
The Reviews Summary block displays the rating questions you configured for your store. Set those up first:
- Open the FastComments app in your Shopify admin.
- Click the Ratings & Reviews Helper tile (or open Ratings & Reviews Helper directly).
- Add the questions you want each reviewer to answer (overall star rating, "how was the fit", etc.).
Without questions configured, the summary block has nothing to aggregate.
Blok toevoegen
- Open the Shopify theme editor.
- Open the Product template (or the page template where you want the summary).
- Click Add block near the top of the page section, above where the FastComments block will be.
- Under Apps, select FastComments - Reviews Summary.
- Add a FastComments block lower on the same page if you haven't already, so visitors can leave reviews.
- Click Save.
Instellingen
| Setting | What it does | Default |
|---|---|---|
| Tenant ID (optional) | Override which FastComments tenant the summary reads from. Leave blank to use the store's automatically-configured tenant. | (leeg) |
| Custom URL ID | Override the page identifier the summary aggregates against. Use this when the summary lives on a different page from the FastComments block it reflects. | (automatisch gedetecteerd) |
Hoe de samenvatting overeenkomt met de reviews
The Reviews Summary block uses the same auto-detection logic as the FastComments block:
- Product template:
shopify-product-{product.id} - Blog post template:
shopify-article-{article.id} - Other templates: the request path
For a normal product page, the summary and the comment thread share a URL ID automatically, with no configuration needed.
Tips
- The summary is read-only. To collect reviews, you need a FastComments block on the same page.
- If you change rating questions in Ratings & Reviews Helper after collecting reviews, the summary recalculates against the new question set.
Automatisch inloggen voor Shopify-klanten
De FastComments-blok ondersteunt single sign-on, zodat je Shopify-klanten als zichzelf kunnen reageren zonder een apart FastComments-account te maken.
Hoe het werkt
When a visitor who is logged into your store opens a page with the FastComments block:
- The block detects the Shopify
customerobject. - It sends the customer's name and email to FastComments through a signed app proxy request.
- FastComments creates or matches a user keyed by
shopify-{customerId}, so the same customer always maps to the same FastComments user across sessions and re-installs. - The visitor's name shows up on their comments. They are not prompted to log in again.
Als de bezoeker niet is ingelogd in de winkel, valt het blok terug op anonieme reacties (of de FastComments-aanmeldingsflow, 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 thema-editor van Shopify.
- Open de template die het blok bevat en klik op het blok om het te selecteren.
- Haal het vinkje weg bij SSO.
- Klik op Opslaan.
Schakel SSO uit als je wilt dat reageerders een aparte identiteit kiezen voor het gesprek. Bijvoorbeeld een interne communitypagina waar medewerkers onder een andere weergavenaam reageren.
Wat FastComments ontvangt
The SSO payload sent for each customer contains:
- Een gebruikers-ID afgeleid van de 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 auteur bij opmerkingen).
Er worden geen bestelgeschiedenis-, betalings- of adresgegevens verzonden. De payload wordt server-side ondertekend; de browser van de klant ziet nooit de inloggegevens.
Aanmeld- en afmeldlinks
When SSO is on, the comment widget's sign-in and sign-out links point at /account/login and /account/logout, the standard Shopify customer account routes. There is nothing to configure. The links work for any store with customer accounts enabled.
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).