Aanpassingen & Configuratie

Het kan u opvallen dat de commentaar-widget kan worden gebruikt met een Tenant ID van "demo", bijvoorbeeld:

Demo Tenant ID

Copy Run

1

2<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>

3<div id="fastcomments-widget"></div>

4<script>

5window.fcConfigs = [{

6 "tenantId": "demo"

7}];

8</script>

9

Dit is alleen bedoeld om de commentaar-widget uit te proberen en mee te spelen. In productie geeft u uw Tenant ID mee, zoals hieronder:

Defining Your Tenant ID

Copy Run

1

2<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>

3<div id="fastcomments-widget"></div>

4<script>

5window.fcConfigs = [{

6 "tenantId": "aKa2Z4Q="

7}];

8</script>

9

Uw Tenant ID vindt u al toegepast in het codefragment van de commentaar-widget in uw account.

U kunt uw Tenant ID ook vinden en uw API-sleutels beheren op de pagina met API-referenties.

Vanaf dit punt zullen, als u bent ingelogd bij FastComments, de codevoorbeelden uw echte Tenant ID gebruiken (als u bent ingelogd op https://fastcomments.com).

Wanneer een commentaarthread wordt weergegeven of een commentaar wordt geplaatst, moet FastComments weten bij welke pagina, artikel of product die commentaren horen.

Hiervoor gebruiken we iets dat we de “URL ID” noemen. Het is ofwel een identificatie, zoals een string of een getal, of een URL.

Standaard, als je geen urlId opgeeft, wordt dit de pagina‑URL. We nemen de huidige pagina‑URL en maken deze schoon om gemeenschappelijke marketing‑parameters of tracking‑identifiers te verwijderen.

In het geval van integraties van derden, zoals WordPress, zal onze plug‑in meestal de identifier gebruiken die de huidige bekeken informatie vertegenwoordigt als de URL ID, bijvoorbeeld de artikel‑/pagina‑id.

Definiëren van een aangepaste URL-ID

Copy Run

1

2<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>

3<div id="fastcomments-widget"></div>

4<script>

5window.fcConfigs = [{

6 "tenantId": "demo",

7 "urlId": "https://example.com/page"

8}];

9</script>

10

Een ding dat we vaak in dit document zullen verwijzen is de Widget Customization UI.

Deze UI kan worden gebruikt om veel wijzigingen aan de commentaarwidget aan te brengen zonder code te gebruiken.

Wanneer we een aanpassingsregel maken, willen we die vaak toepassen op alle pagina's van onze site. In sommige gevallen willen we echter de commentaarwidget aanpassen op een specifieke pagina, bijvoorbeeld om aangepaste styling toe te passen, of om commentaren voor die specifieke pagina anoniem te maken. Je zou bijvoorbeeld ook live‑commentaren direct op sommige pagina's kunnen laten verschijnen, terwijl je ze op andere onder notificatie‑knoppen verbergt.

Dit is allemaal mogelijk via het URL ID‑invoerveld op deze pagina, dat er als volgt uitziet:

URL-ID-invoer op de widget-aanpassingspagina

De waarde in dit veld moet overeenkomen met de urlId‑parameter die aan de commentaarwidget wordt doorgegeven. Als je wilt dat je aanpassingsregel urlId‑agnostisch is, laat dit veld dan leeg of voer * in.

Vanaf 2023 accepteert het URL ID‑veld in widget‑aanpassing nu ook patronen! Bijvoorbeeld, je kunt */blog/* gebruiken om styling specifiek voor je blog toe te voegen en */store/* om styling specifiek voor je winkel toe te passen, allemaal terwijl je hetzelfde domein gebruikt.

Valkuilen

1. Als je pagina hash‑parameters heeft (zoals example.com#page-1) – dit wordt standaard onderdeel van de URL ID.
2. Tijdens migraties, bijvoorbeeld van WordPress naar Gatsby, moet je mogelijk de URL ID‑commentaarwaarden migreren na de initiële migratie. Neem hiervoor contact met ons op.

FastComments is ontworpen om aangepast te kunnen worden. De commentaarwidget zelf draait binnen een iframe om veiligheidsredenen, dus om aangepaste styling toe te passen moet je een van twee benaderingen volgen.

De eerste, de gemakkelijkste benadering, en door ons geprefereerd, is om de widget-aanpassingspagina te gebruiken.

Op de widget-aanpassingspagina, zie de sectie "Geavanceerde opties weergeven", waaronder een gebied staat gelabeld "Aangepaste CSS":

Aangepast CSS invoerveld

Deze benadering heeft enkele voordelen:

1. De ingevoerde CSS wordt geminimaliseerd voordat deze naar de gebruiker wordt verzonden, en de opmaak blijft consistent in de bewerkings-UI.
2. Je krijgt alle voordelen van de widget-aanpassings-UI, bijvoorbeeld het eenvoudig aanpassen van de commentaarwidget verschillend voor verschillende sites.
3. Wanneer we wijzigingen aan de commentaarwidget aanbrengen, wordt jouw aangepaste styling getest als onderdeel van ons releaseproces.

De tweede benadering is om de customCSS-parameter op te geven in de widgetconfiguratie, als volgt:

Doorgeven van aangepaste CSS

Copy Run

1

2<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>

3<div id="fastcomments-widget"></div>

4<script>

5window.fcConfigs = [{

6 "tenantId": "demo",

7 "customCSS": "button { background: red; }"

8}];

9</script>

10

Dit heeft echter beperkingen:

1. Er is een limiet aan hoeveel aangepaste CSS kan worden doorgegeven voordat onze servers het verzoek afwijzen, vanwege de grootte van de headers.
2. Je moet de aangepaste CSS beheren in je infrastructuur en buildsysteem. Dit kan zelfs een voordeel zijn in plaats van een nadeel.
3. Er is een extra overhead van het verzenden van de aangepaste CSS over het netwerk twee keer in dit geval, omdat het eerst naar onze servers moet worden gestuurd en vervolgens terug in de iframe-inhoud. Voor de meeste payloadgroottes is dit echter niet merkbaar.
4. Een veelvoorkomende optimalisatie is het minificeren van de CSS om de grootte over het netwerk te verkleinen, maar met deze benadering moet je dat zelf afhandelen.
5. Jouw aangepaste CSS wordt niet getest wanneer we wijzigingen aanbrengen.

Externe CSS-bestanden

Je kunt de widget laten een extern bestand ophalen met @import!

Het wordt aanbevolen om de @import in een aanpassingsregel te plaatsen. Op deze manier, als we ooit een wijziging aan de commentaarwidget moeten aanbrengen, kunnen we onze automatiseringstools gebruiken om je configuratie te verifiëren. Dus bijvoorbeeld, je zou een aanpassingsregel maken in de Widget Customization UI, klik op Advanced, en voer in Custom CSS:

@import url(https://example.com/styles.css);

In Code - Niet Aanbevolen

Je kunt ook een extern CSS-bestand laden via de customCSS-eigenschap:

Extern CSS-bestand

Copy Run

1

2<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>

3<div id="fastcomments-widget"></div>

4<script>

5window.fcConfigs = [{

6 "tenantId": "demo",

7 "customCSS": "@import url(https://example.com/styles.css);"

8}];

9</script>

10

Houd er echter rekening mee dat je CSS niet door ons kan worden getest als je dit doet.

Styling van gebruikersprofiel-modals

Gebruikersprofiel-modals kunnen ook worden gestyled met aangepaste CSS. Om er echter voor te zorgen dat aangepaste styling wordt toegepast op gebruikersprofielen, moeten alle CSS-selectors worden voorafgegaan door .user-profile. Zonder dit voorvoegsel wordt aangepaste styling genegeerd voor gebruikersprofiel-modals.

Bijvoorbeeld:

Gebruikersprofiel CSS

Copy Run

1

2<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>

3<div id="fastcomments-widget"></div>

4<script>

5window.fcConfigs = [{

6 "tenantId": "demo",

7 "customCSS": ".user-profile .profile-name { color: blue; }"

8}];

9</script>

10

Achterwaartse compatibiliteit

Bij FastComments weten we dat onze klanten de commentaarwidget aanpassen. Dat is zo ontworpen - het laatste wat we willen is dat ons product ontwerp-inconsistenties in jouw product veroorzaakt.

Aangezien dit een belangrijk onderdeel van ons product is, hebben we een build-pijplijn die ons in staat stelt om wijzigingen aan de commentaarwidget per klant te beoordelen bij elke release.

Als we kleine problemen vinden, zullen we je account bijwerken om ervoor te zorgen dat onze release soepel verloopt. Als we grote brekende wijzigingen zien, stelt dit ons in staat de release te stoppen.

Voor klanten met Pro- of Enterprise-accounts is white-labeling toegestaan. Neem gewoon contact met ons op en we helpen u graag.

Als u alleen ons logo uit de commentaarwidget wilt verwijderen, wordt dit automatisch ingeschakeld op de Flex- en Pro-plannen.

Deze plannen bieden ook dezelfde functionaliteit voor e-mails die vanuit ons platform worden verzonden.

Voor sites die het wisselen van de donkere modus na het initiële laden van de pagina toestaan, is dit iets ingewikkelder.

Allereerst bevatten alle huidige versies van de Comment-widgetbibliotheek (React, Vue) voorbeelden van het wisselen van de donkere modus in hun respectieve repositories.

Voor de VanillaJS-widget moeten we wat meer werk doen. Ten eerste retourneert de FastCommentsUI een object met de functies "destroy" en "update".

We kunnen eenvoudig de update-functie aanroepen telkens wanneer we de configuratie van de commentaarwidget willen bijwerken, zoals hieronder. Hier is een volledig werkend voorbeeld van het wisselen van de donkere modus met de VanillaJS-widget.

Volledig voorbeeld: Donkere modus wisselen

Copy Run

1

2<script src="https://fastcomments.com/js/embed-v2.min.js"></script>

3<button id="toggle-dark-mode">Toggle Dark Mode</button>

4<div id="fastcomments-widget"></div>

5<script>

6 (function() {

7 const button = document.getElementById('toggle-dark-mode');

8 const config = {

9 tenantId: 'demo',

10 hasDarkBackground: false

11 };

12 const instance = window.FastCommentsUI(document.getElementById('fastcomments-widget'), config);

13 button.addEventListener('click', function() {

14 config.hasDarkBackground = !config.hasDarkBackground;

15 if (config.hasDarkBackground) {

16 document.body.classList.add('dark');

17 } else {

18 document.body.classList.remove('dark');

19 }

20 instance.update(config);

21 });

22 })();

23</script>

24<style>

25 body.dark {

26 background: #000;

27 color: #fff;

28 }

29</style>

30

Met FastComments kan alle tekst in de commentaarwidget worden aangepast.

U kunt een enkel stuk tekst overschrijven, zoals de verzendknop, of alle tekst in de volledige commentaarwidget.

Standaard wordt de tekst in de commentaarwidget vertaald op basis van de locale van de gebruiker. We kunnen echter de tekst overschrijven, als we er zeker van zijn dat onze gebruikersbasis dezelfde locale/taal gebruikt, bijvoorbeeld:

Aangepaste tekst

Copy Run

1

2<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>

3<div id="fastcomments-widget"></div>

4<script>

5window.fcConfigs = [{

6 "tenantId": "demo",

7 "translations": {

8 "SUBMIT_REPLY": "Reply"

9 }

10}];

11</script>

12

Alle aanpasbare vertalingen zijn te vinden hier onder het tabblad "geavanceerde opties".

Er is echter een eenvoudigere manier, via de UI voor widgetaanpassing. Daar kunnen we eenvoudig de tekst vinden die wordt weergegeven in de commentaarwidget in de EN_US locale, en een vervanging opgeven.

Aangepaste tekst

Alle vertaaloverschrijvingen hebben momenteel invloed op alle locales.

Dit betreft de eigen tekst van de widget. Om de opmerkingen die uw bezoekers schrijven te vertalen, zie Comment Translation.

Wanneer een gebruiker voor het eerst een reactie plaatst met FastComments, proberen we hun avatar op te halen van https://gravatar.com/.

Als we echter geen avatar vinden, of de gebruiker er nooit een instelt in zijn account, tonen we een statische standaardavatarafbeelding.

Om je eigen statische avatarafbeelding op te geven, kun je de defaultAvatarSrc instelling gebruiken.

Overschrijf de standaardavatar

Copy Run

1

2<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>

3<div id="fastcomments-widget"></div>

4<script>

5window.fcConfigs = [{

6 "tenantId": "demo",

7 "defaultAvatarSrc": "https://example.com/some-image.png"

8}];

9</script>

10

Dit kan ook zonder code. Op de widget‑aanpassingspagina, zie de sectie "Standaardavatar".

Aanpassen van de standaardavatar

Let op dat het definiëren van de avatar voor een specifieke gebruiker, bijvoorbeeld met SSO, in een eigen sectie wordt behandeld.

Avatars kunnen volledig worden verwijderd uit de commentaarwidget, zelfs als gebruikers hun eigen avatar hebben gedefinieerd.

Avatars verbergen

Copy Run

1

2<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>

3<div id="fastcomments-widget"></div>

4<script>

5window.fcConfigs = [{

6 "tenantId": "demo",

7 "hideAvatars": true

8}];

9</script>

10

Dit kan worden aangepast zonder code, op de widget‑aanpassingspagina:

Avatars verbergen

Voor grotere projecten met aangepaste styling kan het wenselijk zijn om met een schone lei te beginnen en de standaardstyling helemaal niet te gebruiken.

Alle standaardstyling kan worden verwijderd door de noStyles-parameter op true te zetten, als volgt:

Uitschakelen van alle standaardstijlen

Copy Run

1

2<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>

3<div id="fastcomments-widget"></div>

4<script>

5window.fcConfigs = [{

6 "tenantId": "demo",

7 "noStyles": true

8}];

9</script>

10

Dit kan zonder code worden aangepast op de widget-aanpassingspagina, onder Geavanceerde opties:

Uitschakelen van alle standaardstijlen

Standaard worden antwoorden op top-level reacties weergegeven.

Dit kan zo worden geconfigureerd dat de gebruiker op "Show Replies" moet klikken op de top-level reacties om de antwoorden te zien.

Antwoorden op top-level reacties inklappen

Copy Run

1

2<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>

3<div id="fastcomments-widget"></div>

4<script>

5window.fcConfigs = [{

6 "tenantId": "demo",

7 "collapseReplies": true

8}];

9</script>

10

Dit kan zonder code worden aangepast op de widget-aanpassingspagina:

Antwoorden inklappen

Deze instelling heeft geen invloed op het aantal top-level reacties dat aanvankelijk wordt geladen. Als je één top-level reactie hebt, en 29 antwoorden, zul je met deze instelling:

• De top-level reactie zien.
• De "Show Replies" (29) onder deze reactie zien.

Als je alle top-level reacties wilt weergeven in combinatie met deze optie, stel dan startpagina op -1 in.

Standaard worden de opmaakfunctionaliteiten in FastComments gerealiseerd door zichtbare anker‑tags zoals <b></b> rond je tekst toe te voegen. Door op de werkbalk te klikken of sneltoetsen te gebruiken gebeurt dit automatisch. Sommige gemeenschappen willen echter de opmaak gebruiken zonder anker‑tags. Dit wordt het inschakelen van de WYSIWYG (what you see is what you get) editor genoemd. Deze editor ziet er precies hetzelfde uit als de standaardeditor, behalve dat er extra code wordt geladen die gebruikers in staat stelt tekst vet, onderstreept, enz. te maken zonder zichtbare anker‑tags.

Enabling WYSIWYG Editing

Copy Run

1

2<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>

3<div id="fastcomments-widget"></div>

4<script>

5window.fcConfigs = [{

6 "tenantId": "demo",

7 "enableWYSIWYG": true

8}];

9</script>

10

Dit kan ook zonder code worden gedaan. Op de widget‑aanpassingspagina vind je de optie "Enable Advanced Formatting".

WYSIWYG inschakelen

Standaard toont FastComments een werkbalk bij het schrijven van een reactie om snelkoppelingen te bieden voor het opmaken van tekst en het uploaden afbeeldingen.

Deze werkbalk kan worden uitgeschakeld in code of via de Aanpassings-UI.

De werkbalk uitschakelen

Copy Run

1

2<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>

3<div id="fastcomments-widget"></div>

4<script>

5window.fcConfigs = [{

6 "tenantId": "demo",

7 "disableToolbar": true

8}];

9</script>

10

Dit kan ook zonder code worden gedaan. Op de widget-aanpassingspagina, zie de optie "Disable The Reply Toolbar".

De werkbalk uitschakelen

Standaard staat FastComments gebruikers toe om andere gebruikers te blokkeren. Het blokkeren van een gebruiker zorgt ervoor dat hun opmerkingen worden gemaskeerd, voorkomt meldingen tussen de gebruikers, enzovoort.

Het kan wenselijk zijn om deze functionaliteit uit te schakelen. Dit kan als volgt:

Blokkering uitschakelen

Copy Run

1

2<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>

3<div id="fastcomments-widget"></div>

4<script>

5window.fcConfigs = [{

6 "tenantId": "demo",

7 "disableBlocking": true

8}];

9</script>

10

Dit kan ook zonder code worden gedaan, wat ook een juiste server‑side validatie mogelijk maakt, via de Widget‑aanpassings‑UI:

Blokkering uitschakelen

Standaard worden gelokaliseerde relatieve datums gebruikt. Bijvoorbeeld, naast een recent geplaatste reactie kun je "11 minuten geleden" zien.

Het kan nodig of gewenst zijn om absolute datums te gebruiken; in dat geval stel je deze parameter in op true.

Gebruik absolute datums

Copy Run

1

2<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>

3<div id="fastcomments-widget"></div>

4<script>

5window.fcConfigs = [{

6 "tenantId": "demo",

7 "absoluteDates": true

8}];

9</script>

10

Dit kan zonder code worden aangepast op de widget‑aanpassingspagina, onder Geavanceerde opties:

Gebruik absolute datums

Standaard worden gelokaliseerde relatieve datums gebruikt. Bijvoorbeeld, naast een recent geplaatst commentaar kun je "11 minuten geleden" zien.

Het kan nodig of gewenst zijn om dit relatieve datumformaat te behouden, maar ook de volledige datum ernaast te tonen; in dat geval stel je deze parameter in op true.

Use Both Absolute and Relative Dates

Copy Run

1

2<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>

3<div id="fastcomments-widget"></div>

4<script>

5window.fcConfigs = [{

6 "tenantId": "demo",

7 "absoluteAndRelativeDates": true

8}];

9</script>

10

Dit kan zonder code worden aangepast op de widget-aanpassingspagina, onder Geavanceerde opties. Je moet eerst Absoluut datums inschakelen om deze optie in de UI te zien.

Gebruik zowel absolute als relatieve datums

Enige tekst, zoals een header of bericht, kan worden weergegeven onder het aantal reacties maar boven de tekst van de loginstatus.

We noemen dit de header, en standaard is deze verborgen.

Specifying Header HTML

Copy Run

1

2<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>

3<div id="fastcomments-widget"></div>

4<script>

5window.fcConfigs = [{

6 "tenantId": "demo",

7 "headerHTML": "<h1>Leave a Comment!</h1>"

8}];

9</script>

10

Dit kan worden aangepast zonder code, op de widget‑aanpassingspagina, onder Geavanceerde opties:

Header-HTML specificeren

Standaard zal FastComments links weergeven zoals dit: https://exmaple.com - waarbij de link-URL een klikbare HTML-anker-tag wordt.

Sommige sites willen dit mogelijk uitschakelen, bijvoorbeeld om oplichters te ontmoedigen. We bieden dit door de Comment HTML Rendering Option in te stellen op Links as Text.

Dit kan zonder code worden aangepast, op de widget-aanpassingspagina, voor een heel domein of een pagina:

Render Links als Tekst

Standaard rendert FastComments zowel het reactie‑invoerveld als de reactiedraad tegelijk. Om wat verticale ruimte te besparen, verbergt het ook alle andere verplichte velden totdat er met de widget wordt gecommuniceerd.

De reactiewidget kan echter verborgen worden achter een knop, bijvoorbeeld:

Klik om reacties te tonen

De knop gebruikt verschillende vertaalde teksten afhankelijk van of de reacties momenteel worden getoond of niet. Als de reacties verborgen zijn, wordt translations.SHOW_COMMENTS_BUTTON_TEXT gebruikt. Als de reacties worden getoond, wordt translations.HIDE_COMMENTS_BUTTON_TEXT gebruikt. De vertalingen kunnen de tekst [count] bevatten die wordt vervangen door het gelokaliseerde aantal.

Klik om reacties te tonen of te verbergen

Copy Run

1

2<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>

3<div id="fastcomments-widget"></div>

4<script>

5window.fcConfigs = [{

6 "tenantId": "demo",

7 "useShowCommentsToggle": true

8}];

9</script>

10

Dit is bedoeld om de hideCommentsUnderCountTextFormat configuratie te vervangen.

Het aantal wordt live bijgewerkt met de reactiedraad. De knop wordt niet getoond als er geen reacties zijn.

Dit kan worden ingeschakeld zonder code door een aanpassingsregel te maken en "Klik om reacties te tonen" in te schakelen:

Schakel Klik om reacties te tonen in

Het aantal opmerkingen dat bovenaan de commentaarwidget wordt weergegeven, kan worden aangepast.

Dit kan worden vervangen door een willekeurige tekenreeks, en de waarde [count] wordt vervangen door de tellerwaarde, gelokaliseerd voor de gebruiker.

De tekst van het aantal opmerkingen aanpassen

Copy Run

1

2<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>

3<div id="fastcomments-widget"></div>

4<script>

5window.fcConfigs = [{

6 "tenantId": "demo",

7 "commentCountFormat": "There are [count] comments."

8}];

9</script>

10

Dit kan worden aangepast zonder code, op de widget-aanpassingspagina:

De tekst van het aantal opmerkingen aanpassen

Wanneer gebruikers hashtags invoeren, in de vorm van #someexampletag, zal FastComments automatisch die HashTag aanmaken en deze in hun reactie markeren.

In sommige gevallen is het wenselijk om deze functie uit te schakelen, of om te bepalen welke hashtags via de API kunnen worden gebruikt.

Doe dit door simpelweg Disable Automatic #hashtag Creation in te schakelen via de Widget Customization UI.

Automatisch HashTag-aanmaak uitschakelen

Standaard toont FastComments een meldingsbel in de rechterbovenhoek van het reactiegebied.

Deze bel wordt rood en toont een telling van het aantal meldingen dat de gebruiker heeft. Enkele voorbeeldmeldingen zijn:

• Gebruiker heeft op je gereageerd.
• Gebruiker heeft gereageerd in een thread waarin je hebt gereageerd.
• Gebruiker heeft je reactie upvoted.
• Gebruiker heeft gereageerd op een pagina waarop je geabonneerd bent.

De meldingsbel biedt ook een mechanisme om je op een volledige pagina te abonneren.

We kunnen de meldingsbel echter volledig uitschakelen:

Disable Notification Bell

Copy Run

1

2<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>

3<div id="fastcomments-widget"></div>

4<script>

5window.fcConfigs = [{

6 "tenantId": "demo",

7 "disableNotificationBell": true

8}];

9</script>

10

Dit kan ook zonder code worden gedaan. Op de widget‑aanpassingspagina, zie de "Disable Notification Bell" sectie.

Meldingsbel uitschakelen

Standaard toont FastComments het profiel van de gebruiker wanneer je op de avatar klikt.

We kunnen deze functionaliteit echter uitschakelen:

Profielen uitschakelen

Copy Run

1

2<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>

3<div id="fastcomments-widget"></div>

4<script>

5window.fcConfigs = [{

6 "tenantId": "demo",

7 "disableProfiles": true

8}];

9</script>

10

Dit kan ook zonder code worden gedaan. Op de widget‑aanpassingspagina, zie de sectie "Profielen uitschakelen".

Profielen uitschakelen

Standaard toont FastComments een “Profielreacties” tabblad op gebruikersprofielen, waardoor bezoekers reacties kunnen achterlaten op iemands profiel.

We kunnen dit tabblad echter uitschakelen:

Profielreacties uitschakelen

Copy Run

1

2<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>

3<div id="fastcomments-widget"></div>

4<script>

5window.fcConfigs = [{

6 "tenantId": "demo",

7 "disableProfileComments": true

8}];

9</script>

10

Dit kan ook zonder code worden gedaan. Op de widget‑aanpassingspagina, zie de sectie “Profielreacties uitschakelen”.

Profielreacties uitschakelen

Standaard toont FastComments een "Direct Messages" tabblad op gebruikersprofielen, waardoor bezoekers directe berichten naar een gebruiker kunnen sturen.

We kunnen dit tabblad echter uitschakelen:

Disable Profile Direct Messages

Copy Run

1

2<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>

3<div id="fastcomments-widget"></div>

4<script>

5window.fcConfigs = [{

6 "tenantId": "demo",

7 "disableProfileDirectMessages": true

8}];

9</script>

10

Dit kan ook zonder code worden gedaan. Op de widget‑aanpassingspagina, zie de sectie "Direct Berichten Uitschakelen".

Profiel Direct Berichten Uitschakelen

Standaard toont FastComments een succesbericht na het plaatsen van een reactie. Dit kan als volgt worden uitgeschakeld:

Schakel succesbericht uit

Copy Run

1

2<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>

3<div id="fastcomments-widget"></div>

4<script>

5window.fcConfigs = [{

6 "tenantId": "demo",

7 "disableSuccessMessage": true

8}];

9</script>

10

Dit kan ook zonder code worden gedaan. Op de widget‑aanpassingspagina:

Schakel succesbericht uit

Standaard stelt de FastComments-reactie-widget een gif rating in op pg.

Beschikbare opties zijn g, pg, pg-13 en r.

Dit kan worden ingesteld in de code of via de UI. In de code kunnen we dit als volgt doen:

Set Gif Rating

Copy Run

1

2<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>

3<div id="fastcomments-widget"></div>

4<script>

5window.fcConfigs = [{

6 "tenantId": "demo",

7 "gifRating": "pg-13"

8}];

9</script>

10

In de UI vind je dit onder Gif Picker Rating zolang Disable Image Uploads? niet is aangevinkt.

Instellen van de Gif Rating

Standaard heeft de FastComments-reactiewidget de moderatie van afbeeldingsinhoud ingesteld op off.

Beschikbare opties zijn off, low, medium en high.

In de UI voor widgetaanpassing vind je dit onder Image Content Moderation Level zolang Disable Image Uploads? niet is aangevinkt.

Instellen van het Image Content Moderation Level

Standaard zal FastComments stemopties weergeven als omhoog- en omlaag-pijlen, waardoor gebruikers een reactie kunnen up- of downvoten.

Het is echter mogelijk om de stijl van de stemwerkbalk te wijzigen. De huidige opties zijn de standaard Omhoog/Omlaag-knoppen, of het gebruik van een hartstijl stemmechanisme.

We gebruiken de voteStyle-vlag als volgt:

Schakel Hartknop in

Copy Run

1

2<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>

3<div id="fastcomments-widget"></div>

4<script>

5window.fcConfigs = [{

6 "tenantId": "demo",

7 "voteStyle": 1

8}];

9</script>

10

We raden sterk aan dit zonder code te doen, omdat dit ook server-side validaties inschakelt. Op de widget-aanpassingspagina, zie de sectie "Stemstijl".

Wijzig stemstijl

Stemmen kan ook worden uitgeschakeld, zie Disable Voting boven de stijlopties.

Standaard staat FastComments gebruikers toe hun opmerkingen te verwijderen.

Het is echter mogelijk dit te voorkomen.

Op de widget‑aanpassingspagina, zie de "Verwijderen uitschakelen" optie.

Verwijderen van opmerkingen uitschakelen

• Dit heeft alleen invloed op gewone commentatoren en niet op moderators of beheerders, die nog steeds kunnen verwijderen.
• Dit zal ook van invloed zijn op API‑integraties wanneer contextUserId wordt doorgegeven.

Standaard staat FastComments gebruikers toe hun reacties te bewerken.

Het is echter mogelijk dit te voorkomen.

Op de widget‑aanpassingspagina, zie de optie "Bewerken uitschakelen".

Bewerken van reacties uitschakelen

• Dit heeft alleen invloed op gewone reageerders en niet op moderators of beheerders, die nog steeds kunnen bewerken.
• Dit zal ook invloed hebben op API‑integraties wanneer contextUserId wordt doorgegeven.

Standaard is de paginagrootte van FastComments 30. Dit omvat antwoorden in threads.

De paginagrootte kan worden aangepast in de Widget Configuration UI in verschillende groottes variërend van 10 tot 200.

Houd er rekening mee dat het wijzigen van de paginagrootte het opnieuw berekenen van alle commentaarthreads in uw account vereist. Dit kan enkele minuten duren.

Dit kan niet worden geconfigureerd in de client-side widget, omdat pagina's server-side worden berekend.

Voorbeeldconfiguratie wordt hieronder getoond:

Aangepaste paginagroottes

Paginagroottes kunnen globaal, per domein of per pagina worden aangepast door verschillende aanpassingsregels te maken.

Dit zal alle clients, integraties en frameworks beïnvloeden die u mogelijk gebruikt om opmerkingen weer te geven via ons platform.

Standaard toont FastComments de naam van de gebruiker zoals deze is ingevoerd, of zoals deze via SSO aan ons is doorgegeven.

Het kan echter wenselijk zijn om de naam van de gebruiker te maskeren of op een andere manier weer te geven. Bijvoorbeeld, als de naam van de gebruiker Allen Rex is, wil je misschien alleen "Allen R." tonen.

Dit kan zonder code worden gedaan in de Widget Customisatie UI, onder de instelling genaamd Commenter Name Format:

Naamindeling wijzigen

De beschikbare indelingen zijn:

• Capitalize (toon voorbeeldgebruiker als Example User)
• Last Initial (toon Example User als Example U.)
• All Initials (toon Example User als E. U.)
• Show "Anonymous"

Het effect van het wijzigen hiervan is onmiddellijk. Gebruikers zullen nog steeds hun volledige gebruikersnaam bovenaan het reactiegebied zien, voor zichzelf, maar hun reacties zullen de aangepaste gebruikersnaam tonen.

Gebruikersnamen worden server-side gemaskeerd om gebruikers te beschermen.

Standaard staat FastComments afbeeldinguploads toe. Dit kan worden uitgeschakeld door de noImageUploads‑vlag op true te zetten.

Uitschakelen van afbeeldinguploads

Copy Run

1

2<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>

3<div id="fastcomments-widget"></div>

4<script>

5window.fcConfigs = [{

6 "tenantId": "demo",

7 "noImageUploads": true

8}];

9</script>

10

Dit kan worden aangepast zonder code, op de widget‑aanpassingspagina:

Uitschakelen van afbeeldinguploads

Standaard staat FastComments geen iframes toe in reacties. Wanneer je media‑embeds inschakelt, kunnen reageerders de embedcode (de <iframe>‑snippet) van vertrouwde providers zoals YouTube, Vimeo, SoundCloud en Spotify plakken, en deze wordt inline weergegeven in de reactie.

Voor de veiligheid is dit geen client‑side widget‑configuratievlag. Het is een server‑side instelling, gevalideerd wanneer elke reactie wordt opgeslagen, zodat deze niet vanaf de pagina kan worden ingeschakeld. Alleen iframes die verwijzen naar een ingebouwde lijst van vertrouwde providers zijn toegestaan. Elke andere iframe wordt verwijderd.

Dit gebeurt zonder code, op de widget‑aanpassingspagina:

Media-embeds toestaan

Eigen providers toevoegen

Als je embeds van een provider wilt toestaan die niet op de ingebouwde vertrouwde lijst staat, voeg dan de hostnaam toe in het veld "Additional Embed Domains" op dezelfde pagina. Deze hostnamen zijn toegestaan naast de ingebouwde providers. De overeenkomst is exact, dus voeg de volledige hostnaam toe (bijvoorbeeld player.example.com). Alles wat je niet vermeldt, blijft geblokkeerd.

Zowel het eenvoudige reactieveld als de WYSIWYG‑editor ondersteunen het plakken van een embed. In de WYSIWYG‑editor wordt de embed ingevoegd als een verwijderbaar blok.

Standaard wordt er geen zoekvak weergegeven in de commentaarwidget.

We kunnen dit echter inschakelen door de enableSearch-vlag op true te zetten:

Zoeken inschakelen

Copy Run

1

2<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>

3<div id="fastcomments-widget"></div>

4<script>

5window.fcConfigs = [{

6 "tenantId": "demo",

7 "enableSearch": true

8}];

9</script>

10

Dit kan ook zonder code. Op de widget-aanpassingspagina, zie de "Enable Search Box" optie.

Zoekvak inschakelen

We kunnen spoiler-ondersteuning inschakelen door de vlag enableSpoilers op true te zetten:

Spoilers inschakelen

Copy Run

1

2<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>

3<div id="fastcomments-widget"></div>

4<script>

5window.fcConfigs = [{

6 "tenantId": "demo",

7 "enableSpoilers": true

8}];

9</script>

10

Dit kan ook zonder code. Zie op de widget-aanpassingspagina de optie "Enable Spoilers".

Enable Spoilers

Wanneer tekst is gemarkeerd en de nu zichtbare SPOILER-knop wordt aangeklikt, wordt de tekst gemaskeerd totdat de gebruiker er met de muis overheen beweegt. Voor de donkere modus doen we hetzelfde, met andere kleuren die beter passen bij de donkere modus.

Dit is ook compatibel met de WYSIWYG-editor.

Standaard houdt FastComments niet bij wie elk commentaar heeft bekeken en biedt geen statistieken hierover.

We kunnen deze functie echter inschakelen, waarna het systeem begint bij te houden wanneer elke gebruiker naar een commentaar scrolt.

Wanneer dit gebeurt, wordt een teller naast een oog‑icoon dat bij elk commentaar wordt weergegeven, verhoogd. De teller wordt live bijgewerkt en afgekort volgens de locale van de gebruiker.

We kunnen dit inschakelen door de enableViewCounts‑vlag op true te zetten:

Enabling Comment View Counts

Copy Run

1

2<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>

3<div id="fastcomments-widget"></div>

4<script>

5window.fcConfigs = [{

6 "tenantId": "demo",

7 "enableViewCounts": true

8}];

9</script>

10

Dit kan zonder code worden aangepast op de widget‑aanpassingspagina:

Inschakelen van weergavetellingen voor reacties

We volgen de gebruikers‑id* die het commentaar heeft bekeken gedurende één week, zodat als je het commentaar binnen die week opnieuw bekijkt, de teller niet wordt verhoogd. Als je het commentaar na die week opnieuw bekijkt, wordt de teller weer verhoogd.

• *Opmerking: of de anonieme sessie‑id, of het IP‑adres van de gebruiker als een gehashte waarde.

Standaard is live reageren ingeschakeld. Dit betekent dat als er reacties worden toegevoegd, verwijderd, bewerkt of vastgezet, de wijzigingen voor alle gebruikers die de discussiedraad bekijken tegelijk zichtbaar moeten zijn.

Echter, standaard zullen die nieuwe reacties verschijnen onder een dynamisch weergegeven knop met tekst die lijkt op "Show 2 New Comments".

Als de nieuwe reacties direct op de pagina reageren, wordt de knop bovenaan de discussiedraad weergegeven. Als ze een reactie op een specifieke reactie zijn, wordt de knop onder die reactie weergegeven.

Dit is om te voorkomen dat de paginagrootte voortdurend verandert voor de gebruiker, wat mogelijk frustratie veroorzaakt bij het proberen vast te pakken van de scrollbalk.

Voor sommige gebruikssituaties, zoals live bieden of online evenementen, is dit niet het gewenste gedrag – je wilt misschien dat de reactiewidget meer lijkt op een "chat"-venster waarbij nieuwe reacties "direct worden getoond".

Daarom de naam van de vlag die die functie inschakelt: showLiveRightAway.

We kunnen deze als volgt inschakelen:

Toon Live Reacties Direct

Copy Run

1

2<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>

3<div id="fastcomments-widget"></div>

4<script>

5window.fcConfigs = [{

6 "tenantId": "demo",

7 "showLiveRightAway": true

8}];

9</script>

10

Dit kan zonder code worden aangepast op de widget-aanpassingspagina:

Toon Live Reacties Direct

Standaard heeft FastComments live commentaar ingeschakeld.

Dit betekent dat elke kijker van de commentaarthread dezelfde inhoud moet zien.

Bijvoorbeeld, als een commentaar wordt toegevoegd, moet dat commentaar worden weergegeven. Als een commentaar wordt bewerkt of verwijderd, dan zullen die commentaren voor alle kijkers van de thread worden bewerkt of verwijderd. Hetzelfde geldt voor stemmen en alle moderatieacties.

We kunnen dit echter uitschakelen:

Live commentaar uitschakelen

Copy Run

1

2<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>

3<div id="fastcomments-widget"></div>

4<script>

5window.fcConfigs = [{

6 "tenantId": "demo",

7 "disableLiveCommenting": true

8}];

9</script>

10

Dit kan ook zonder code worden gedaan. Op de widget-aanpassingspagina, zie de sectie "Live commentaar uitschakelen".

Live commentaar uitschakelen

Standaard sorteert FastComments opmerkingen op de sorteer richting "Meest Relevant".

Meest Relevant sortering houdt rekening met de tijd waarop de opmerking is geplaatst en het aantal stemmen bij het sorteren.

De gebruiker kan vervolgens de sorteer richting wijzigen naar Oudste of Nieuwste eerst in de UI van de opmerking widget.

We kunnen de standaard echter wijzigen naar een van de drie. Bijvoorbeeld als je de oudste opmerkingen eerst wilt weergeven:

De standaard sortering wijzigen naar oudste eerst

Copy Run

1

2<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>

3<div id="fastcomments-widget"></div>

4<script>

5window.fcConfigs = [{

6 "tenantId": "demo",

7 "defaultSortDirection": "OF"

8}];

9</script>

10

We stellen de waarde van defaultSortDirection in op "OF" om de richting in te stellen op "OF".

Voor de nieuwste-eerst sorteer richting zouden we het volgende doen:

De standaard sortering wijzigen naar nieuwste eerst

Copy Run

1

2<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>

3<div id="fastcomments-widget"></div>

4<script>

5window.fcConfigs = [{

6 "tenantId": "demo",

7 "defaultSortDirection": "NF"

8}];

9</script>

10

De geldige waarden voor defaultSortDirection zijn:

• MR: "Meest Recent"
• NF: "Nieuwste eerst"
• OF: "Oudste eerst"

Dit kan ook zonder code worden gedaan. Op de widget-aanpassingspagina, zie de sectie "Standaard sorteer richting".

De standaard sorteer richting wijzigen

Merk op dat de opmerkingen op elke pagina voor elke sorteer richting vooraf worden berekend, zodat alle sorteer richtingen dezelfde prestaties hebben.

Standaard staat het commentaar-invoergebied vóór de commentaardraad. Door deze configuratieparameter op true in te stellen kunnen we het echter achteraan plaatsen.

Het antwoordvak naar de onderkant verplaatsen

Copy Run

1

2<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>

3<div id="fastcomments-widget"></div>

4<script>

5window.fcConfigs = [{

6 "tenantId": "demo",

7 "inputAfterComments": true

8}];

9</script>

10

Dit kan zonder code worden aangepast op de widget-aanpassingspagina:

Het antwoordvak naar de onderkant verplaatsen

Het maximale aantal tekens dat in het reactie‑invoerveld mag worden ingevoerd, kan worden beperkt door de maxCommentCharacterLength parameter.

Standaard is 2000.

Dingen zoals afbeeldings‑URL's worden niet meegerekend bij de lengtebepaling.

Beperk commentaargrootte

Copy Run

1

2<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>

3<div id="fastcomments-widget"></div>

4<script>

5window.fcConfigs = [{

6 "tenantId": "demo",

7 "maxCommentCharacterLength": 500

8}];

9</script>

10

Dit kan zonder code worden aangepast op de widget‑aanpassingspagina:

Beperk commentaargrootte

Standaard staat FastComments de gebruiker toe om een commentaar in te voeren met zoveel regels als ze willen, tot aan de standaard tekenlimiet.

Het kan echter wenselijk zijn om de gebruiker te beperken tot het invoeren van slechts één regel tekst. Enkele voorbeeldtoepassingen zijn online bieden of live chat, waarvoor FastComments kan worden gebruikt.

We schakelen de useSingleLineCommentInput-vlag in als volgt:

Invoeren van één regel commentaar inschakelen

Copy Run

1

2<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>

3<div id="fastcomments-widget"></div>

4<script>

5window.fcConfigs = [{

6 "tenantId": "demo",

7 "useSingleLineCommentInput": true

8}];

9</script>

10

Dit kan ook zonder code worden gedaan. Op de widget-aanpassingspagina, zie de sectie "Invoeren van één regel commentaar inschakelen".

Invoeren van één regel commentaar inschakelen

Houd er rekening mee dat de commentaren op elke pagina voor elke sorteerrichting vooraf worden berekend, zodat alle sorteerrichtingen dezelfde prestaties hebben.

Standaard kan elke gebruiker tot 5 comments indienen binnen dezelfde minuut.

Dit wordt bijgehouden op basis van user id, anon user id, en ip address (hashed).

Dit kan zonder code worden aangepast op de widget‑aanpassingspagina:

Beperken van commentaarvolume per gebruiker

Merk op dat als je de comment creation API gebruikt, je mogelijk het oorspronkelijke ip‑adres van de gebruiker wilt doorgeven in het verzoek aan onze backend, zodat rate limiting wordt toegepast per gebruiker en niet globaal op je account.

Met FastComments kun je vereisen dat eerste keer commentaargevers je Servicevoorwaarden accepteren voordat ze een reactie plaatsen.

Wanneer ingeschakeld:

• Anonieme gebruikers zien bij elke reactie een TOS-selectievakje
• Geverifieerde gebruikers zien het selectievakje alleen bij hun eerste reactie, of wanneer je je TOS bijwerkt

Configuratie

Navigeer naar de widget-aanpassingspagina en vink het selectievakje "Acceptatie Servicevoorwaarden vereisen" aan. Eenmaal ingeschakeld zie je de volgende opties:

Servicevoorwaarden Opties

• TOS-tekstmodus: Standaard toont het selectievakje "I agree to the Terms of Service and Privacy Policy" met links naar beide documenten. Selecteer "Tekst per taal aanpassen" om je eigen tekst per taal op te geven.
• TOS Datum Laatst Bijgewerkt: Wanneer je je Servicevoorwaarden bijwerkt, stel je deze datum in. Gebruikers die vóór deze datum hebben geaccepteerd, moeten opnieuw accepteren.

Hoe Het Werkt

• De TOS-acceptatietijdstempel wordt per gebruiker en per reactie opgeslagen
• Wanneer een gebruiker de TOS accepteert, wordt de datum vastgelegd in zijn gebruikersprofiel (per tenant)
• Als je een "Laatst Bijgewerkt"-datum instelt die na de acceptatiedatum van de gebruiker ligt, moet hij opnieuw accepteren
• Voor anonieme gebruikers die niet kunnen worden gevolgd, verschijnt het selectievakje bij elke reactie

Polls laten commentatoren een vraag met 2 tot 10 opties aan een reactie toevoegen. Iedereen op de pagina stemt ter plekke en ziet de resultaten live bijwerken.

Polls staan standaard uit. Vink Enable Polls aan in de widget‑aanpassingsinstellingen om een poll‑knop toe te voegen aan de commentaarwerkbalk. Er verschijnen vervolgens twee extra instellingen:

• Who Can Create Polls: Alleen beheerders/moderators (standaard), of Iedereen.
• Allow Anonymous Poll Votes: wanneer niet aangevinkt (standaard), kunnen alleen ingelogde gebruikers stemmen.

Polls inschakelen

Zie de Polls‑gids voor hoe het maken, stemmen, privacy en poll‑meldingen werken.

FastComments Secure SSO gebruikt HMAC-SHA256-versleuteling als mechanisme om SSO te implementeren. Eerst bespreken we de algemene architectuur, geven we voorbeelden en gedetailleerde stappen.

Er is ook documentatie beschikbaar over het migreren van andere providers met vergelijkbare SSO-mechanismen, en de verschillen.

De flow ziet er als volgt uit:

Secure SSO Flow

Omdat Secure SSO full-stack ontwikkeling omvat, zijn volledig werkende codevoorbeelden in Java/Spring, NodeJS/Express en vanilla PHP momenteel op GitHub te vinden.

Hoewel we ExpressJS gebruiken in het NodeJS-voorbeeld en Spring in het Java-voorbeeld, zijn er geen frameworks/bibliotheken vereist in deze runtimes om FastComments SSO te implementeren - de native crypto-pakketten werken.

Je hoeft geen nieuwe API-endpoints te schrijven met FastComments SSO. Versleutel simpelweg de gebruikersinformatie met je geheime sleutel en geef de payload door aan de comment widget.

Verkrijg Je API Secret Key

Je API Secret kan worden opgehaald via deze pagina. Je kunt deze pagina ook vinden door naar My Account te gaan, op de API/SSO-tegel te klikken en vervolgens op "Get API Secret Key" te klikken.

Comment Widget Parameters

API-documentatie op hoog niveau voor de comment widget is hier te vinden.

Laten we in meer detail ingaan op wat deze parameters betekenen.

De comment widget neemt een configuratieobject aan - je geeft dit al door als je FastComments gebruikt om je klant-id door te geven (genaamd tenantId).

Om SSO in te schakelen, geef je een nieuw "sso"-object door, dat de volgende parameters moet bevatten. De waarden moeten server-side worden gegenereerd.

• userDataJSONBase64: De gegevens van de gebruiker in JSON-formaat, die vervolgens Base64-gecodeerd zijn.
• verificationHash: De HMAC-SHA256-hash gemaakt van UNIX_TIME_MILLIS + userDataJSONBase64.
• timestamp: Epoch-timestamp, in milliseconden. Mag niet in de toekomst liggen, of meer dan twee dagen in het verleden.
• loginURL: Een URL die de comment widget kan tonen om de gebruiker in te loggen.
• logoutURL: Een URL die de comment widget kan tonen om de gebruiker uit te loggen.
• loginCallback: Wanneer dit in plaats van de login-URL wordt meegegeven, een functie die de comment widget aanroept wanneer op de inlogknop wordt geklikt.
• logoutCallback: Wanneer dit in plaats van de logout-URL wordt meegegeven, een functie die de comment widget aanroept wanneer op de uitlogknop wordt geklikt.

Secure SSO Client Code

Copy

1

2<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>

3<div id="fastcomments-widget"></div>

4<script>

5window.fcConfigs = [{

6 "tenantId": "demo",

7 "sso": {

8 "userDataJSONBase64": "...",

9 "verificationHash": "...",

10 "timestamp": 1794130022262.0,

11 "loginURL": "https://example.com/login",

12 "logoutURL": "https://example.com/logout",

13 "loginCallback": null,

14 "logoutCallback": null

15 }

16}];

17</script>

18

Het Gebruikersobject

Het Gebruikersobject bevat het volgende schema:

Het Gebruikersobject

Copy

1

2interface SSOUser {

3 /** Required. 1k Characters Max. **/

4 id: string;

5 /** Required. 1k Characters Max. Note: Must be unique. **/

6 email: string;

7 /** Required. 1k Characters Max. Note: The username cannot be an email. Does not have to be unique. **/

8 username: string;

9 /** Optional. 3k Characters Max for URLs. Default is from gravatar based on email. Supports 64 encoded images, in which case the limit is 50k characters. **/

10 avatar?: string;

11 /** Optional. Default false. **/

12 optedInNotifications?: boolean;

13 /** Optional. Default false. **/

14 optedInSubscriptionNotifications?: boolean;

15 /** Optional. 100 Characters Max. This label will be shown next to their name. Default is Administrator/Moderator when applicable. **/

16 displayLabel?: string;

17 /** Optional. 500 Characters Max. This will be shown instead of the username. **/

18 displayName?: string;

19 /** Optional. 2k Characters Max. The user's name will link to this. **/

20 websiteUrl?: string;

21 /** Optional. Up to 100 groups per user. A group id may not be longer than 50 characters. **/

22 groupIds?: string[];

23 /** Optional. Denotes the user as an administrator. **/

24 isAdmin?: boolean;

25 /** Optional. Denotes the user as a moderator. **/

26 isModerator?: boolean;

27 /** Optional, default true. Set to false to enable the "activity" tab in the user's profile. **/

28 isProfileActivityPrivate?: boolean;

29 /** Optional, default false. Set to true to disable profile comments. **/

30 isProfileCommentsPrivate?: boolean;

31 /** Optional, default false. Set to true to disable direct messaging this user. **/

32 isProfileDMDisabled?: boolean;

33 /** Optional configuration for user badges. **/

34 badgeConfig?: {

35 /** Array of global badge IDs to assign. Limited to 30 badges. Order is respected. **/

36 badgeIds: string[];

37 /** Array of badge IDs scoped to the current page (urlId). Only displayed on the assigned page. **/

38 pageBadgeIds?: string[];

39 /** If true, replaces existing displayed badges. Global and page-scoped are overridden independently. **/

40 override?: boolean;

41 /** If true, updates badge display properties from tenant configuration. **/

42 update?: boolean;

43 };

44}

