Aanpassingen en 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. Echter, we kunnen 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 kunnen hier worden gevonden onder het tabblad "geavanceerde opties" tab.

Er is echter een eenvoudigere manier, via de widget‑aanpassings‑UI. 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.

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 can enable spoiler support by setting the enableSpoilers flag to true:

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

This can also be done without code. In the widget customization page, see the "Enable Spoilers" option.

Spoilers inschakelen

When text is highlighted, and the now visible SPOILER button is clicked, text will be masked until the user mouses over it. For dark mode we do the same thing, with different colors that better match dark mode.

This is also compatible with the WYSIWYG editor.

Standaard houdt FastComments niet bij wie elke reactie heeft bekeken of biedt enige statistieken hierover.

We kunnen deze functie echter inschakelen, waarna het systeem begint te volgen wanneer elke gebruiker naar een reactie scrolt.

Wanneer dit gebeurt, wordt een teller naast een oogpictogram dat op elke reactie wordt getoond, 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:

Inschakelen van weergavetellingen voor reacties

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 de reactie heeft bekeken, zodat als je de reactie opnieuw bekijkt, deze niet wordt verhoogd. Als je de reactie opnieuw bekijkt na twee jaar, zal de teller meer verhogen.

• *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.

By default the comment input area is before the comment thread. However, by setting this configuration parameter to true we can move it to after.

Het verplaatsen van het antwoordvak naar de onderkant

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

This can be customized without code, on the widget customization page:

Het verplaatsen van het antwoordvak naar de onderkant

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.

FastComments stelt je in staat om van eerste keer commentatoren te eisen dat ze je Servicevoorwaarden accepteren voordat ze een reactie indienen.

Wanneer ingeschakeld:

• Anonieme gebruikers zien elke keer dat ze reageren een TOS-selectievakje
• Geauthenticeerde gebruikers zien het selectievakje alleen bij hun eerste reactie, of wanneer je je TOS bijwerkt

Configuration

Ga naar de widget-aanpassingspagina en schakel het selectievakje "Vereis acceptatie van Servicevoorwaarden" in. Zodra dit is ingeschakeld, zie je de volgende opties:

Opties voor Servicevoorwaarden

• TOS Tekstmodus: Standaard toont het selectievakje "Ik ga akkoord met de Servicevoorwaarden en het Privacybeleid" met links naar beide documenten. Selecteer "Tekst per locale aanpassen" om je eigen tekst voor elke taal te geven.
• TOS Laatst Bijgewerkt Datum: Wanneer je je Servicevoorwaarden bijwerkt, stel je deze datum in. Gebruikers die vóór deze datum hebben geaccepteerd, moeten opnieuw accepteren.

How It Works

• Het tijdstempel van de TOS-acceptatie wordt per gebruiker en per reactie opgeslagen
• Wanneer een gebruiker de TOS accepteert, wordt de datum op hun gebruikersprofiel (per tenant) vastgelegd
• Als je een "Laatst Bijgewerkt" datum instelt die later is dan de acceptatiedatum van de gebruiker, moeten ze opnieuw accepteren
• Voor anonieme gebruikers die niet kunnen worden gevolgd, verschijnt het selectievakje bij elke reactie-indiening

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

Er is ook documentatie over het migreren vanaf andere leveranciers met vergelijkbare SSO-mechanismen, en de verschillen.

De flow ziet er als volgt uit:

Secure SSO Flow

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

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

U hoeft geen nieuwe API-eindpunten te schrijven voor FastComments SSO. Versleutel eenvoudig de gebruikersgegevens met uw geheime sleutel en geef de payload door aan de comment-widget.

Get Your API Secret Key

Uw API Secret kan worden opgehaald vanaf deze pagina. U kunt deze pagina ook vinden door naar Mijn account te gaan, op de API/SSO-tegel te klikken en vervolgens op "Get API Secret Key" te klikken.

Comment Widget Parameters

High-level API-documentatie voor de comment widget is te vinden hier.

