Customizations & Configuration

Aanpassingen en Configuratie

Context

Hier vindt u diepgaande documentatie over elk van de functies en instellingen die de commentaarwidget ondersteunt.

Deze documentatie behandelt kernconcepten en gaat diep in op elk functioneel gebied, met handleidingen en veelvoorkomende valkuilen.

Codevoorbeelden worden verstrekt, met relevante regels gemarkeerd. Schermafbeeldingen van configuratiepagina's worden waar van toepassing opgenomen.

De codevoorbeelden gebruiken onze vanilla JavaScript-bibliotheek, maar de configuratieopties gebruiken exact dezelfde namen voor alle versies van de commentaarwidget (React, Vue, enz.).

De meeste configuraties en functies die in deze handleiding worden beschreven vereisen geen code te schrijven.

Uw account identificeren

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

Demo Tenant ID

Copy

Run

<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>
<div id="fastcomments-widget"></div>
<script>
window.fcConfigs = [{
    "tenantId": "demo"
}];
</script>

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

<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>
<div id="fastcomments-widget"></div>
<script>
window.fcConfigs = [{
    "tenantId": "aKa2Z4Q="
}];
</script>

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).

Hoe opmerkingen aan pagina's en artikelen worden gekoppeld

Wanneer een reactiedraad wordt weergegeven, of wanneer een reactie wordt geplaatst, moet FastComments weten op welke pagina, artikel of product die reacties betrekking hebben.

Om dit te doen gebruiken we iets dat we de "URL ID" noemen. Het is ofwel een identificator, zoals een string of een getal, of een URL.

Standaard, als je de urlId niet specificeert, wordt deze de pagina-URL. We zullen de huidige pagina-URL nemen en deze opschonen om veelvoorkomende marketingparameters of trackingidentifiers te verwijderen.

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

Defining a Custom URL ID

Copy

Run

<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>
<div id="fastcomments-widget"></div>
<script>
window.fcConfigs = [{
    "tenantId": "demo",
    "urlId": "https://example.com/page"
}];
</script>

Eén ding waar we vaak naar verwijzen in dit document is de UI voor widgetaanpassing.

Met deze UI kun je veel wijzigingen aanbrengen in de reactie-widget 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 het comment-widget op een specifieke pagina aanpassen, bijvoorbeeld om aangepaste styling toe te passen, of misschien om reacties voor die specifieke pagina anoniem te maken. Je zou ook, bijvoorbeeld, live reacties direct op sommige pagina's kunnen laten verschijnen, terwijl je ze op andere pagina's onder notificatieknoppen verbergt.

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

URL ID Input in The Widget Customization Page

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