45

Moderators en Beheerders

Geef voor admins en moderators de respectievelijke vlaggen isAdmin of isModerator door in het SSOUser-object.

Meldingen

Om meldingen in of uit te schakelen, stel je de waarde van optedInNotifications respectievelijk in op true of false. De eerste keer dat de gebruiker de pagina laadt met deze waarde in de SSO-payload, worden hun meldingsinstellingen bijgewerkt.

Als je bovendien wilt dat gebruikers meldingse-mails ontvangen voor activiteit op pagina's waarop ze zijn geabonneerd (in plaats van alleen in-app meldingen), stel je optedInSubscriptionNotifications in op true.

VIP-gebruikers & Speciale Labels

Je kunt een speciaal label naast de naam van de gebruiker tonen door het optionele veld "displayLabel" te gebruiken.

Niet-geauthenticeerde gebruikers

Om een niet-geauthenticeerde gebruiker weer te geven, vul je simpelweg userDataJSONBase64, verificationHash of timestamp niet in. Geef een loginURL op.

Deze gebruikers kunnen niet reageren en krijgen in plaats daarvan een inlogbericht te zien (bericht, link of knop, afhankelijk van de configuratie).

Directe Voorbeelden voor Serialiseren en Hashen van Gebruikersgegevens

Meer details als voorbeeld zijn hier (js), hier (java) en hier (php) te vinden.