Laten we dieper ingaan op wat deze parameters betekenen.

De comment widget accepteert een configuratieobject — u geeft dit al door als u FastComments gebruikt om uw klant-id (genoemd tenantId) door te geven.

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

• userDataJSONBase64: De gebruikersgegevens 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 opgegeven in plaats van de login-URL, een functie die de comment widget zal aanroepen bij het klikken op de loginknop.
• logoutCallback: Wanneer opgegeven in plaats van de logout-URL, een functie die de comment widget zal aanroepen bij het klikken op de logoutknop.

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": 1787115342876.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 User-object bevat het volgende schema:

Het gebruikersobject

Copy

1

2interface SSOUser {

3 /** Verplicht. Maximaal 1k tekens. **/

4 id: string;

5 /** Verplicht. Maximaal 1k tekens. Opmerking: moet uniek zijn. **/

6 email: string;

7 /** Verplicht. Maximaal 1k tekens. Opmerking: de gebruikersnaam mag geen e-mailadres zijn. Hoeft niet uniek te zijn. **/

8 username: string;

9 /** Optioneel. Maximaal 3k tekens voor URL's. Standaard afkomstig van gravatar op basis van e-mail. Ondersteunt 64-gecodeerde afbeeldingen, in dat geval is de limiet 50k tekens. **/

10 avatar?: string;

11 /** Optioneel. Standaard false. **/

12 optedInNotifications?: boolean;

13 /** Optioneel. Standaard false. **/

14 optedInSubscriptionNotifications?: boolean;

15 /** Optioneel. Maximaal 100 tekens. Dit label wordt naast hun naam getoond. Standaard is Administrator/Moderator waar van toepassing. **/

16 displayLabel?: string;

17 /** Optioneel. Maximaal 500 tekens. Dit wordt in plaats van de gebruikersnaam getoond. **/

18 displayName?: string;

19 /** Optioneel. Maximaal 2k tekens. De naam van de gebruiker linkt naar dit adres. **/

20 websiteUrl?: string;

21 /** Optioneel. Tot 100 groepen per gebruiker. Een groeps-id mag niet langer zijn dan 50 tekens. **/

22 groupIds?: string[];

23 /** Optioneel. Geeft de gebruiker aan als beheerder. **/

24 isAdmin?: boolean;

25 /** Optioneel. Geeft de gebruiker aan als moderator. **/

26 isModerator?: boolean;

27 /** Optioneel, standaard true. Zet op false om het tabblad "activity" in het gebruikersprofiel in te schakelen. **/

28 isProfileActivityPrivate?: boolean;

29 /** Optioneel, standaard false. Zet op true om profielreacties uit te schakelen. **/

30 isProfileCommentsPrivate?: boolean;

31 /** Optioneel, standaard false. Zet op true om direct messaging naar deze gebruiker uit te schakelen. **/

32 isProfileDMDisabled?: boolean;

33 /** Optionele configuratie voor gebruikersbadges. **/

34 badgeConfig?: {

35 /** Array van globale badge-IDs om toe te wijzen. Beperkt tot 30 badges. Volgorde wordt gerespecteerd. **/

36 badgeIds: string[];

37 /** Array van badge-IDs gescopeerd naar de huidige pagina (urlId). Alleen weergegeven op de toegewezen pagina. **/

38 pageBadgeIds?: string[];

39 /** Als true, vervangt bestaande weergegeven badges. Globale en pagina-gescopeerde worden onafhankelijk overschreven. **/

40 override?: boolean;

41 /** Als true, werkt badge-weergave-eigenschappen bij vanuit de tenantconfiguratie. **/

42 update?: boolean;

43 };

44}

45

Moderators and Administrators

Voor admins en moderators, geef de respectieve isAdmin of isModerator-vlaggen door in het SSOUser-object.

Notifications

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

Daarnaast, als u wilt dat gebruikers e-mailmeldingen ontvangen voor activiteit op pagina's waarop ze zich hebben geabonneerd (in tegenstelling tot alleen in-app meldingen), zet dan optedInSubscriptionNotifications op true.