As of 2023 the URL ID field in widget customization now also takes patterns! For example you may have */blog/* to add styling specific to your blog and */store/* to have styling specific to your store, all while using the same domain.

Valkuilen

Als je pagina hashparameters heeft (zoals example.com#page-1) - wordt dit standaard onderdeel van de URL ID.
Tijdens migraties, bijvoorbeeld van WordPress naar Gatsby, moet je mogelijk de URL ID-waarden van reacties migreren na de initiële migratie. Neem daarvoor contact met ons op.

Dezelfde opmerkingen op verschillende pagina's weergeven

Omdat de parameter urlId ons in staat stelt te bepalen aan welke pagina of id de reacties zijn gekoppeld, kunnen we urlId gewoon op dezelfde waarde zetten op die pagina's.

The Same Comments on Multiple Pages

Copy

Run

<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>
<div id="fastcomments-widget"></div>
<script>
window.fcConfigs = [{
    "tenantId": "demo",
    "urlId": "https://example.com/source-page"
}];
</script>

Aangepaste opmaak

FastComments is ontworpen om aangepast te worden. De commentaar-widget 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 het gebruik van de widget-aanpassingspagina.

In de widget-aanpassingspagina, zie de sectie "Geavanceerde opties weergeven", waaronder een gebied is met het label "Aangepaste CSS":

Custom CSS Input Area

Deze aanpak heeft enkele voordelen:

De ingevoerde CSS wordt geminificeerd voordat deze naar de gebruiker wordt gestuurd, en de opmaak blijft consistent in de bewerkings-UI.
Je krijgt alle voordelen van de widget-aanpassings-UI, bijvoorbeeld het eenvoudig anders aanpassen van de commentaar-widget voor verschillende sites.
Wanneer we wijzigingen aan de commentaar-widget doorvoeren, wordt je aangepaste styling getest als onderdeel van ons releaseproces.

De tweede benadering is het opgeven van de customCSS parameter in de widgetconfiguratie, als volgt:

Passing Custom CSS

Copy

Run

<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>
<div id="fastcomments-widget"></div>
<script>
window.fcConfigs = [{
    "tenantId": "demo",
    "customCSS": "button { background: red; }"
}];
</script>

Dit heeft echter beperkingen:

Er is een limiet aan hoeveel custom CSS er kan worden doorgegeven voordat onze servers het verzoek afwijzen, vanwege de grootte van de headers.
Je moet de custom CSS beheren in je eigen infrastructuur en build-systeem. Dit kan net zo goed een voordeel als een nadeel zijn.
Er is extra overhead doordat de custom CSS in dit geval twee keer over het netwerk wordt verzonden: eerst naar onze servers en vervolgens terug in de iframe-inhoud. Voor de meeste payloadgroottes is dit echter niet merkbaar.
Een veelgebruikte optimalisatie is het minificeren van de CSS om de netwerkgrootte te verkleinen; bij deze aanpak moet je dat echter zelf afhandelen.
Je custom CSS wordt niet getest wanneer wij wijzigingen doorvoeren.

Externe CSS-bestanden

Je kunt de widget instrueren om een extern bestand op te halen met @import!

Het is aan te raden om de @import in een aanpassingsregel te plaatsen. Op deze manier, als we ooit een wijziging aan de commentaar-widget moeten doorvoeren, kunnen we onze automatiseringstools gebruiken om je setup te verifiëren. Dus bijvoorbeeld zou je een aanpassingsregel aanmaken in de Widget-aanpassings-UI, op Advanced klikken, en bij Custom CSS invoeren:

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

In Code - Niet aanbevolen

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

External CSS File

Copy

Run

<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>
<div id="fastcomments-widget"></div>
<script>
window.fcConfigs = [{
    "tenantId": "demo",
    "customCSS": "@import url(https://example.com/styles.css);"
}];
</script>

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

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

Bijvoorbeeld:

User Profile CSS

Copy

Run

<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>
<div id="fastcomments-widget"></div>
<script>
window.fcConfigs = [{
    "tenantId": "demo",
    "customCSS": ".user-profile .profile-name { color: blue; }"
}];
</script>

Achterwaartse compatibiliteit

Bij FastComments weten we dat onze klanten de commentaar-widget aanpassen. Dat is met opzet zo - het laatste wat we willen is dat ons product ontwerpinconsistenties in jouw product veroorzaakt.

Omdat dit een belangrijk onderdeel van ons product is, hebben we een build-pijplijn waarmee we wijzigingen aan de commentaar-widget per klant bij elke release kunnen beoordelen.

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, kunnen we de release stilleggen.

Aangepaste lettertypen

FastComments is ontworpen om aangepast te worden, en het lettertype dat onze widgets gebruiken is daarop geen uitzondering.

Standaard gebruikt FastComments de system font stack zodat het er op een breed scala aan apparaten zo goed mogelijk uitziet.

Om je eigen lettertypen te definiëren, zie de Documentatie voor Aangepaste CSS.

Daar vind je een manier om aangepaste CSS te definiëren, waarmee je de gewenste lettertypen kunt instellen.

Hoe het lettertype te definiëren

Om het lettertype te overschrijven raden we aan je CSS te definiëren met de .fast-comments, textarea selectors. Bijvoorbeeld:

Voorbeeld van aangepast extern lettertype

Copy

Run

@import url('https://fonts.googleapis.com/css2?family=Roboto:wght@300&display=swap');
.fast-comments, textarea {
    font-family: 'Roboto', sans-serif;
}

Branding verwijderen

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.

Ondersteuning voor donkere achtergronden (donkere modus)

Standaard detecteert de FastComments comment widget automatisch de donkere modus op de meeste sites.

Wanneer de donkere modus wordt gedetecteerd, schakelt FastComments over van zwarte tekst op witte achtergronden naar witte tekst op een zwarte achtergrond. Afbeeldingen zullen ook veranderen.

Bij het laden van de pagina zal de widget proberen te bepalen hoe donker de achtergrond van de pagina is achter de comment widget. Dit betekent dat de pagina een witte achtergrond kan hebben, maar als u de comment widget in een container met een zwarte achtergrond plaatst, zou de donkere modus nog steeds automatisch ingeschakeld moeten worden om de reacties leesbaar te maken.

Echter, het detectiemechanisme, dat afhankelijk is van het bepalen van de "luminantie", schakelt mogelijk de donkere modus niet in wanneer u dat wilt. Om deze geforceerd in te schakelen, zet de hasDarkBackground vlag op true als volgt:

Force Dark Background Mode

Copy

Run

<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>
<div id="fastcomments-widget"></div>
<script>
window.fcConfigs = [{
    "tenantId": "demo",
    "hasDarkBackground": true
}];
</script>

Donkere modus in-/uitschakelen

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

<script src="https://fastcomments.com/js/embed-v2.min.js"></script>
<button id="toggle-dark-mode">Toggle Dark Mode</button>
<div id="fastcomments-widget"></div>
<script>
    (function() {
        const button = document.getElementById('toggle-dark-mode');
        const config = {
            tenantId: 'demo',
            hasDarkBackground: false
        };
        const instance = window.FastCommentsUI(document.getElementById('fastcomments-widget'), config);
        button.addEventListener('click', function() {
            config.hasDarkBackground = !config.hasDarkBackground;
            if (config.hasDarkBackground) {
                document.body.classList.add('dark');
            } else {
                document.body.classList.remove('dark');
            }
            instance.update(config);
        });
    })();
</script>
<style>
    body.dark {
        background: #000;
        color: #fff;
    }
</style>

Tekst overschrijven

Met FastComments is alle tekst in de reactie-widget aanpasbaar.

U kunt één tekstonderdeel overschrijven, zoals de verzendknop, of alle tekst in de hele reactie-widget.

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

Custom Text

Copy

Run

<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>
<div id="fastcomments-widget"></div>
<script>
window.fcConfigs = [{
    "tenantId": "demo",
    "translations": {
        "SUBMIT_REPLY": "Reply"
    }
}];
</script>

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

Er is echter een gemakkelijkere manier via de widget-aanpassingsinterface. Daar kunnen we eenvoudig de tekst vinden die in de reactie-widget wordt weergegeven in de EN_US-locale, en een vervanging opgeven.

Custom Text

Alle overschrijvingen van vertalingen gelden momenteel voor alle locales.

De standaardavatar wijzigen

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

Als we echter geen avatar vinden, of de gebruiker er nooit een in zijn/haar account instelt, tonen we een statische standaardavatar-afbeelding.

Om uw eigen statische avatar-afbeelding op te geven, kunt u de defaultAvatarSrc-instelling gebruiken.

Override The Default Avatar

Copy

Run

<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>
<div id="fastcomments-widget"></div>
<script>
window.fcConfigs = [{
    "tenantId": "demo",
    "defaultAvatarSrc": "https://example.com/some-image.png"
}];
</script>

Dit kan ook zonder code. Op de pagina voor widget-aanpassing, zie de "Standaardavatar" sectie.

Customizing The Default Avatar

Houd er rekening mee dat het definiëren van de avatar voor een specifieke gebruiker, zoals bij SSO, in een aparte sectie wordt behandeld.

Avatars uitschakelen

Avatars kunnen volledig uit de reactie-widget worden verwijderd, zelfs als gebruikers hun eigen avatar hebben ingesteld.

Hiding Avatars

Copy

Run

<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>
<div id="fastcomments-widget"></div>
<script>
window.fcConfigs = [{
    "tenantId": "demo",
    "hideAvatars": true
}];
</script>

Dit kan zonder code worden aangepast op de pagina voor het aanpassen van de widget:

Hiding Avatars

Alle standaardstijlen uitschakelen

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, zoals volgt:

Disabling All Default Styles

Copy

Run

<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>
<div id="fastcomments-widget"></div>
<script>
window.fcConfigs = [{
    "tenantId": "demo",
    "noStyles": true
}];
</script>

Dit kan zonder code worden aangepast op de pagina voor widgetaanpassing, onder Geavanceerde opties:

Disabling All Default Styles

Linken van opmerkingen naar pagina's

Bij het verzenden van notificatie-e-mails, of het weergeven van opmerkingen in gebruikersinterfaces zoals de moderatiepagina, is het handig om een link te kunnen maken van de opmerking naar de pagina waarop deze staat.

Als URL-ID niet altijd een ID is, moeten we de URL ergens anders opslaan. Daar is de "url" eigenschap voor, gedefinieerd als volgt.

Defining a Custom URL

Copy

Run

<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>
<div id="fastcomments-widget"></div>
<script>
window.fcConfigs = [{
    "tenantId": "demo",
    "url": "https://example.com/article-5"
}];
</script>

Een veelvoorkomend gebruik is het koppelen van de reactiedraad aan een identificator, zoals een artikel, en vervolgens teruglinken naar een specifieke pagina, bijvoorbeeld:

Defining Custom URL and URL IDs together

Copy

Run

<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>
<div id="fastcomments-widget"></div>
<script>
window.fcConfigs = [{
    "tenantId": "demo",
    "url": "https://example.com/article-5",
    "urlId": "article-5"
}];
</script>

De URL wordt niet opgeschoond van gebruikelijke marketingparameters. Standaard wordt, wat de huidige pagina-URL ook is, die URL met de opmerking opgeslagen.

Antwoorden standaard inklappen

Standaard worden antwoorden op opmerkingen op hoofdniveau weergegeven.

Dit kan zo worden geconfigureerd dat de gebruiker op "Toon antwoorden" bij de opmerkingen op hoofdniveau moet klikken om de onderliggende reacties te zien.

Collapse Replies to Top Level Comments

Copy

Run

<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>
<div id="fastcomments-widget"></div>
<script>
window.fcConfigs = [{
    "tenantId": "demo",
    "collapseReplies": true
}];
</script>

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

Collapse Replies

Deze instelling heeft geen invloed op het aantal opmerkingen op hoofdniveau dat aanvankelijk wordt geladen. Als u één opmerking op hoofdniveau en 29 kinderen heeft, ziet u met deze instelling:

Ziet de opmerking op hoofdniveau.
Ziet 'Toon antwoorden (29)' onder deze opmerking.

Als u alle opmerkingen op hoofdniveau wilt weergeven in combinatie met deze optie, stel de startpagina in op -1.

WYSIWYG inschakelen

Standaard worden de opmaakfunctionaliteiten in FastComments uitgevoerd door zichtbare anker-tags zoals <b></b> om uw tekst heen toe te voegen. Door op de werkbalk te klikken of sneltoetsen te gebruiken, gebeurt dit automatisch voor u. Sommige gemeenschappen willen echter mogelijk kiezen voor opmaak zonder zichtbare anker-tags. Dit wordt het inschakelen van de WYSIWYG (wat je ziet is wat je krijgt) editor genoemd. Deze editor ziet er precies hetzelfde uit als de standaardeditor, behalve dat er extra code wordt geladen waarmee gebruikers hun tekst vet, onderstreept, enz. kunnen opmaken zonder zichtbare anker-tags.

Enabling WYSIWYG Editing

Copy

Run

<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>
<div id="fastcomments-widget"></div>
<script>
window.fcConfigs = [{
    "tenantId": "demo",
    "enableWYSIWYG": true
}];
</script>

Dit kan ook zonder code worden gedaan. Op de pagina voor het aanpassen van de widget, zie de optie "Enable Advanced Formatting".

Enable WYSIWYG

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

Deze werkbalk kan uitgeschakeld worden in de code of via de aanpassingsinterface.

Dit kan ook zonder code worden gedaan. Op de widget-aanpassingspagina, zie de optie "Schakel de antwoordwerkbalk uit".

Disabling The Toolbar

Blokkeren uitschakelen

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

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

Disable Blocking

Copy

Run

<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>
<div id="fastcomments-widget"></div>
<script>
window.fcConfigs = [{
    "tenantId": "demo",
    "disableBlocking": true
}];
</script>

Dit kan ook zonder code worden gedaan, wat ook zorgt voor correcte validatie aan de serverzijde, via de Widget-aanpassingsinterface:

Disable Blocking

Bepalen welke pagina wordt weergegeven

Wanneer opmerkingen worden opgehaald en weergegeven, moet de reactie-widget weten op welke pagina deze moet beginnen. Standaard begint deze met de eerste pagina en geeft alleen die pagina weer.

Indien gewenst kan de exacte pagina die weergegeven moet worden aan de reactie-widget worden doorgegeven als instelling startingPage.

Specifying The Page to Render

Copy

Run

<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>
<div id="fastcomments-widget"></div>
<script>
window.fcConfigs = [{
    "tenantId": "demo",
    "startingPage": 1
}];
</script>

Houd er rekening mee dat paginanummers vanaf nul beginnen, dus het bovenstaande voorbeeld geeft de tweede pagina weer.

Opmerkingendraden wisselen zonder de pagina te herladen

We hebben uitgelegd hoe urlId het pagina- of artikel-id is waaraan de reacties gekoppeld zijn.

Ter herinnering: als deze niet is gedefinieerd, zal urlId standaard de URL van de huidige pagina zijn.

Hoe zit het met SPA's, of Single-Page Applications, waarbij de pagina of inhoud waaraan de reacties zijn gekoppeld dynamisch verandert zonder de pagina opnieuw te laden?

Angular, React, Vue, enz.

Met onze bibliotheken zoals Angular en React zal het bijwerken van de urlId-eigenschap die aan de widget wordt doorgegeven ervoor zorgen dat de reactie-widget wordt vernieuwd. Je kunt dit in actie zien voor de React-app, bijvoorbeeld hier.

VanillaJS

Als je de VanillaJS-bibliotheek gebruikt, is het iets ingewikkelder omdat er geen framework zoals Angular of React is om de datakoppeling of toestandspropagatie af te handelen.

Wanneer je de VanillaJS-widget instancieert, geeft deze enkele functies terug die kunnen worden aangeroepen om hem bij te werken.

Hier is een functioneel voorbeeld waarin we de pagina-hash wijzigen en de reactie-widget bijwerken:

Voorbeeld: Pagina-hash wijzigen

Copy

Run

<script src="https://cdn.fastcomments.com/js/embed-v2.min.js"></script>
<button id="change-page"></button>
<div id="fastcomments-widget"></div>
<script>
    (function fastCommentsMain() {
        let config = {
            tenantId: 'demo'
        };
        let instance = window.FastCommentsUI(document.getElementById('fastcomments-widget'), config);
        let page = '#page-1';
        function getNextPage() {
            if (page === '#page-1') {
                return '#page-2';
            } else {
                return '#page-1';
            }
        }
        let button = document.getElementById('change-page');
        function nextPage() {
            page = getNextPage();
            button.innerText = 'Go to ' + getNextPage();
            window.location.hash = page;
            let locationString = window.location.toString();
            config.url = locationString; // We werken de url ook bij, zodat meldingen naar de juiste pagina kunnen linken
            config.urlId = locationString;
            instance.update(config);
        }
        nextPage();
        button.addEventListener('click', nextPage);
    })();
</script>

Absolute datums (mensenleesbare tijdstempels uitschakelen)

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

Het kan nodig of wenselijk zijn absolute datums te gebruiken; in dat geval zet je deze parameter op true.

Use Absolute Dates

Copy

Run

<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>
<div id="fastcomments-widget"></div>
<script>
window.fcConfigs = [{
    "tenantId": "demo",
    "absoluteDates": true
}];
</script>

Dit kan zonder code aangepast worden op de pagina voor het aanpassen van de widget, onder Geavanceerde opties:

Use Absolute Dates

Zowel absolute als relatieve datums weergeven

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

Het kan nodig of wenselijk zijn om dit relatieve datumformaat te behouden, maar daarnaast ook de volledige datum te tonen; in dat geval stelt u deze parameter in op true.

Use Both Absolute and Relative Dates

Copy

Run

<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>
<div id="fastcomments-widget"></div>
<script>
window.fcConfigs = [{
    "tenantId": "demo",
    "absoluteAndRelativeDates": true
}];
</script>

Dit kan zonder code worden aangepast op de pagina voor het aanpassen van de widget, onder Geavanceerde opties. U moet eerst Absolute Dates inschakelen om deze optie in de UI te zien.

Use Both Absolute and Relative Dates

Koptekst toevoegen

Tekst, zoals een koptekst of bericht, kan onder het aantal reacties maar boven de tekst met de aanmeldingsstatus worden weergegeven.

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

Specifying Header HTML

Copy

Run

<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>
<div id="fastcomments-widget"></div>
<script>
window.fcConfigs = [{
    "tenantId": "demo",
    "headerHTML": "<h1>Leave a Comment!</h1>"
}];
</script>

Dit kan zonder code worden aangepast op de pagina voor widget-aanpassing, onder Geavanceerde opties:

Specifying Header HTML

Links als tekst weergeven

Standaard rendert FastComments links als volgt: https://exmaple.com - waarbij de link-URL een klikbare HTML anchor-tag wordt.

Sommige sites willen dit mogelijk uitschakelen, bijvoorbeeld om oplichters af te schrikken. Dit kan worden ingesteld door de Comment HTML Rendering Option op Links as Text te zetten.

Dit kan zonder code worden aangepast, op de pagina voor het aanpassen van de widget, voor een heel domein of een pagina:

Render Links as Text

Opmerkingen met een knop in-/uitschakelen

Standaard rendert FastComments het invoerveld voor opmerkingen en de opmerkingen-thread tegelijkertijd. Om wat verticale ruimte te besparen, verbergt het ook andere vereiste velden totdat er interactie met de widget is.

De reacties-widget kan echter achter een knop worden verborgen, bijvoorbeeld:

Click to Show Comments

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

Click to Show or Hide Comments

Copy

Run

<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>
<div id="fastcomments-widget"></div>
<script>
window.fcConfigs = [{
    "tenantId": "demo",
    "useShowCommentsToggle": true
}];
</script>

Dit is ontworpen ter vervanging van de hideCommentsUnderCountTextFormat-configuratie.

De telling wordt live bijgewerkt met de opmerkingen-thread. De knop wordt niet weergegeven als er geen opmerkingen zijn.

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

Enable Click to Show Comments

Tekst voor aantal opmerkingen aanpassen

Het aantal reacties dat bovenaan de reactie-widget wordt weergegeven, kan worden aangepast.

Dit kan worden vervangen door elke tekst, en de waarde [count] wordt vervangen door het aantal, gelokaliseerd voor de gebruiker.

Customizing The Comment Count Text

Copy

Run

<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>
<div id="fastcomments-widget"></div>
<script>
window.fcConfigs = [{
    "tenantId": "demo",
    "commentCountFormat": "There are [count] comments."
}];
</script>

Dit kan zonder code worden aangepast op de pagina voor het aanpassen van de widget:

Customizing The Comment Count Text

Afbeeldingsomleiding uitschakelen

Standaard staat FastComments gebruikers toe afbeeldingen te uploaden. Wanneer een gebruiker op die afbeelding klikt, opent FastComments standaard, een nieuw tabblad om die afbeelding volledig weer te geven. Het instellen van deze vlag op true schakelt dit gedrag uit:

Disable Image Redirect

Copy

Run

<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>
<div id="fastcomments-widget"></div>
<script>
window.fcConfigs = [{
    "tenantId": "demo",
    "disableImageRedirect": true
}];
</script>

Als u niet van plan bent de klik op de afbeelding zelf af te handelen (zie onImageClicked), raden we aan dit te combineren met wat styling om te voorkomen dat het lijkt alsof de afbeelding aangeklikt kan worden.

Automatisch aanmaken van hashtags uitschakelen

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

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

Om dit te doen, schakel eenvoudig Disable Automatic #hashtag Creation in via de Widget-aanpassingsinterface.

Disabling Automatic HashTag Creation

Meldingsbel uitschakelen

Standaard toont FastComments een notificatiebel rechtsboven in het reactiegebied.

Deze bel wordt rood en toont een teller met het aantal meldingen dat de gebruiker heeft. Enkele voorbeelden van meldingen zijn:

Een gebruiker heeft op je gereageerd.
Een gebruiker heeft gereageerd in een thread waarop jij hebt gereageerd.
Een gebruiker heeft je reactie omhoog gestemd.
Een gebruiker heeft gereageerd op een pagina waarop je geabonneerd bent.

De notificatiebel biedt ook de mogelijkheid om je op een gehele pagina te abonneren.

We kunnen de notificatiebel echter volledig uitschakelen:

Disable Notification Bell

Copy

Run

<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>
<div id="fastcomments-widget"></div>
<script>
window.fcConfigs = [{
    "tenantId": "demo",
    "disableNotificationBell": true
}];
</script>

Dit kan ook zonder code worden gedaan. Op de pagina voor widget-aanpassing, zie de sectie "Notificatiebel uitschakelen".

Disable Notification Bell

Profielen uitschakelen

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

We kunnen deze functionaliteit echter uitschakelen:

Disable Profiles

Copy

Run

<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>
<div id="fastcomments-widget"></div>
<script>
window.fcConfigs = [{
    "tenantId": "demo",
    "disableProfiles": true
}];
</script>

Dit kan ook zonder code. Op de pagina voor het aanpassen van de widget, zie de sectie "Profielen uitschakelen".

Disable Profiles

Succesbericht uitschakelen

Standaard toont FastComments een succesmelding nadat er een reactie is geplaatst. Dit kan als volgt worden uitgeschakeld:

Disable Success Message

Copy

Run

<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>
<div id="fastcomments-widget"></div>
<script>
window.fcConfigs = [{
    "tenantId": "demo",
    "disableSuccessMessage": true
}];
</script>

Dit kan ook zonder code worden gedaan. Op de pagina voor het aanpassen van de widget:

Disable Success Message

Inhoudsclassificatie van GIF's wijzigen

Standaard zal de FastComments-reactie-widget een gif rating instellen op pg.

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

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

Set Gif Rating

Copy

Run

<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>
<div id="fastcomments-widget"></div>
<script>
window.fcConfigs = [{
    "tenantId": "demo",
    "gifRating": "pg-13"
}];
</script>

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

Setting The Gif Rating

Moderatie van afbeeldingsinhoud

Standaard staat de moderatie van afbeeldingsinhoud van de FastComments-reactie-widget op off.

Beschikbare opties zijn off, low, medium en high.

In de widget-aanpassingsinterface vind je dit onder Image Content Moderation Level zolang Disable Image Uploads? niet is aangevinkt.

Setting The Image Content Moderation Level

Stemstijl wijzigen

Standaard zal FastComments stemopties weergeven als omhoog- en omlaag-pijlen, waarmee gebruikers een opmerking omhoog of omlaag kunnen stemmen.

Het is echter mogelijk om de stijl van de stemwerkbalk te veranderen. De huidige opties zijn de standaard omhoog/omlaag-knoppen, of het gebruik van een hartstijl stemsysteem.

We gebruiken de vlag voteStyle als volgt:

Enable Heart Button

Copy

Run

<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>
<div id="fastcomments-widget"></div>
<script>
window.fcConfigs = [{
    "tenantId": "demo",
    "voteStyle": 1
}];
</script>

We raden ten zeerste aan dit zonder code te doen, omdat dit ook server-side validaties inschakelt. Zie op de pagina voor widget-aanpassing de sectie "Stemstijl".

Change Voting Style

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

Verwijderen uitschakelen

Standaard staat FastComments gebruikers toe hun reacties te verwijderen.

Het is echter mogelijk dit te voorkomen.

Op de pagina voor het aanpassen van de widget, zie de "Disable Deleting" optie.

Disable Comment Deleting

Dit heeft alleen invloed op gewone Commenters en niet op moderators of admins, die nog steeds kunnen verwijderen.
Dit heeft ook invloed op API-integraties wanneer contextUserId wordt doorgegeven.

Bewerken uitschakelen

Standaard staat FastComments gebruikers toe hun reacties te bewerken.

Het is echter mogelijk dit te voorkomen.

Op de pagina voor het aanpassen van de widget, zie de optie "Bewerken uitschakelen".

Disable Comment Editing

Dit heeft alleen invloed op gewone reageerders en niet op moderatoren of admins, die nog steeds kunnen bewerken.
Dit heeft ook invloed op API-integraties wanneer contextUserId wordt meegegeven.

Nieuwe opmerkingen markeren

FastComments biedt verschillende manieren om nieuwe reacties te markeren.

Allereerst, standaard worden reacties die een in-app melding veroorzaakten (antwoorden, antwoorden in dezelfde thread, of reacties op een pagina waarop je bent geabonneerd), automatisch gemarkeerd door de avatar van de gebruiker licht te laten gloeien. De kleur kan via CSS aangepast worden met de is-unread klasse.

Reacties die in de laatste 24 uur zijn geplaatst hebben de 24hr klasse toegepast die gebruikt kan worden voor styling.

Tot slot worden nieuwe live reacties die in de sessie van de gebruiker verschijnen enkele seconden gemarkeerd met een animatie. Dit gebeurt via de is-live CSS-klasse en kan ook aangepast worden.

Paginagrootten

Standaard is de paginagrootte van FastComments 30. Dit omvat reacties in discussiedraden.

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

Houd er rekening mee dat het wijzigen van de paginagrootte vereist dat alle commentaardraden in uw account opnieuw worden berekend. Dit kan een paar minuten duren.

Dit kan niet in de client-side widget worden ingesteld, omdat pagina's aan de serverzijde worden berekend.

Een voorbeeldconfiguratie wordt hieronder weergegeven:

Custom Page Sizes

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

Dit heeft invloed op alle clients, integraties en frameworks die u mogelijk gebruikt om reacties via ons platform weer te geven.

E-mailsjablonen

E-mails die door FastComments naar uw klanten worden verzonden, kunnen worden aangepast. De sjabloon, logica, en vertalingen kunnen allemaal worden gewijzigd. Tekst kan per-locale worden aangepast, en de opmaak kan zelfs per-domein worden gewijzigd. Meer informatie over aangepaste e-mailsjablonen vindt u hier.

Gebruikersnaamformaten

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, wilt u misschien alleen "Allen R." tonen.

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

Change Name Format

De beschikbare formaten zijn:

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

De wijziging is onmiddellijk van kracht. Gebruikers zullen hun volledige gebruikersnaam nog steeds boven het opmerkingengebied voor zichzelf zien, maar bij hun opmerkingen wordt de gewijzigde gebruikersnaam weergegeven.

Gebruikersnamen worden aan de serverzijde gemaskeerd om gebruikers te beschermen.

Afbeeldingsuploads uitschakelen

Standaard staat FastComments het uploaden van afbeeldingen toe. Dit kan worden uitgeschakeld door de vlag noImageUploads op true te zetten.

Disabling Image Uploads

Copy

Run

<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>
<div id="fastcomments-widget"></div>
<script>
window.fcConfigs = [{
    "tenantId": "demo",
    "noImageUploads": true
}];
</script>

Dit kan zonder code worden aangepast op de pagina voor het aanpassen van de widget:

Disabling Image Uploads

Zoekvak inschakelen

Standaard wordt er geen zoekvak weergegeven in de commentaarwidget.

Dit kan echter worden ingeschakeld door de vlag enableSearch op true te zetten:

Enabling Search

Copy

Run

<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>
<div id="fastcomments-widget"></div>
<script>
window.fcConfigs = [{
    "tenantId": "demo",
    "enableSearch": true
}];
</script>

Dit kan ook zonder code worden gedaan. Op de pagina voor het aanpassen van de widget, zie de optie "Enable Search Box".

Enable Search Box

Spoilers inschakelen

We kunnen ondersteuning voor spoilers inschakelen door de vlag enableSpoilers op true te zetten:

Enabling Spoilers

Copy

Run

<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>
<div id="fastcomments-widget"></div>
<script>
window.fcConfigs = [{
    "tenantId": "demo",
    "enableSpoilers": true
}];
</script>

Dit kan ook zonder code worden gedaan. Op de pagina voor widget-aanpassing, zie de "Enable Spoilers" optie.

Enable Spoilers

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

Dit is ook compatibel met de WYSIWYG editor.

Weergaveaantallen van opmerkingen inschakelen

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

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

Wanneer dit gebeurt, wordt een teller naast een oogpictogram bij elke reactie verhoogd. De teller wordt live bijgewerkt en afgekort volgens de lokale instellingen van de gebruiker.

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

Enabling Comment View Counts

Copy

Run

<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>
<div id="fastcomments-widget"></div>
<script>
window.fcConfigs = [{
    "tenantId": "demo",
    "enableViewCounts": true
}];
</script>

Dit kan zonder code worden aangepast op de pagina voor het aanpassen van de widget:

Enabling Comment View Counts

We houden de gebruikers-id* bij die de reactie heeft bekeken, zodat wanneer je de reactie opnieuw bekijkt deze niet wordt verhoogd. Als je de reactie pas na twee jaar opnieuw bekijkt, wordt de teller wél weer verhoogd.

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

Live-opmerkingen direct weergeven

Standaard zijn live reacties ingeschakeld. Dit betekent dat wanneer reacties worden toegevoegd, verwijderd, bewerkt of vastgezet, de wijzigingen moeten verschijnen voor alle gebruikers die de reactiedraad op hetzelfde moment bekijken.

Echter, standaard verschijnen die nieuwe reacties onder een dynamisch weergegeven knop met een tekst zoals "Toon 2 nieuwe reacties".

Als de nieuwe reacties rechtstreeks op de pagina zijn gericht, verschijnt de knop bovenaan de reactiedraad. Als het reacties zijn op een specifieke reactie, verschijnt de knop onder die reactie.

Dit voorkomt dat de paginagrootte voortdurend verandert voor de gebruiker, wat tot frustratie kan leiden bij het proberen de schuifbalk vast te pakken.

Voor sommige gebruikssituaties, zoals live bieden of online evenementen, is dit niet het gewenste gedrag - u wilt misschien dat de reacties-widget meer als een "chat"-vak is waarin nieuwe reacties "direct verschijnen".

Daarom heet de vlag die deze functie inschakelt: showLiveRightAway.

We kunnen het als volgt inschakelen:

Show Live Comments Right Away

Copy

Run

<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>
<div id="fastcomments-widget"></div>
<script>
window.fcConfigs = [{
    "tenantId": "demo",
    "showLiveRightAway": true
}];
</script>

Dit kan zonder code worden aangepast op de pagina voor het aanpassen van de widget:

Show Live Comments Right Away

Live-opmerkingen uitschakelen

Standaard is live reageren in FastComments ingeschakeld.

Dit betekent dat elke kijker van de discussiedraad dezelfde inhoud te zien krijgt.

Bijvoorbeeld, als een opmerking wordt toegevoegd, moet die opmerking zichtbaar zijn. Als een opmerking wordt bewerkt of verwijderd, dan worden die opmerkingen voor alle kijkers van de draad bewerkt of verwijderd. Hetzelfde geldt voor stemmen, en alle moderatie-acties.

We kunnen dit echter uitschakelen:

Disable Live Commenting

Copy

Run

<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>
<div id="fastcomments-widget"></div>
<script>
window.fcConfigs = [{
    "tenantId": "demo",
    "disableLiveCommenting": true
}];
</script>

Dit kan ook zonder code worden gedaan. Ga op de pagina voor het aanpassen van de widget naar de sectie "Live reageren uitschakelen".

Disable Live Commenting

Nieuwe live-opmerkingen onderaan weergeven

Standaard verschijnen nieuwe live-reacties bovenaan de reactielijst zodra ze in realtime worden gepost.

Wanneer deze optie is ingeschakeld, worden nieuwe live-reacties in plaats daarvan onderaan de lijst toegevoegd. Dit beïnvloedt hoe reacties verschijnen wanneer ze live worden gepost terwijl gebruikers de reactiedraad bekijken.

New Live Comments to Bottom

Copy

Run

<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>
<div id="fastcomments-widget"></div>
<script>
window.fcConfigs = [{
    "tenantId": "demo",
    "newCommentsToBottom": true
}];
</script>

Met deze instelling ingeschakeld:

Nieuwe live-reacties geplaatst door andere gebruikers verschijnen onderaan de reactielijst
Gebruikers zien nieuwe reacties in realtime verschijnen onder bestaande reacties
Dit heeft alleen invloed op live-update van reacties - niet op de initiële paginalading
Dit kan helpen de leesstroom te behouden wanneer gebruikers een discussie volgen

Let op dat deze instelling alleen van invloed is op waar nieuwe live-reacties worden geplaatst zodra ze in realtime binnenkomen. Het heeft geen invloed op de initiële sorteervolgorde wanneer de pagina wordt geladen.

Oneindig scrollen inschakelen

Standaard zal de FastComments-widget zichzelf verticaal aanpassen om alle zichtbare reacties te tonen. Paginering wordt bereikt via een "Bekijk volgende" knop aan het einde van de huidige pagina, omdat we hebben vastgesteld dat deze interactie voor de meeste gebruikers het prettigst aanvoelt.

Er zijn echter gevallen waarin oneindig scrollen de voorkeur heeft. Bijvoorbeeld: we gebruiken deze functie in ons Stream Chat-product.

We kunnen de "Bekijk volgende"-knoppen verbergen en overschakelen naar oneindig scrollen door de enableInfiniteScrolling-vlag op true te zetten:

Enabling Infinite Scrolling

Copy

Run

<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>
<div id="fastcomments-widget"></div>
<script>
window.fcConfigs = [{
    "tenantId": "demo",
    "enableInfiniteScrolling": true
}];
</script>

Dit vereist ook het toevoegen van aangepaste CSS. Voeg bijvoorbeeld aangepaste CSS toe voor de .comments-selector om scrollen mogelijk te maken:

Oneindig scrollen inschakelen

Copy

Run

.comments {
    max-height: 500px;
    overflow-y: auto;
}

Een volledig werkend voorbeeld zou zijn:

Enabling Infinite Scrolling

Copy

Run

<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>
<div id="fastcomments-widget"></div>
<script>
window.fcConfigs = [{
    "tenantId": "demo",
    "enableInfiniteScrolling": true,
    "customCSS": ".comments { max-height: 500px;  overflow-y: auto; }"
}];
</script>

In het bovenstaande voorbeeld gebruiken we de customCSS-eigenschap, maar wordt aanbevolen om in plaats daarvan de Widget Configuration UI te gebruiken vanwege prestatieoverwegingen. Zie de documentatie voor Custom CSS.

Standaard sorteervolgorde wijzigen

Standaard sorteert FastComments reacties op basis van de "Most Relevant" sorteerrichting.

De "Most Relevant"-sortering houdt rekening met het tijdstip waarop de reactie is geplaatst en het aantal stemmen bij het sorteren.

De gebruiker kan vervolgens in de comment-widget UI de sorteerrichting wijzigen naar ofwel Oldest of Newest First.

We kunnen de standaardwaarde echter naar elk van de drie wijzigen. Bijvoorbeeld als je de oudste reacties eerst wilt tonen:

Changing The Default Sort To Oldest First

Copy

Run

<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>
<div id="fastcomments-widget"></div>
<script>
window.fcConfigs = [{
    "tenantId": "demo",
    "defaultSortDirection": "OF"
}];
</script>

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

Voor de newest-first sorteerrichting zouden we het volgende doen:

Changing The Default Sort To Newest First

Copy

Run

<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>
<div id="fastcomments-widget"></div>
<script>
window.fcConfigs = [{
    "tenantId": "demo",
    "defaultSortDirection": "NF"
}];
</script>

De geldige waarden voor defaultSortDirection zijn:

MR: "Most Recent"
NF: "Newest First"
OF: "Oldest First"

Dit kan ook zonder code. Op de pagina voor widget‑aanpassing, zie de sectie "Standaard sorteerrichting".

Changing The Default Sort Direction

Let op: de reacties op elke pagina voor elke sorteerrichting worden vooraf berekend, dus alle sorteerrichtingen hebben dezelfde prestaties.

Alle opmerkingen tegelijk weergeven - paginering uitschakelen

Om paginering uit te schakelen en alle reacties in één keer weer te geven, stel startingPage in op -1.

Render All Comments

Copy

Run

<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>
<div id="fastcomments-widget"></div>
<script>
window.fcConfigs = [{
    "tenantId": "demo",
    "startingPage": -1
}];
</script>

Het reactieveld verplaatsen naar na de opmerkingen

Standaard staat het invoerveld voor opmerkingen boven de reactiedraad. Als we deze configuratieparameter op true zetten, kunnen we het echter onder plaatsen.

Moving The Reply Box to The Bottom

Copy

Run

<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>
<div id="fastcomments-widget"></div>
<script>
window.fcConfigs = [{
    "tenantId": "demo",
    "inputAfterComments": true
}];
</script>

Dit kan zonder code worden aangepast op de pagina voor het aanpassen van de widget:

Moving The Reply Box to The Bottom

De maximale lengte van opmerkingen beperken

Het maximale aantal tekens dat in het invoerveld voor opmerkingen mag worden ingevoerd, kan worden beperkt met de maxCommentCharacterLength-parameter.

De standaard is 2000.

Dingen zoals afbeeldings-URL's worden niet meegenomen bij het bepalen van de lengte.

Limit Comment Length

Copy

Run

<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>
<div id="fastcomments-widget"></div>
<script>
window.fcConfigs = [{
    "tenantId": "demo",
    "maxCommentCharacterLength": 500
}];
</script>

Dit kan zonder code worden aangepast op de pagina voor het aanpassen van de widget:

Limit Comment Length

Meerregelige opmerkingen uitschakelen

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

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

We schakelen de useSingleLineCommentInput-vlag als volgt in:

Enable Single-Line Comment Input

Copy

Run

<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>
<div id="fastcomments-widget"></div>
<script>
window.fcConfigs = [{
    "tenantId": "demo",
    "useSingleLineCommentInput": true
}];
</script>

Dit kan ook zonder code worden gedaan. Op de pagina voor het aanpassen van de widget, zie de sectie "Schakel éénregelige reactie-invoer in".

Enable Single-Line Comment Input

Let op dat de reacties op elke pagina voor elke sorteerrichting vooraf worden berekend, zodat alle sorteerrichtingen dezelfde prestaties hebben.

Aantal opmerkingen per gebruiker beperken

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

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

Dit kan zonder code worden aangepast op de pagina voor het aanpassen van de widget:

Limiting Comment Volume Per User

Houd er rekening mee dat als je de comment creation API gebruikt, je mogelijk het oorspronkelijke ip address van de gebruiker wilt meesturen in het verzoek naar onze backend, zodat rate limiting per gebruiker wordt toegepast en niet globaal op je account.

Nieuwe opmerkingen op hoofdniveau voorkomen

Het instellen van noNewRootComments op true zorgt ervoor dat de widget het antwoordveld voor topniveau-opmerkingen verbergt, maar gebruikers toch nog toestaat om te reageren op onderliggende opmerkingen. Je kunt dit bijvoorbeeld bij het laden van de pagina conditioneel instellen, zodat alleen bepaalde gebruikers topniveau-opmerkingen kunnen plaatsen.

Prevent New Root Comments

Copy

Run

<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>
<div id="fastcomments-widget"></div>
<script>
window.fcConfigs = [{
    "tenantId": "demo",
    "noNewRootComments": true
}];
</script>

Maximale antwoorddiepte

Standaard staat FastComments onbeperkte nesteling van antwoorden toe, waardoor er een draadstructuur ontstaat waarin gebruikers oneindig op antwoorden kunnen reageren.

De optie maxReplyDepth stelt je in staat te beperken hoe diep antwoorddraden kunnen worden. Wanneer de maximale diepte is bereikt, zien gebruikers geen antwoordknop meer bij opmerkingen op dat niveau.

Limiting Reply Depth to 2 Levels

Copy

Run

<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>
<div id="fastcomments-widget"></div>
<script>
window.fcConfigs = [{
    "tenantId": "demo",
    "maxReplyDepth": 2
}];
</script>

Met maxReplyDepth ingesteld op 2:

Gebruikers kunnen op het hoogste niveau een reactie plaatsen (diepte 0)
Gebruikers kunnen antwoorden op opmerkingen op het hoogste niveau (diepte 1)
Gebruikers kunnen reageren op die antwoorden (diepte 2)
Geen verdere antwoorden zijn toegestaan voorbij diepte 2

Instellen op 1 zou alleen antwoorden op opmerkingen op het hoogste niveau toestaan, waardoor een plattere discussiestructuur ontstaat.

Het instellen van maxReplyDepth op 0 zou alle antwoorden uitschakelen, waardoor alleen opmerkingen op het hoogste niveau mogelijk zijn. Als het niet is opgegeven, kunnen antwoorden onbeperkt genest worden.

Overzicht Single Sign On (SSO)

SSO, of single sign-on, is een reeks conventies waarmee jij of je gebruikers FastComments kunnen gebruiken zonder een extra account te hoeven aanmaken.

Als je geen anonieme reacties toestaat, is een account vereist om met FastComments te reageren. We maken dit aanmeldproces erg eenvoudig - de gebruiker laat gewoon zijn e-mail achter wanneer hij reageert. We begrijpen echter dat zelfs dat extra frictie kan zijn die sommige sites willen vermijden.

We kunnen die frictie verminderen door slechts één inlogstroom voor je gehele site te gebruiken.

How do I get it?

Alle accounttypen krijgen momenteel toegang tot SSO. Het maximale aantal SSO-gebruikers varieert echter afhankelijk van je pakket. Zoals bij andere functies bieden de Pro-plannen en hoger directe ontwikkelaarsondersteuning.

Laten we de opties vergelijken en daarna de details van elk bespreken.

User and Comment Migrations

Bij migratie vanaf een platform met SSO zoals Disqus heb je al gebruikers en hun reacties.

Reacties worden geïmporteerd als onderdeel van je migratie, hetzij via de API, onze Import UI, of via de klantenservice. De Import UI heeft de voorkeur als het het platform ondersteunt waarvan je migreert, omdat het foutafhandeling, avatar- en media-extractie en uploads, en een batchjob-monitoringssysteem bevat.

De gebruikers zelf worden automatisch toegevoegd bij het voor het eerst bekijken van reactiedraden. Als alternatief kunnen ze vooraf worden toegevoegd via de API, maar dit werk heeft niet veel voordelen.

Als reacties worden geïmporteerd en SSO-gebruikers niet handmatig via de API worden toegevoegd, dan worden reacties automatisch gemigreerd naar het account van de gebruiker de eerste keer dat dat account wordt aangemaakt wanneer ze een reactiedraad bekijken. Ze kunnen dan de reacties die ze oorspronkelijk hebben geschreven beheren, bewerken en verwijderen.

De automatische migratie gebeurt via e-mailadres of gebruikersnaam. Sommige platforms geven bij export geen e-mails, zoals Disqus, dus in dat geval vallen we terug op de gebruikersnaam.

Zolang je een overeenkomende gebruikersnaam doorgeeft, en een e-mail in de SSO-payload, voegen we de e-mail toe aan de individuele reactie-objecten zodat meldingen en vermeldingen werken.

Als je je reacties en gebruikers tegelijk wilt importeren, werk dan samen met support om de reacties naar de respectieve accounts van de gebruikers te migreren nadat gebruikers via de API zijn geïmporteerd.

Samengevat is het gemakkelijkste pad voor de migratie:

Importeer reacties.
1. Avatars en andere media worden automatisch gemigreerd als je de Import UI gebruikt in Manage Data -> Imports.
Stel Secure of Simple SSO in.
Laat de migratie per gebruiker automatisch plaatsvinden wanneer zij voor het eerst inloggen.
1. Dit voegt meestal minder dan een seconde toe aan de laadtijd van de pagina als de gebruiker minder dan 50k reacties heeft.

WordPress Users

Als je onze WordPress-plugin gebruikt, hoef je geen code te schrijven! Ga gewoon naar de adminpagina van de plugin, klik op SSO-instellingen en schakel het in.

Dit brengt je naar een wizard met één klik die je API-sleutel aanmaakt, deze naar je WordPress-installatie stuurt en SSO inschakelt. We hebben dit voor je samengevoegd tot één knop.

Let op: als je de plugin voor de eerste keer installeert, moet je het installatieproces doorlopen voordat je de adminpagina met de knop SSO-instellingen ziet.

WordPress SSO - Moderators

Let erop dat op dit moment, om het "Moderator"-badge naast je moderators te tonen wanneer ze reageren met de FastComments WordPress-plugin, ze ook als Moderator moeten zijn toegevoegd in het FastComments-dashboard en hun e-mailadres geverifieerd moet zijn.

Custom Integrations

Voor aangepaste integraties zijn er twee opties.

Option One - Secure SSO

Met Secure SSO weet FastComments dat de gebruiker die reageert, stemt en reacties leest een echte gebruiker op jouw site is.

Zolang je een geldig payload aanmaakt, zal de gebruiker altijd een naadloze ervaring bij het reageren hebben.

Bij Secure SSO wordt de SSO-payload server-side aangemaakt met HMAC-authenticatie en vervolgens doorgegeven aan de widget op de client.

Bij Secure SSO is het account van de gebruiker volledig gescheiden van de rest van de FastComments-gebruikersbasis. Dit betekent dat als we twee partners hebben Bedrijf A en Bedrijf B, elk een SSO-gebruiker met de gebruikersnaam "Bob" kunnen hebben.

Requirements

Enige basiskennis van backend-ontwikkeling.
Enige basiskennis van het omgaan met geheime API-sleutels.
Enige basiskennis van API-ontwikkeling of server-side rendering.

Pros

Veilig.
Naadloze ervaring bij het reageren.

Cons

Vereist backend-ontwikkeling.

Updating User Data

Bij Secure SSO zullen we elke keer dat je de SSO-gebruikerspayload doorgeeft, hun gebruiker bijwerken met de nieuwste informatie. Bijvoorbeeld, als de gebruiker de gebruikersnaam X heeft, en je geeft Y door in de SSO-payload, zal hun gebruikersnaam Y worden.

Als je waarden wilt verwijderen met deze aanpak, stel ze dan in op null (niet undefined).

Secure SSO API

We bieden ook een API voor interactie met de SSO-gebruikers. Zie the docs.

Let op dat bij gebruik van Secure SSO gebruikers automatisch achter de schermen worden aangemaakt bij het laden van de pagina. Je hoeft je gebruikers niet in bulk te importeren.

Option Two - Simple SSO

Het alternatief voor Secure SSO is simpelweg de gebruikersinformatie naar de reactie-widget te sturen.

Het doorgeven van een e-mail met Simple SSO is niet vereist, maar zonder deze zal hun reactie als "Unverified" worden weergegeven.

^Opmerking! Vanaf begin 2022 hoeven gebruikersnamen bij Simple SSO niet uniek te zijn over heel FastComments.com.

Idealiter kies je Simple SSO alleen bij ontwikkeling op een platform dat geen backend-toegang biedt.

Requirements

Enige basiskennis van client-side ontwikkeling.
Je moet ten minste het e-mailadres van de gebruiker kennen.

Pros

Eenvoudig.
Alle activiteit wordt nog steeds geverifieerd.
De gebruiker voert nooit zijn/haar gebruikersnaam of e-mailadres in.

Cons

Minder veilig dan Secure SSO omdat de client-side payload geconstrueerd zou kunnen worden om zich als elke gebruiker voor te doen.

Simple SSO API

Gebruikers die automatisch worden aangemaakt via de Simple SSO-stroom worden opgeslagen als SSOUser-objecten. Ze kunnen worden benaderd en beheerd via de SSOUser API. Zie the docs.

Aangepaste integraties - veilige Single Sign On (SSO)

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

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

De flow ziet er als volgt uit:

Veilige SSO-stroom

Aangezien Secure SSO full-stack ontwikkeling vereist, staan volledige 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-endpoints te schrijven met 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 kunt u ophalen van deze pagina. U kunt deze pagina ook vinden door naar My Account te gaan, op het API/SSO-tegel te klikken en vervolgens op "Get API Secret Key" te klikken.

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

Laten we wat dieper ingaan op wat deze parameters betekenen.

De comment widget neemt een configuratieobject aan — dit geeft u al door als u FastComments gebruikt om uw customer id (tenantId genoemd) mee te geven.

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

userDataJSONBase64: De gebruikersgegevens in JSON-formaat, die vervolgens Base64-geëncodeerd worden.
verificationHash: De HMAC-SHA256-hash gemaakt van UNIX_TIME_MILLIS + userDataJSONBase64.
timestamp: Epoch-timestamp, in milliseconds. 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 login-knop.
logoutCallback: Wanneer opgegeven in plaats van de logout URL, een functie die de comment widget zal aanroepen bij het klikken op de logout-knop.

Secure SSO Client Code

Copy

<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>
<div id="fastcomments-widget"></div>
<script>
window.fcConfigs = [{
    "tenantId": "demo",
    "sso": {
        "userDataJSONBase64": "...",
        "verificationHash": "...",
        "timestamp": 1768890092139,
        "loginURL": "https://example.com/login",
        "logoutURL": "https://example.com/logout"
    }
}];
</script>

The User Object

Het volgende schema bevat het User-object:

Het Gebruikersobject

Copy

interface SSOUser {
    /** Vereist. Maximaal 1k tekens. **/
    id: string;
    /** Vereist. Maximaal 1k tekens. Opmerking: moet uniek zijn. **/
    email: string;
    /** Vereist. Maximaal 1k tekens. Opmerking: De gebruikersnaam mag geen e-mailadres zijn. Hoeft niet uniek te zijn. **/
    username: string;
    /** Optioneel. Maximaal 3k tekens voor URL's. Standaard is afkomstig van Gravatar op basis van e-mail. Ondersteunt base64-gecodeerde afbeeldingen, in dat geval is de limiet 50k tekens. **/ 
    avatar?: string;
    /** Optioneel. Standaard false. **/
    optedInNotifications?: boolean;
    /** Optioneel. Standaard false. **/
    optedInSubscriptionNotifications?: boolean;
    /** Optioneel. Maximaal 100 tekens. Dit label wordt naast hun naam weergegeven. Standaard is Administrator/Moderator indien van toepassing. **/
    displayLabel?: string;
    /** Optioneel. Maximaal 500 tekens. Dit wordt weergegeven in plaats van de gebruikersnaam. **/
    displayName?: string;
    /** Optioneel. Maximaal 2k tekens. De naam van de gebruiker zal hiernaar linken. **/
    websiteUrl?: string;
    /** Optioneel. Tot 100 groepen per gebruiker. Een groep-id mag niet langer zijn dan 50 tekens. **/
    groupIds?: string[];
    /** Optioneel. Geeft aan dat de gebruiker een administrator is. **/
    isAdmin?: boolean;
    /** Optioneel. Geeft aan dat de gebruiker een moderator is. **/
    isModerator?: boolean;
    /** Optioneel, standaard true. Zet op false om het tabblad "activiteit" in het profiel van de gebruiker in te schakelen. **/
    isProfileActivityPrivate?: boolean;
    /** Optioneel, standaard false. Zet op true om profielreacties uit te schakelen. **/
    isProfileCommentsPrivate?: boolean;
    /** Optioneel, standaard false. Zet op true om directe berichten naar deze gebruiker uit te schakelen. **/
    isProfileDMDisabled?: boolean;
}