We begrijpen dat elke integratie een gecompliceerd en pijnlijk proces kan zijn. Aarzel niet om contact op te nemen met je vertegenwoordiger of gebruik de ondersteuningspagina.

Met Simple SSO kunnen we de commentaarwidget voorzien van informatie over de gebruiker, zodat ze hun gebruikersnaam of e‑mail niet hoeven in te voeren om te reageren.

We kunnen Simple SSO als volgt configureren:

Simple SSO

Copy Run

1

2<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>

3<div id="fastcomments-widget"></div>

4<script>

5window.fcConfigs = [{

6 "tenantId": "demo",

7 "simpleSSO": {

8 "username": "Bob",

9 "email": "bob@example.com",

10 "avatar": "https://example.com/bob.png",

11 "websiteUrl": "https://example.com/profiles/bob",

12 "displayName": "Bob's Name",

13 "displayLabel": "VIP User",

14 "loginURL": "https://example.com/login",

15 "logoutURL": "https://example.com/logout",

16 "badgeConfig": {

17 "badgeIds": [

18 "badge-id-1",

19 "badge-id-2"

20 ],

21 "pageBadgeIds": [

22 "badge-id-3"

23 ],

24 "override": false

25 }

26 }

27}];

28</script>

29

De gebruiker zal ingelogd zijn en er wordt achter de schermen een SSO‑gebruiker aangemaakt. De gebruiker zal createdFromSimpleSSO op true hebben als deze via de API wordt opgehaald.