VIP Users & Special Labels

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

Unauthenticated users

Om een niet-geauthenticeerde gebruiker te representeren, vul eenvoudigweg geen userDataJSONBase64, verificationHash of timestamp 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).

Direct Examples for Serializing and Hashing User Data

Meer details en voorbeelden zijn hier (js), hier (java) en hier (php).

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

FastComments SSO (details hier) biedt uw gebruikers een manier om te reageren zonder zich bij een ander platform te hoeven aanmelden.

Echter, dit alleen maakt uw discussies niet veilig, aangezien standaard commentaargegevens openbaar beschikbare informatie zijn - iedereen die de pagina kan bekijken, kan de opmerkingen zien.

Door een instelling te wijzigen, kunnen we beperken dat opmerkingen worden opgehaald, tenzij dit gebeurt door een beheerder of een geldige SSO‑gebruiker.

Instelling zonder code

We kunnen het bekijken en interactie met onze discussies voorkomen, wanneer SSO is ingesteld, door een aanpassingsregel te maken.

Zoek bij het uitvoeren hiervan naar SSO, en u zult deze optie vinden:

Vereis SSO om opmerkingen te bekijken

Schakel deze in en sla de aanpassingsregel op.

Bescherm alleen een bepaald domein of pagina

Om alleen een bepaald domein of een bepaalde pagina te beschermen, configureren we eenvoudigweg de aanpassingsregel hiervoor.

Bovenaan de aanpassings‑UI vinden we twee invoervelden, Domein en URL‑ID.

Om alleen een specifiek domein te beschermen, voert u het betreffende domein in het veld "domain" in.

Om een specifieke pagina te beschermen, voert u een pagin URL in het veld "URL ID" in. Als u een aangepaste integratie met FastComments heeft, kunt u hier in plaats van een URL een type ID invoeren.

Beveiligingsniveaus

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

De optie voor beveiligingsniveau verschijnt wanneer u "Vereis SSO om opmerkingen te bekijken" selecteert.

Bescherming verder dan lezen

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

Valstrikken

Gebruikers die opmerkingen hebben gemaakt vóór uw SSO‑integratie, kunnen deze niet meer zien, tenzij ze zich aanmelden via uw SSO‑integratie.

Standaard vereist FastComments een e‑mail om te reageren. Het hoeft geen geldig e‑mailadres te zijn, maar totdat de gebruiker op een verzonden link klikt, zal hun reactie een label "Niet‑geverifieerde reactie" tonen.

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

Dit kan worden geconfigureerd via de widget‑aanpassingsinterface:

Anoneme reacties inschakelen

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 een reactie plaatsen of stemmen, en ze zijn niet ingelogd, wordt hen gevraagd hun e‑mail en gebruikersnaam op te geven.

In het geval van anoniem reageren, is het soms wenselijk om een standaardgebruikersnaam te definiëren om de wrijving bij het reageren te verminderen. Dit kan worden gedaan via de aanpassings‑UI. Anoniem reageren moet eerst worden ingeschakeld.

Instellen van de standaardgebruikersnaam

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.

By default, FastComments does not limit languages used to comment.

It may be desirable to limit the languages a community uses.

This can be configured without code, on the widget customization page:

Toegestane talen

The system will parse their comment and determine its language, and then match it with the allowed list.

If the comment is written in a language that is not allowed, then a localized error message is shown.

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

By default, users can delete their own comments. Also, deleting their comment automatically
deletes all child and transient comments in the thread. This behavior is also live.

You can restrict this in the following ways:

• Instead, anonymize the deleted comment (set name and text to [deleted] or a custom value).
• Don't allow deleting comments when there are replies. A customizable error message is shown.
• Restrict deleting when a comment has replies to only administrators and moderators.

This can be configured via the Comment Thread Deletion section in the Widget Customization UI.

Pas het verwijdergedrag aan voor antwoorden

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.