Moderators and Administrators

Voor admins en moderators geeft u respectievelijk de isAdmin of isModerator flags door in het SSOUser object.

Notifications

Om meldingen in of uit te schakelen, stelt u de waarde van optedInNotifications 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.

Bovendien, als u wilt dat gebruikers e-mailmeldingen ontvangen voor activiteit op pagina's waarop ze zijn 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 weer te geven, vult u eenvoudig 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 staan 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 supportpagina.

Aangepaste integraties - eenvoudige Single Sign On (SSO)

Met Simple SSO kunnen we de reactie-widget voorzien van informatie over de gebruiker, zodat zij hun gebruikersnaam of e-mailadres niet hoeven in te vullen om te reageren.

We kunnen Simple SSO als volgt configureren:

Eenvoudige SSO

Copy

Run

<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>
<div id="fastcomments-widget"></div>
<script>
window.fcConfigs = [{
    "tenantId": "demo",
    "simpleSSO": {
        "username": "Bob",
        "email": "bob@example.com",
        "avatar": "https://example.com/bob.png",
        "websiteUrl": "https://example.com/profiles/bob",
        "displayName": "Bob's Name",
        "displayLabel": "VIP User",
        "loginURL": "https://example.com/login",
        "logoutURL": "https://example.com/logout",
        "badgeConfig": {
            "badgeIds": [
                "badge-id-1",
                "badge-id-2"
            ],
            "override": false
        }
    }
}];
</script>

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