Opmerkingen:

• E‑mail is de unieke identifier voor Simple SSO.
• Het verstrekken van een e‑mail met Simple SSO is niet vereist, maar standaard worden hun reacties weergegeven als "Ongeverifieerd". Als er geen e‑mail wordt opgegeven, kan de gebruiker niet volledig worden geauthenticeerd.
• NIEUW Sinds jan 2022: Gebruikersnamen hoeven niet uniek te zijn op fastcomments.com
• Simple SSO kan automatisch SSO‑gebruikers aanmaken en bijwerken, als er een e‑mail wordt opgegeven en de gebruiker niet oorspronkelijk is aangemaakt via Secure SSO. Als een Simple SSO‑payload een gebruiker benoemt die is aangemaakt door Secure SSO of de API, blijft die gebruiker onaangeroerd en krijgt de bezoeker een aparte gebruiker.
• Je kunt badges voor de gebruiker opgeven met de eigenschap badgeConfig. De array badgeIds bevat de ID's van globale badges die aan de gebruiker worden gekoppeld. De array pageBadgeIds bevat badge‑ID's die zijn beperkt tot de huidige pagina (urlId) — deze badges worden alleen weergegeven op de pagina waaraan ze zijn toegewezen. Als override op true staat, vervangt deze de reeds weergegeven badges (globale en paginabeperkte badges worden onafhankelijk overschreven); als false worden ze toegevoegd aan de bestaande badges.

Simple SSO-instellingen

Simple SSO is altijd beschikbaar. Twee instellingen bepalen hoeveel FastComments erop vertrouwt. Je kunt ze vinden door te zoeken naar SSO in een aanpassingsregel. Beide staan standaard uit, en ze gelden ongeacht of "Require SSO To View Comments" is ingeschakeld.

Accounts die al Simple SSO gebruikten toen deze instellingen werden toegevoegd, hebben beide ingeschakeld, dus er is niets voor hen veranderd.

Alleen de aanpassingsregel die het beste bij een pagina past, wordt toegepast, dus als je meer dan één regel hebt, stel deze op elk van hen in. Een nieuwe regel begint met deze ingeschakeld als een van je andere regels ze ingeschakeld heeft.

Automatisch verifiëren van reacties via Simple SSO

Wanneer dit is ingeschakeld, worden reacties van Simple SSO‑gebruikers direct geverifieerd.

Wanneer dit is uitgeschakeld, worden reacties van Simple SSO‑gebruikers weergegeven als "Ongeverifieerd" totdat de gebruiker op een link klikt die we per e‑mail naar het adres in de Simple SSO‑payload sturen. Als je alleen automatisch geverifieerde reacties goedkeurt, wachten ze ook op die link. Als er geen e‑mail in de payload zit, blijft de reactie ongeverifieerd.