Notes:

E-mail is de unieke identificatie voor Simple SSO.
Het opgeven van een e-mail bij Simple SSO is niet verplicht, maar standaard worden hun reacties weergegeven als "Niet geverifieerd". Als er geen e-mail wordt opgegeven, kan de gebruiker niet volledig worden geverifieerd.
NEW Sinds jan 2022: gebruikersnamen hoeven niet uniek te zijn over heel fastcomments.com
Simple SSO kan automatisch SSO-gebruikers aanmaken en bijwerken als er een e-mailadres is opgegeven en de gebruiker niet oorspronkelijk via Secure SSO is aangemaakt.
U kunt badges voor de gebruiker specificeren met de badgeConfig property. De badgeIds array bevat de IDs van badges die aan de gebruiker gekoppeld moeten worden. Als override is ingesteld op true, vervangt dit alle bestaande badges die bij reacties worden weergegeven; als false wordt het toegevoegd aan de bestaande badges.

Aangepaste integraties - migratie van Disqus SSO

Het grootste verschil tussen Disqus en FastComments Secure SSO is dat Disqus SHA1 gebruikt voor versleuteling terwijl wij SHA256 gebruiken. Dit betekent dat migreren vanaf Disqus eenvoudig is - wijzig het gebruikte hash-algoritme van SHA1 naar SHA256 en werk de eigenschapsnamen bij die aan de UI worden doorgegeven.