Deze instelling heeft alleen invloed op reacties. Stemmen van Simple SSO‑gebruikers worden altijd direct geteld.

Toestaan van Simple SSO-beheerders

Wanneer dit is ingeschakeld, kan een Simple SSO‑gebruiker een beheerder of moderator van je account zijn:

• Een Simple SSO‑gebruiker die admin‑ of moderatorrechten heeft, behoudt deze.
• Een Simple SSO‑gebruiker met dezelfde e‑mail als een van je beheerders of moderators krijgt hun rechten.

Wanneer dit is uitgeschakeld, verleent Simple SSO deze rechten niet. Een Simple SSO‑payload die een gebruiker benoemt die deze rechten heeft, krijgt een aparte gebruiker zonder rechten, en de oorspronkelijke gebruiker blijft onaangeroerd.

Simple SSO‑payloads zijn niet ondertekend, dus wanneer dit is ingeschakeld, kan iedereen die de e‑mail of gebruikers‑ID van een beheerder kent, zich voordoen als die persoon. Als dat van belang is voor je site, laat dit dan uitgeschakeld en gebruik Secure SSO voor je beheerders.

Gebruikers die zijn aangemaakt door Secure SSO of de API kunnen niet worden bereikt door Simple SSO, ongeacht of dit is ingeschakeld.

FastComments SSO (details hier) biedt je gebruikers een manier om te reageren zonder dat ze hoeven in te loggen op een ander platform.

Dit alleen beveiligt je commentaarthreads echter niet, omdat commentaargegevens standaard publiek beschikbare informatie zijn - iedereen die de pagina kan bekijken, kan de reacties bekijken.

Door een instelling te wijzigen, kunnen we voorkomen dat reacties worden opgehaald, tenzij dit door een beheerder of geldige SSO-gebruiker gebeurt.

No-Code Setup

We kunnen voorkomen dat onze commentaarthreads worden bekeken en dat er interactie mee plaatsvindt wanneer SSO is ingesteld, door een customization rule aan te maken.

Zoek bij het doen daarvan naar SSO, en je vindt deze optie:

Vereis SSO Om Reacties Te Bekijken

Schakel deze in en sla de customization rule op.

Alleen een Bepaald Domein of Pagina Beveiligen

Om alleen een bepaald domein of pagina te beveiligen, configureren we de customization rule eenvoudigweg om dit te doen.

Bovenaan de customization-UI vinden we twee invoervelden: Domain en URL ID.

Om alleen een bepaald domein te beveiligen, voer je het betreffende domein in het veld "domain" in.

Om een bepaalde pagina te beveiligen, voer je een pagina-URL in het veld "URL ID" in. Als je een aangepaste integratie met FastComments hebt, kun je hier in plaats van een URL een soort ID invoeren.