Aangepaste integraties - migratie van Commento SSO

Commento gebruikt een drastisch andere SSO-aanpak - zij vereisen dat u een endpoint heeft dat zij aanroepen om de gebruiker te authenticeren.

FastComments is juist het omgekeerde - codeer en hash eenvoudigweg de gebruikersinformatie met uw geheime sleutel en geef deze door.

Reactiedraden beschermen met Single Sign-On

FastComments SSO (meer informatie) biedt uw gebruikers een manier om te reageren zonder in te hoeven loggen op een ander platform.

Dit alleen beveiligt echter uw reactiedraden niet, aangezien standaard reactiedata openbare informatie is - iedereen die de pagina kan bekijken, kan de reacties zien.

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

No-Code Setup

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

Wanneer u dat doet, zoek naar SSO, en u zult deze optie vinden:

Require SSO To View Comments

Schakel deze in en sla de aanpassingsregel op.

Only Protect a Certain Domain or Page

Om alleen een bepaald domein of pagina te beschermen, configureren we simpelweg de aanpassingsregel daarvoor.

Bovenaan de aanpassings-UI vinden we twee invoervelden, Domain 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 pagina-URL in het veld "URL ID" in. Als u een custom integratie met FastComments heeft, kunt u hier in plaats van een URL een type ID invoeren.

Security Levels

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

De optie voor het beveiligingsniveau zal verschijnen wanneer u "Require SSO To View Comments" selecteert.

Protection Beyond Reading

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

Gotchas

Gebruikers die reacties hebben gemaakt voordat uw SSO-integratie actief was, kunnen deze niet zien, tenzij ze inloggen via uw SSO-integratie.

Anoniem reageren toestaan

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

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

Dit kan worden geconfigureerd via de widget-aanpassings-UI:

Enabling Anonymous Comments

Voorkomen dat anonieme opmerkingen verlopen

FastComments kan zo worden geconfigureerd dat niet-geverifieerde reacties na een gewenst aantal dagen worden verwijderd. Dit helpt spam te bestrijden.

Standaard gebeurt dat niet.

Dit kan worden geconfigureerd, of uitgeschakeld, via de Moderatie-instellingen-pagina.

Moderation Settings

E-mailinvoer uitschakelen

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

Dit creëert een "ongeverifieerde sessie" voor die gebruiker, 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 hun e-mailadres te vragen bij het reageren of stemmen.

Het inschakelen van anoniem reageren maakt het e-mailinvoerveld optioneel. We kunnen het echter volledig uitschakelen. Schakel eerst anoniem reageren in, en vervolgens verschijnt de optie om de e-mailinvoervelden uit te schakelen.