Beveiligingsniveaus

Wanneer je SSO vereist, moet je beslissen of je Simple SSO of Secure SSO vereist. Als je Simple SSO vereist, zijn beide toegestaan, maar als je Secure SSO vereist, dan moet de content worden opgehaald met een Secure SSO-payload die is gehasht met je API-sleutel om bekeken te kunnen worden.

De optie voor het beveiligingsniveau verschijnt wanneer je "Require SSO To View Comments" selecteert, en heeft alleen effect terwijl die optie aan staat.

De instellingen Auto Verify Comments via Simple SSO en Allow Simple SSO Admins zijn apart, en gelden ongeacht of deze optie aan staat.

Bescherming Buiten het Lezen

Het inschakelen van deze optie beschermt de pagina of het domein tegen reacties, tenzij de gebruiker is ingelogd via SSO.

Aandachtspunten

Gebruikers die reacties hebben geplaatst vóór je SSO-integratie kunnen deze niet zien, tenzij ze inloggen via je SSO-integratie.

Standaard vereist FastComments een e-mailadres om te reageren. Het hoeft geen geldig e-mailadres te zijn, maar totdat de gebruiker op een naar hen gestuurde link klikt, zal hun reactie het label "Ongeverifieerde Reactie" tonen.

We kunnen de e-mailvereiste echter verwijderen. Het e-mailinvoerveld blijft zichtbaar, maar is niet langer verplicht.

Dit kan worden geconfigureerd via de widget-aanpassingsinterface:

Anonieme reacties inschakelen

Er is nog steeds een gebruikersnaam vereist. Om die stap ook te verwijderen, kun je een standaardgebruikersnaam instellen die iedereen deelt, of FastComments een unieke gebruikersnaam laten genereren voor elke bezoeker.

FastComments kan worden geconfigureerd om niet‑geverifieerde reacties te verwijderen na een gewenst aantal dagen. Dit helpt spam te bestrijden.

Standaard doet het dat niet.

Dit kan worden geconfigureerd, of uitgeschakeld, via de Moderation Settings pagina.

Moderatie-instellingen

Wanneer gebruikers een reactie plaatsen en ze niet zijn ingelogd, wordt hen gevraagd hun e‑mail op te geven.

Dit zal een "ongeverifieerde sessie" voor die gebruiker creëren, en we zullen hen vragen die sessie via e‑mail te verifiëren.

Voor sommige sites of applicaties is het wenselijk de gebruiker niet om zijn e‑mail te vragen bij het reageren of stemmen.

Het inschakelen van anoniem reageren maakt het e‑mail invoerveld optioneel. We kunnen het echter volledig uitschakelen. Schakel eerst anoniem reageren in, en daarna verschijnt de optie om de e‑mail invoervelden uit te schakelen.

E‑mailinvoer uitschakelen

Met deze instelling worden de e‑mailvelden helemaal niet getoond in al onze reactietoepassingen.

Let op dat, met deze configuratie, alle reacties ongeverifieerd zullen zijn tenzij de gebruiker een account aanmaakt en inlogt op https://fastcomments.com.

U kunt overwegen om het ongeverifieerde label uit te schakelen.

Standaard toont FastComments een "Niet-geverifieerde reactie"-label voor reacties die zijn achtergelaten voor een gebruiker met een niet-geverifieerde browsersessie. Lees meer over niet-geverifieerde reacties hier.

Disable The Unverified Label

Copy Run

1

2<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>

3<div id="fastcomments-widget"></div>

4<script>

5window.fcConfigs = [{

6 "tenantId": "demo",

7 "disableUnverifiedLabel": true

8}];

9</script>

10

Bovendien kan deze functie, zonder code te schrijven, worden gebruikt in de UI voor aanpassing:

Uitschakel het label voor niet-geverifieerde opmerkingen

Wanneer gebruikers proberen te stemmen op een reactie en ze niet zijn ingelogd, worden ze gevraagd hun gebruikersnaam en e‑mail op te geven.

We kunnen deze vereiste verwijderen, zodat iedereen op een reactie kan stemmen zonder enige informatie achter te laten.

Anonieme stemmen toestaan

Wanneer gebruikers reageren of stemmen en ze niet zijn ingelogd, worden ze gevraagd hun e‑mail en gebruikersnaam op te geven.

In het geval van anonieme reacties is het soms wenselijk een standaardgebruikersnaam te definiëren om de wrijving bij reageren te verminderen. Dit kan gedaan worden via de Aanpassings‑UI. Anonieme reacties moeten eerst worden ingeschakeld.

Instellen van de standaard gebruikersnaam

Delen van de standaard gebruikersnaam

De standaardgebruikersnaam is een gedeelde weergavenaam, geen identiteit. Een bezoeker die de standaard behoudt en zijn e‑mail invoert, krijgt een eigen account, waarbij de standaard wordt weergegeven als hun openbare naam. Een willekeurig aantal bezoekers kan dezelfde standaard behouden, zodat "Anonymous" nooit als al bezet wordt gemeld.

Gebruikersnamen die een bezoeker zelf invoert, moeten nog steeds uniek zijn.

Als je liever wilt dat elke bezoeker een unieke naam krijgt zonder er zelf over na te denken, zie Gebruikersnamen automatisch genereren.

Wanneer gebruikers reageren of stemmen, en ze zijn niet ingelogd, wordt hen gevraagd hun e-mailadres en gebruikersnaam op te geven.

Voor sommige sites is het vragen aan een bezoeker om een unieke gebruikersnaam te verzinnen een drempel, vooral op mobiel. FastComments kan een neutrale gebruikersnaam genereren voor elke nieuwe bezoeker en deze vooraf invullen in het veld gebruikersnaam, zoals BraveOtter4172.

De bezoeker kan deze laten staan, of vervangen door een naam naar eigen keuze.

Dit kan worden ingeschakeld via de Customization UI, onder de instelling genaamd Generate Usernames Automatically:

Generate Usernames Automatically

Hoe het werkt

• Elke gegenereerde naam is uniek. Deze wordt gecontroleerd tegen bestaande accounts en gereserveerd voor de browsersessie van die bezoeker, zodat twee bezoekers niet dezelfde naam aangeboden krijgen.
• De naam wordt alleen gegenereerd voor bezoekers die er nog geen hebben. Ingelogde gebruikers, SSO-gebruikers en bezoekers die al hebben gereageerd behouden hun bestaande naam.
• Het werkt met of zonder anoniem reageren. Met anoniem reageren uitge schakeld vult de bezoeker nog steeds zijn e-mailadres in, maar hoeft niet langer een gebruikersnaam te bedenken.
• Een terugkerende bezoeker die een e-mailadres invult dat hij eerder heeft gebruikt, wordt gekoppeld aan zijn bestaande account en behoudt de naam van dat account.
• Als ook een Default Username is ingesteld, heeft de gegenereerde naam voorrang.

Standaard zal FastComments de commentaarwidget weergeven in de locale die wordt bepaald door het systeem en de browser van de gebruiker.

Wanneer een gebruiker een reactie plaatst of inlogt, werken we hun laatst gebruikte locale bij en gebruiken we deze ook voor het verzenden van e‑mails.

Dit beïnvloedt hoe de commentaarwidget voor de gebruiker wordt vertaald. Een locale bestaat uit de taal en regio van de gebruiker, dus het configureren van de locale zal meestal de taal wijzigen die wordt gebruikt om tekst aan de gebruiker te tonen.

Via de UI

Dit kan worden gedefinieerd via de UI voor widgetaanpassing. Zie de optie "Locale / Language" :

De locale / taal wijzigen

Via code

Dit kan worden overschreven met een gewenste locale.

Handmatig definiëren van de locale van de gebruiker

Copy Run

1

2<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>

3<div id="fastcomments-widget"></div>

4<script>

5window.fcConfigs = [{

6 "tenantId": "demo",

7 "locale": "ru_ru"

8}];

9</script>

10

Ondersteunde talen en locale-codes

U kunt de volledige lijst met ondersteunde talen en de bijbehorende locale-codes hier vinden.

SSO-opmerking

Als u SSO gebruikt, wilt u mogelijk de locale van de gebruiker doorgeven in het gebruikersobject, zodat e‑mails en andere zaken correct voor hen worden gelokaliseerd.

Standaard beperkt FastComments de talen die gebruikt worden om te reageren niet.

Het kan wenselijk zijn om de talen die een community gebruikt te beperken.

Dit kan geconfigureerd worden zonder code, op de widget-aanpassingspagina:

Toegestane Talen

Het systeem zal de reactie analyseren en de taal bepalen, en deze vervolgens matchen met de lijst van toegestane talen.

Als de reactie in een niet-toegestane taal is geschreven, wordt een gelokaliseerde foutmelding getoond.

Standaard vertaalt FastComments de eigen interface van de widget (knoppen, labels, foutmeldingen) naar de taal van de kijker, maar reacties worden precies getoond zoals ze zijn geschreven.

Comment Translation voegt vertaling van de reacties zelf toe, zodat een community die in meer dan één taal schrijft elke reactie in de eigen taal kan lezen.

Er zijn twee modi:

• Automatisch: reacties die in een andere taal dan de taal van de widget zijn geschreven, worden vertaald getoond. Onder de reactie verschijnt een regel "Vertaald uit het Spaans" met een Show original-link die wisselt tussen de vertaling en de onvertaalde tekst.
• Handmatig: elke reactie krijgt een Translate-link. Door erop te klikken wordt die ene reactie vertaald naar de taal van de kijker, met daarna dezelfde Show original-schakelaar. Reacties die al in de taal van de kijker zijn, zeggen dat in plaats daarvan.

De doeltaal is de taal van de widget: de instelling Locale / Language op dezelfde aanpassingsregel als die is ingesteld, anders de browsertaal van de bezoeker. Er wordt niets van de bezoeker vereist, geen account, extensie of extra software, en het werkt hetzelfde in de ingesloten widget en op standalone reactiepagina's.

Dit wordt per aanpassingsregel ingeschakeld, dus het kan van toepassing zijn op je hele site, één domein of één pagina. Het staat standaard uit.

Comment Translation

Vertaling is een server-side instelling. Het doorgeven van commentTranslation in de JavaScript-configuratie van de widget schakelt het niet in; de regel doet dat.

Elke reactie wordt maximaal één keer per doeltaal vertaald en het resultaat wordt bij de reactie opgeslagen, zodat een reactie die door duizend Spaanstaligen wordt gelezen maar één keer wordt vertaald. Als de auteur of een moderator de reactie bewerkt, wordt de opgeslagen vertaling verwijderd en wordt de reactie bij de volgende weergave opnieuw vertaald. Vertaalde tekst gaat door dezelfde sanitization- en linkregels als de originele reactie. Reacties die te lang zijn, of waarvan de taal niet kan worden gedetecteerd, worden onvertaald getoond.

Gebruik wordt gefactureerd als LLM-tokens tegen hetzelfde tarief als AI Agents en verschijnt op dezelfde plek in je factureringsgegevens.

Commentaar kan worden vergrendeld zodat er geen nieuwe reacties of stemmen kunnen worden geplaatst door de readonly‑vlag op true te zetten.

Reacties kunnen ook niet meer worden bewerkt of verwijderd.

Making The Comment Thread Readonly

Copy Run

1

2<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>

3<div id="fastcomments-widget"></div>

4<script>

5window.fcConfigs = [{

6 "tenantId": "demo",

7 "readonly": true

8}];

9</script>

10

Dit kan zonder code worden aangepast, op de widget‑aanpassingspagina, voor een heel domein of een pagina:

De commentaarthread readonly maken

Update!

Vanaf november 2022 kunnen threads live worden vergrendeld of ontgrendeld door beheerders en moderators via het drie‑punt‑menu boven het antwoordgebied.

Dit voorkomt nieuwe reacties, terwijl stemmen nog wel mogelijk blijft en gebruikers hun reacties kunnen verwijderen indien gewenst, terwijl readonly deze mogelijkheden niet toestaat.

Dit komt overeen met het isClosed‑veld in de Page‑API.

Standaard staat FastComments toe om te linken naar elke externe site.

Dit kan in plaats daarvan worden beperkt tot een gewenste lijst van sites of domeinen. Als je probeert een link naar een site of domein te plaatsen die niet in de gedefinieerde lijst staat, wordt er een foutmelding aan de gebruiker getoond.

Deze validatie geldt alleen voor de Comment Widget en de API. Imports worden niet beïnvloed.

Dit wordt gedaan zonder code, op de widget‑aanpassingspagina:

Beperk externe linkdomeinen

Standaard vraagt FastComments alleen om de opmerking, de gebruikersnaam en het e-mailadres van de gebruiker.

In sommige situaties wilt u echter dat de gebruiker een link naar zijn of haar eigen blog of website achterlaat.

We kunnen het tonen van een extra invoerveld voor de website-URL van de gebruiker inschakelen door de enableCommenterLinks-vlag op true te zetten:

Commentaarlinks inschakelen

Copy Run

1

2<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>

3<div id="fastcomments-widget"></div>

4<script>

5window.fcConfigs = [{

6 "tenantId": "demo",

7 "enableCommenterLinks": true

8}];

9</script>

10

Wanneer die URL wordt opgegeven, wordt het account van de gebruiker bijgewerkt en zal hun gebruikersnaam op alle eerdere en toekomstige reacties naar deze URL verwijzen.

Dit kan zonder code worden aangepast op de widget-aanpassingspagina:

Commentaarlinks inschakelen

Een lijst met id's die zijn gegenereerd vanaf de Moderatiegroepen pagina.

Wanneer opgegeven, bevatten opmerkingen die met de opgegeven configuratie zijn geplaatst dezelfde set van moderationGroupIds.

Als een Moderator één of meer Moderatiegroepen heeft gedefinieerd, zullen zij alleen opmerkingen zien op de pagina Moderate Comments die gekoppeld zijn aan hun groep(en).

Specify Moderation Groups

Copy Run

1

2<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>

3<div id="fastcomments-widget"></div>

4<script>

5window.fcConfigs = [{

6 "tenantId": "demo",

7 "moderationGroupIds": [

8 "mxZAhjzdb",

9 "FT19nXbqA"

10 ]

11}];

12</script>

13

Voor authenticatie is FastComments afhankelijk van ingeschakelde third‑party‑cookies in uw browser. Zonder deze cookies moeten gebruikers altijd hun e‑mail achterlaten om te reageren (tenzij het e‑mail invoerveld verborgen is), en hun reacties worden standaard als niet‑geverifieerd weergegeven.

Om dit te omzeilen kunt u de third‑party‑cookie‑bypass inschakelen.

Wanneer deze instelling is ingeschakeld, veroorzaakt dit een klein pop‑upvenster dat een bericht toont waarin staat dat de gebruiker wordt ingelogd. Dit pop‑upvenster wordt getoond telkens wanneer de gebruiker interactie heeft met de commentaarwidget; bijvoorbeeld wanneer hij/zij een reactie achterlaat.

We kunnen dit in code doen door de enableThirdPartyCookieBypass‑vlag op true te zetten:

Third-Party Cookie Bypass inschakelen

Copy Run

1

2<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>

3<div id="fastcomments-widget"></div>

4<script>

5window.fcConfigs = [{

6 "tenantId": "demo",

7 "enableThirdPartyCookieBypass": true

8}];

9</script>

10

We kunnen dit ook instellen via de Widget‑aanpassings‑UI, onder Enable Third-Party Cookie Popup:

Third-Party Cookie Bypass inschakelen

Standaard kunnen gebruikers hun eigen reacties verwijderen. Ook wordt bij het verwijderen van hun reactie automatisch alle onderliggende en tijdelijke reacties in de thread verwijderd. Dit gedrag is ook actief.

Je kunt dit op de volgende manieren beperken:

• Verwijderde reacties in plaats daarvan anonimiseren (naam en tekst instellen op [deleted] of een aangepaste waarde).
• Het verwijderen van reacties niet toestaan wanneer er antwoorden zijn. Er wordt een aanpasbare foutmelding getoond.
• Het verwijderen wanneer een reactie antwoorden heeft, beperken tot alleen beheerders en moderatoren.

Dit kan worden geconfigureerd via de sectie Comment Thread Deletion in de Widget Customization UI.

Verwijdergedrag voor antwoorden aanpassen

Standaard toont FastComments gebruikersbadges alleen op hun reacties binnen de discussiedraad.

We kunnen echter gebruikersbadges naast hun naam boven het reactieformulier weergeven door deze functie in te schakelen op de widget-aanpassingspagina:

Optie om badges in de bovenbalk weer te geven

Dit zal de badges van de gebruiker naast hun naam in de bovenbalk weergeven, waardoor hun prestaties en status meer opvallen wanneer ze een reactie schrijven.

Let op dat deze functie ingeschakeld moet zijn in de widget-aanpassingsinterface om te werken. Je kunt optioneel de showBadgesInTopBar-vlag op false zetten in je codeconfiguratie om deze selectief uit te schakelen, zelfs wanneer deze op serverniveau is ingeschakeld:

Disable Show Badges in Top Bar

Copy Run

1

2<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>

3<div id="fastcomments-widget"></div>

4<script>

5window.fcConfigs = [{

6 "tenantId": "demo",

7 "showBadgesInTopBar": false

8}];

9</script>

10

Standaard toont FastComments geen lijst met gebruikers op de pagina.

Je kunt een lijst weergeven van mensen die momenteel de pagina bekijken, naast de commentaarwidget. De lijst wordt live bijgewerkt wanneer gebruikers binnenkomen en vertrekken, en toont hun naam, avatar en een online‑indicator.

Er zijn drie lay‑outopties:

• 1 - Top: een horizontale rij overlappende avatars weergegeven boven de reacties.
• 2 - Left: een zijbalk met namen en online stippen weergegeven links van de widget.
• 3 - Right: dezelfde zijbalk weergegeven rechts van de widget.

Stel de usersListLocation‑vlag in om de functie in te schakelen:

Toon gebruikerslijst aan de rechterkant

Copy Run

1

2<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>

3<div id="fastcomments-widget"></div>

4<script>

5window.fcConfigs = [{

6 "tenantId": "demo",

7 "usersListLocation": 3

8}];

9</script>

10

Standaard toont de lijst alleen gebruikers die momenteel online zijn. Om ook mensen op te nemen die in het verleden op de pagina hebben gereageerd (maar nu niet bekijken), stel usersListIncludeOffline in op true:

Inclusief eerdere commentatoren

Copy Run

1

2<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>

3<div id="fastcomments-widget"></div>

4<script>

5window.fcConfigs = [{

6 "tenantId": "demo",

7 "usersListLocation": 3,

8 "usersListIncludeOffline": true

9}];

10</script>

11

Eerdere commentatoren worden weergegeven zonder de groene online stip, zodat duidelijk is wie er op dit moment aanwezig is.

Gebruikers met privéprofielen worden getoond met een generieke avatar en een "Privéprofiel"-label, zodat het aantal nauwkeurig blijft zonder identiteiten te onthullen.

Dit kan ook worden geconfigureerd zonder code. Op de widget‑aanpassingspagina, zie de optie "Users List Location". Wanneer de locatie is ingesteld op iets anders dan Off, verschijnt er een selectievakje "Include past commenters" eronder.

Instellingen gebruikerslijst

Bij meer dan 500 live gebruikers is de lijst tot 30 seconden verouderd.