Disable Email Inputs

Als dit is ingeschakeld, worden de e-mailvelden helemaal niet weergegeven in al onze commentaarsystemen.

Let op dat bij deze configuratie alle opmerkingen als niet-geverifieerd worden beschouwd, tenzij de gebruiker een account aanmaakt en inlogt op https://fastcomments.com.

U kunt overwegen het label "niet-geverifieerd" uit te schakelen.

Het label 'onverifieerd' uitschakelen

Standaard toont FastComments een label "Niet-geverifieerde reactie" voor opmerkingen die zijn achtergelaten voor een gebruiker die een niet-geverifieerde browsersessie heeft. Lees meer over niet-geverifieerd reageren hier.

Disable The Unverified Label

Copy

Run

<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>
<div id="fastcomments-widget"></div>
<script>
window.fcConfigs = [{
    "tenantId": "demo",
    "disableUnverifiedLabel": true
}];
</script>

Daarnaast kan deze functie, zonder code te schrijven, worden gebruikt in de Aanpassings-UI:

Disable The Unverified Label

Anonieme stemmen toestaan

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

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

Allow Anonymous Votes

Een standaardgebruikersnaam instellen

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

In het geval van anoniem reageren kan het soms wenselijk zijn een standaardgebruikersnaam te definiëren om de drempel bij het reageren te verlagen. Dit kan worden gedaan via de Customization UI. Anoniem reageren moet eerst worden ingeschakeld.

Setting The Default Username

Callbacks

Alle libraries voor de commentaar-widget (momenteel Angular, React, Vue) ondersteunen callbacks.

De callbacks worden opgegeven in het configuratie-object, met dezelfde signatuur voor elke library.

De ondersteunde callbacks zijn:

onInit
onAuthenticationChange
onRender
commentCountUpdated
onReplySuccess
onVoteSuccess
onImageClicked
onOpenProfile
onCommentSubmitStart
onCommentsRendered

De exacte signaturen zijn te vinden in de TypeScript-definities.

Hier is een voorbeeld waarin alle callbacks worden gebruikt:

Voorbeelden van callbacks

Copy

Run

<script src="https://cdn.fastcomments.com/js/embed-v2.min.js"></script>
<div id="fastcomments-widget"></div>
<script>
    window.FastCommentsUI(document.getElementById('fastcomments-widget'), {
        tenantId: 'demo',
        onInit: function () {
            console.log('Library started to fetch comments!');
        },
        onAuthenticationChange: function (eventName, userObj) {
            console.log('User authenticated!', eventName, userObj);
        },
        onRender: function () {
            console.log('Render event happened!');
        },
        commentCountUpdated: function (newCount) {
            console.log('New comment count:', newCount);
        },
        onReplySuccess: function (comment) {
            console.log('New comment saved!', comment);
        },
        onVoteSuccess: function (comment, voteId, direction, status) {
            console.log('New vote saved!', comment, voteId, direction, status);
        },
        onImageClicked: function (src) {
            console.log('Image clicked!', src);
        },
        onOpenProfile: function (userId) {
            console.log('User tried to open profile', userId);
            // return true; // return true om het standaardgedrag te voorkomen (het openen van het gebruikersprofiel op fastcomments.com).
        },
        onCommentSubmitStart: function(comment, continueSubmitFn, cancelFn) {
            console.log('Trying to submit comment', comment);
            setTimeout(function() { // asynchrone werking emuleren (API-aanroepen enz.).
                if(confirm('Should submit?')) {
                    continueSubmitFn();
                } else {
                    cancelFn('Some optional error message');
                }
            }, 1000);
        },
        onCommentsRendered: function(comments) {
            // comments is gesorteerd volgens de standaard sortering op de pagina, die 'Meest relevant' kan zijn (bijv. meest upvotes, enz.) of 'Nieuwste eerst'
            const topCommentInList = comments[0];
            console.log('First Comment Rendered:', topCommentInList.avatarSrc, topCommentInList.commenterName, topCommentInList.commentHTML);
        }
    });
</script>

De taal-/regio-instelling van de gebruiker handmatig instellen

Standaard zal FastComments de commentaar-widget 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 versturen van e-mails.

Dit beïnvloedt hoe de commentaar-widget voor de gebruiker wordt vertaald. Locale bestaat uit de taal en de 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 The UI

Dit kan worden ingesteld met behulp van de widget-aanpassings-UI. Zie de optie "Locale / Language":

Changing The Locale / Language

Via Code

Dit kan worden overschreven met een gewenste locale.

Manually Defining the User's Locale

Copy

Run

<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>
<div id="fastcomments-widget"></div>
<script>
window.fcConfigs = [{
    "tenantId": "demo",
    "locale": "ru_ru"
}];
</script>

Supported Languages and Locale Codes

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

SSO Note

Als je SSO gebruikt, wil je mogelijk de locale van de gebruiker doorgeven in het user object, zodat e-mails en andere zaken correct voor hen worden gelokaliseerd.

Toegestane talen beperken

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 zonder code worden geconfigureerd op de pagina voor widget-aanpassing:

Toegestane talen

Het systeem analyseert hun reactie en bepaalt de taal, en vergelijkt deze vervolgens met de lijst met toegestane talen.

Als de reactie in een taal is geschreven die niet is toegestaan, wordt er een gelokaliseerde foutmelding weergegeven.

Paginatitels

De huidige paginatitel wordt gekoppeld aan de opgegeven urlId en opgeslagen voor gebruik in moderatiehulpmiddelen.

Standaard wordt dit opgehaald uit document.title.

Indien gewenst, kunt u uw eigen paginatitel als volgt opgeven:

Specifying The Page Title

Copy

Run

<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>
<div id="fastcomments-widget"></div>
<script>
window.fcConfigs = [{
    "tenantId": "demo",
    "pageTitle": "Article 42"
}];
</script>

Nieuwe reacties voorkomen en stemmen uitschakelen

Het plaatsen van reacties kan worden vergrendeld zodat er geen nieuwe reacties of stemmen geplaatst kunnen worden door de readonly-vlag op true te zetten.

Reacties kunnen ook niet worden bewerkt of verwijderd.

Making The Comment Thread Readonly

Copy

Run

<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>
<div id="fastcomments-widget"></div>
<script>
window.fcConfigs = [{
    "tenantId": "demo",
    "readonly": true
}];
</script>

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

Making The Comment Thread Readonly

Bijgewerkt!

Vanaf november 2022 kunnen discussiedraden door beheerders en moderators live worden vergrendeld of ontgrendeld via het driepuntjesmenu boven het antwoordgebied.

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

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

Beperken van linkdomeinen

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

Dit kan worden beperkt tot een gewenste lijst van sites of domeinen. Als geprobeerd wordt een link te plaatsen naar een site of domein dat niet in de gedefinieerde lijst staat, wordt er een foutmelding aan de gebruiker weergegeven.

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

Dit wordt gedaan zonder code, op de pagina voor het aanpassen van de widget:

Restrict External Link Domains

Het aantal opmerkingen en het mee-tellen van alle geneste antwoorden

Het aantal reacties dat bovenaan de reacties-widget wordt weergegeven kan óf alle "top-level" reacties tonen, dat wil zeggen die reacties die rechtstreeks op de pagina of het artikel zelf reageren, óf het kan een telling zijn van alle geneste reacties.

By default, this is true - it is a count of the latter - all comments. In oudere versies van de reacties-widget is de standaardwaarde false.

We kunnen het gedrag wijzigen, zodat het een telling is van alle geneste reacties door de countAll vlag op true te zetten.

Counting All Comments

Copy

Run

<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>
<div id="fastcomments-widget"></div>
<script>
window.fcConfigs = [{
    "tenantId": "demo",
    "countAll": true
}];
</script>

Als we willen dat de telling alleen de top-level reacties weerspiegelt, zetten we de vlag op false.

Counting Top Level Comments

Copy

Run

<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>
<div id="fastcomments-widget"></div>
<script>
window.fcConfigs = [{
    "tenantId": "demo",
    "countAll": false
}];
</script>

Dit kan momenteel niet worden aangepast zonder codewijzigingen.

Links voor reageerders inschakelen

Standaard vraagt FastComments de gebruiker alleen om hun reactie, hun gebruikersnaam en hun e-mail.

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

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

Enabling Commenter Links

Copy

Run

<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>
<div id="fastcomments-widget"></div>
<script>
window.fcConfigs = [{
    "tenantId": "demo",
    "enableCommenterLinks": true
}];
</script>

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

Dit kan zonder code worden aangepast op de pagina voor het aanpassen van de widget:

Enabling Commenter Links

Moderatiegroepen

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

<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>
<div id="fastcomments-widget"></div>
<script>
window.fcConfigs = [{
    "tenantId": "demo",
    "moderationGroupIds": [
        "mxZAhjzdb",
        "FT19nXbqA"
    ]
}];
</script>

Groep-ID's vermelden

Een lijst met ids om te gebruiken voor de @mentions autocomplete. Handig wanneer je wilt voorkomen dat gebruikers worden getagd als ze geen overlappende groepen hebben.

Wanneer opgegeven, zullen alleen gebruikers uit andere groepen in de autocomplete worden weergegeven nadat het @-teken is getypt.

Limit Groups for Mentions

Copy

Run

<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>
<div id="fastcomments-widget"></div>
<script>
window.fcConfigs = [{
    "tenantId": "demo",
    "mentionGroupIds": [
        "yxZAhjzda",
        "QT19nXbqB"
    ]
}];
</script>

Voor authenticatie is FastComments afhankelijk van cookies van derden die in uw browser ingeschakeld zijn. Zonder deze cookies moeten gebruikers altijd hun e-mailadres achterlaten om te kunnen reageren (tenzij het e-mailinvoerveld verborgen is), en hun reacties zullen standaard altijd als niet-geverifieerd worden weergegeven.

Om dit te omzeilen, kunt u de omzeiling voor cookies van derden inschakelen.

Wanneer deze instelling is ingeschakeld, verschijnt er een klein pop-upvenster dat een bericht toont dat de gebruiker wordt ingelogd. Dit pop-upvenster verschijnt telkens wanneer de gebruiker interactie heeft met de commentaarwidget; bijvoorbeeld wanneer ze een reactie achterlaten.

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

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

Enabling Third-Party Cookie Bypass

Opmerkingen met antwoorden verwijderen

Standaard kunnen gebruikers hun eigen reacties verwijderen. Bovendien verwijdert het verwijderen van hun reactie automatisch alle onderliggende en tijdelijke reacties in de thread. Dit gedrag is ook live.

U kunt dit op de volgende manieren beperken:

Anonimiseer in plaats daarvan de verwijderde reactie (stel naam en tekst in op [deleted] of een aangepaste waarde).
Sta het verwijderen van reacties niet toe wanneer er antwoorden zijn. Er wordt een aanpasbaar foutbericht weergegeven.
Beperk het verwijderen van reacties die antwoorden hebben tot alleen beheerders en moderators.

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

Customize Delete Behavior for Replies

Badges in de bovenbalk weergeven

Standaard toont FastComments gebruikersbadges alleen bij hun opmerkingen binnen de discussiedraad.

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

Show Badges in Top Bar Option

Dit toont de badges van de gebruiker naast hun naam in de bovenste balk, waardoor hun prestaties en status prominenter worden wanneer ze een reactie aan het schrijven zijn.

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

Disable Show Badges in Top Bar

Copy

Run

<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>
<div id="fastcomments-widget"></div>
<script>
window.fcConfigs = [{
    "tenantId": "demo",
    "showBadgesInTopBar": false
}];
</script>

Vorige gids Volgende gids

Taal 🇳🇱 Nederlands

De basis

Weergave en stijl

Live opmerkingen

Paginering en sortering

Het reactieveld

SSO

Anoniem reageren

Overig

Aanpassingen en Configuratie

Context

Uw account identificeren

Hoe opmerkingen aan pagina's en artikelen worden gekoppeld

Valkuilen

Dezelfde opmerkingen op verschillende pagina's weergeven

Aangepaste opmaak

Externe CSS-bestanden

In Code - Niet aanbevolen

Styling van gebruikersprofiel-modal

Achterwaartse compatibiliteit

Aangepaste lettertypen

Hoe het lettertype te definiëren

Branding verwijderen

Ondersteuning voor donkere achtergronden (donkere modus)

Donkere modus in-/uitschakelen

Tekst overschrijven

De standaardavatar wijzigen

Avatars uitschakelen

Alle standaardstijlen uitschakelen

Linken van opmerkingen naar pagina's

Antwoorden standaard inklappen

WYSIWYG inschakelen

Werkbalk uitschakelen

Blokkeren uitschakelen

Bepalen welke pagina wordt weergegeven

Opmerkingendraden wisselen zonder de pagina te herladen

Angular, React, Vue, enz.

VanillaJS

Absolute datums (mensenleesbare tijdstempels uitschakelen)

Zowel absolute als relatieve datums weergeven

Koptekst toevoegen

Links als tekst weergeven

Opmerkingen met een knop in-/uitschakelen

Tekst voor aantal opmerkingen aanpassen

Afbeeldingsomleiding uitschakelen

Automatisch aanmaken van hashtags uitschakelen

Meldingsbel uitschakelen

Profielen uitschakelen

Succesbericht uitschakelen

Inhoudsclassificatie van GIF's wijzigen

Moderatie van afbeeldingsinhoud

Stemstijl wijzigen

Verwijderen uitschakelen

Bewerken uitschakelen

Nieuwe opmerkingen markeren

Paginagrootten

E-mailsjablonen

Gebruikersnaamformaten

Afbeeldingsuploads uitschakelen

Zoekvak inschakelen

Spoilers inschakelen

Weergaveaantallen van opmerkingen inschakelen

Live-opmerkingen direct weergeven

Live-opmerkingen uitschakelen

Nieuwe live-opmerkingen onderaan weergeven

Oneindig scrollen inschakelen

Standaard sorteervolgorde wijzigen

Alle opmerkingen tegelijk weergeven - paginering uitschakelen

Het reactieveld verplaatsen naar na de opmerkingen

De maximale lengte van opmerkingen beperken

Meerregelige opmerkingen uitschakelen

Aantal opmerkingen per gebruiker beperken

Nieuwe opmerkingen op hoofdniveau voorkomen

Maximale antwoorddiepte

Overzicht Single Sign On (SSO)

How do I get it?

User and Comment Migrations

WordPress Users

WordPress SSO - Moderators

Custom Integrations