Customizations & Configuration

Tilpasninger og konfiguration

Kontekst

Her finder du dybdegående dokumentation om hver af de funktioner og indstillinger, som kommentar-widget'en understøtter.

Denne dokumentation dækker kernebegreber og går i dybden med hvert funktionalitetsområde, med vejledninger og almindelige faldgruber.

Kodeeksempler vil blive vist, med relevante linjer fremhævet. Skærmbilleder af konfigurationssider vil blive vist, hvor det er relevant.

Kodeeksemplerne vil bruge vores vanilla JavaScript-bibliotek, men konfigurationsmulighederne bruger de præcis samme navne for alle versioner af kommentar-widget'en (React, Vue osv.).

De fleste konfigurationer og funktioner, der er skitseret i denne guide, kræver ikke, at der skrives kode.

Identificering af din konto

Du vil måske bemærke, at kommentar-widgeten kan bruges med en Tenant ID på "demo", for eksempel:

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>

Dette er kun ment til at prøve og lege med kommentar-widgeten. I produktion ville du angive din Tenant ID, således:

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>

Din Tenant ID kan findes allerede indsat i kommentar-widgetens kodeeksempel i din konto.

Du kan også finde din Tenant ID og administrere dine API-nøgler på siden med API-legitimationsoplysninger.

Fremover, hvis du er logget ind på FastComments, vil kodeeksemplerne bruge din rigtige Tenant ID (hvis du er logget ind på https://fastcomments.com).

Hvordan kommentarer er knyttet til sider og artikler

Når en kommentartråd vises, eller når der afgives en kommentar, har FastComments brug for at vide, hvilken side, artikel eller produkt disse kommentarer tilhører.

Til dette bruger vi noget, vi kalder "URL ID". Det er enten en identifikator, som en streng eller et tal, eller en URL.

Som standard, hvis du ikke angiver urlId, vil det blive sidens URL. Vi tager den aktuelle side-URL og renser den for at fjerne almindelige marketingparametre eller tracking-identifikatorer.

I tilfælde af tredjepartsintegrationer, som WordPress, vil vores plugin normalt bruge den identifikator, der repræsenterer den aktuelle viste information som URL ID, for eksempel artikel-/side-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>

Én ting, som vi ofte henviser til i dette dokument, er Widget-tilpasningsbrugerflade.

Denne brugerflade kan bruges til at foretage mange ændringer af kommentar-widgeten uden at bruge kode.

Når du opretter en tilpasningsregel, vil vi ofte ønske, at den gælder for alle sider på vores site. Men i nogle tilfælde ønsker vi at tilpasse kommentar-widgeten på en bestemt side, enten for at anvende brugerdefineret styling, eller måske gøre kommentarer på den pågældende side anonyme. Du kan for eksempel også få live-kommentarer til at vises med det samme på nogle sider, mens de er skjult under notifikationsknapper på andre.

Alt dette er muligt via URL ID-indtastningsfeltet på denne side, som ser ud som følger:

URL ID Input in The Widget Customization Page

Værdien i dette felt bør matche urlId-parameteren, der gives til kommentar-widgeten. Hvis du vil have, at din tilpasningsregel skal være urlId agnostisk, lad dette felt stå tomt eller indtast *.

Som af 2023 tager URL ID-feltet i widget-tilpasningen nu også mønstre! For eksempel kan du have */blog/* for at tilføje styling specifikt til din blog og */store/* for styling specifikt til din butik, alt sammen på samme domæne.

Faldgruber

Hvis din side har hash-parametre (som example.com#page-1) - vil dette som standard blive en del af URL ID'en.
Under migrationer, for eksempel fra WordPress til Gatsby, kan det være nødvendigt at migrere kommentarværdierne for URL ID efter den indledende migration. Kontakt os i så fald.

Visning af de samme kommentarer på forskellige sider

Da urlId-parameteren lader os definere, hvilken side eller id kommentarerne er knyttet til, kan vi ganske enkelt sætte urlId til den samme værdi på disse sider.

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>

Brugerdefineret styling

FastComments er designet til at kunne tilpasses. Selve kommentars-widgeten kører inde i et iframe af sikkerhedsmæssige årsager, så for at anvende brugerdefineret styling skal du følge en af to tilgange.

Den første, nemmeste tilgang, og den vi foretrækker, er at bruge widget customization page.

På widget-tilpasningssiden skal du se afsnittet "Show Advanced Options", under hvilket der er et område mærket "Custom CSS":

Custom CSS Input Area

Denne tilgang har nogle fordele:

Den indtastede CSS minificeres, før den sendes til brugeren, og formateringen holdes konsistent i redigerings-UI'en.
Du får alle fordelene ved widget-tilpasnings-UI'en, for eksempel nemt at tilpasse kommentars-widgeten forskelligt for forskellige sites.
Når vi laver ændringer til kommentars-widgeten, vil din brugerdefinerede styling blive testet som en del af vores release-proces.

Den anden tilgang er at angive parameteren customCSS i widget-konfigurationen, som følger:

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>

Dette har dog begrænsninger:

Der er en grænse for, hvor meget brugerdefineret CSS der kan sendes, før vores servere afviser forespørgslen, på grund af header-størrelsen.
Du skal administrere den brugerdefinerede CSS i din infrastruktur og dit build-system. Dette kan også være en fordel frem for en ulempe.
Der er en ekstra overhead ved at sende den brugerdefinerede CSS over netværket to gange i dette tilfælde, da den først skal sendes til vores servere og derefter sendes tilbage i iframe-indholdet. For de fleste payload-størrelser er dette dog ikke mærkbart.
En almindelig optimering er at minificere CSS'en for at reducere dens størrelse over nettet, men med denne tilgang skal du selv håndtere det.
Din brugerdefinerede CSS vil ikke blive testet, når vi laver ændringer.

External CSS Files

Du kan få widgetten til at hente en ekstern fil ved at bruge @import!

Det anbefales at placere @import i en tilpasningsregel. På den måde, hvis vi nogensinde får behov for at ændre kommentars-widgeten, kan vi bruge vores automatiseringsværktøjer til at verificere din opsætning. Så for eksempel opretter du en tilpasningsregel i Widget Customization UI'en, klikker Advanced, og indtaster i Custom CSS:

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

In Code - Not Recommended

Du kan også indlæse en ekstern CSS-fil via customCSS-egenskaben:

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>

Husk dog, at din CSS ikke vil kunne testes af os, hvis du gør dette.

Brugerprofilmodaler kan også styles med brugerdefineret CSS. For at sikre, at brugerdefineret styling anvendes på brugerprofiler, skal alle CSS-selektorer dog være præfikset med .user-profile. Uden dette præfiks vil brugerdefineret styling blive ignoreret for brugerprofilmodaler.

For eksempel:

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>

Backwards Compatibility

Hos FastComments ved vi, at vores kunder tilpasser kommentars-widgeten. Det er med vilje - det sidste, vi ønsker, er at vores produkt skaber designmæssige uoverensstemmelser i dit produkt.

Da dette er en vigtig del af vores produkt, har vi en build-pipeline, der gør det muligt for os at gennemgå ændringer til kommentars-widgeten per kunde ved hver release.

Hvis vi finder mindre problemer, vil vi opdatere din konto for at sikre, at vores release forløber glat. Hvis vi ser større brydende ændringer, gør dette os i stand til at standse releasen.

Brugerdefinerede skrifttyper

FastComments er designet til at blive tilpasset, og skrifttypen vores widgets bruger er ingen undtagelse.

Som standard bruger FastComments system font stack for at se så godt ud som muligt på en bred vifte af enheder.

For at definere dine egne skrifttyper, se Dokumentation for brugerdefineret CSS.

Der finder du en måde at definere brugerdefineret CSS på, som gør det muligt at angive de skrifttyper, du ønsker.

Sådan defineres skrifttypen

For at tilsidesætte skrifttypen anbefaler vi, at du definerer din CSS ved hjælp af .fast-comments, textarea selektorerne. For eksempel:

Eksempel på ekstern brugerdefineret skrifttype

Copy

Run

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

Fjern branding

For kunder med Pro- eller Enterprise-konti er white-labeling tilladt. Kontakt os blot kontakt os, og vi hjælper dig gerne.

Hvis du blot ønsker at fjerne vores logo fra kommentar-widgeten, er dette automatisk aktiveret på Flex- og Pro-planerne.

Disse planer giver også den samme funktionalitet for e-mails sendt fra vores platform.

Understøttelse af mørke baggrunde (mørk tilstand)

Som standard vil FastComments kommentar-widget automatisk opdage mørk tilstand på de fleste websteder.

Når mørk tilstand opdages, skifter FastComments fra sort tekst på hvid baggrund til hvid tekst på sort baggrund. Billeder vil også ændre sig.

Når siden indlæses, vil widget'en forsøge at bestemme, hvor mørk baggrunden på siden er bag kommentarfeltet. Det betyder, at siden kan have en hvid baggrund, men hvis du placerer kommentarfeltet inde i en container med en sort baggrund, bør mørk tilstand stadig automatisk blive aktiveret for at gøre kommentarerne læsbare.

Dog kan detektionsmekanismen, som er afhængig af at bestemme "luminans", muligvis ikke aktivere mørk tilstand, når du ønsker det. For at tvinge den til at aktivere mørk tilstand, sæt hasDarkBackground-flaget til true som følger:

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>

Skifte mørk tilstand

For sites that allow toggling dark mode after the initial page load, this is a bit more involved.

First, all current versions of the Comment widget library (React, Vue) have examples of toggling dark mode in their respective repositories.

For the VanillaJS widget, we will need to do some more work. First, the FastCommentsUI returns an object with the functions "destroy" and "update".

We can simply call the update function every time we want to update the comment widget configuration, as follows. Here is a complete functioning example of toggling dark mode with the VanillaJS widget.

Komplet eksempel på at skifte mørk tilstand

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>

Overskrive tekst

Med FastComments kan al tekst i kommentar-widgeten tilpasses.

Du kan tilsidesætte et enkelt tekststykke, som f.eks. send-knappen, eller al tekst i hele kommentar-widgeten.

Som standard bliver teksten i kommentar-widgeten oversat baseret på brugerens lokalitet. Men vi kan tilsidesætte teksten, hvis vi er sikre på, at vores brugerbase bruger samme lokalitet/sprog, for eksempel:

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 tilpasningsbare oversættelser findes her under fanen "advanced options".

Der er dog en nemmere måde via widget-tilpasningsbrugergrænsefladen. Der kan vi blot finde den tekst, der vises i kommenterings-widgeten i EN_US-lokalet, og angive en erstatning.

Custom Text

Alle overskrivninger af oversættelser gælder i øjeblikket for alle lokaliteter.

Ændre standardavatar

Når en bruger kommenterer med FastComments for første gang, vil vi forsøge at hente deres avatar fra http://gravatar.com/.

Hvis vi derimod ikke finder en avatar, eller brugeren aldrig sætter en i deres konto, viser vi et statisk standard-avatarbillede.

For at angive dit eget statiske avatarbillede kan vi bruge indstillingen defaultAvatarSrc.

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>

Dette kan også gøres uden kode. På widgettilpasningssiden, se afsnittet "Standard-avatar".

Customizing The Default Avatar

Bemærk, at det at definere avataren for en bestemt bruger, som f.eks. med SSO, er dækket i sit eget afsnit.

Deaktivere avatarer

Avatarer kan fjernes helt fra kommentar-widgetet, selvom brugerne har defineret deres egne avatarer.

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>

Dette kan tilpasses uden kode på widget-tilpasningssiden:

Hiding Avatars

Deaktivere alle standardstilarter

For større tilpassede stylingprojekter kan det være ønskeligt at starte fra bunden og slet ikke bruge standardstylingen.

Al standardstyling kan fjernes ved at sætte noStyles-parameteren til true, som følger:

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>

Dette kan tilpasses uden kode, på widgetens tilpasningsside, under Avancerede indstillinger:

Disabling All Default Styles

Linke fra kommentarer til sider

Når du sender notifikations-e-mails, eller gengiver kommentarer i brugergrænseflader som moderationssiden, er det nyttigt at kunne linke fra kommentaren til den side, den står på.

Hvis URL ID ikke altid er et ID, så er vi nødt til at gemme URL'en et andet sted. Det er det, "url" property er til, defineret som følger.

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>

Et almindeligt brugsscenarie er at knytte kommentartråden til en identifikator, som en artikel, og derefter linke tilbage til en bestemt side, for eksempel:

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>

URL'en bliver ikke renset for almindelige marketingparametre. Som standard gemmes præcis den aktuelle side-URL sammen med kommentaren.

Sammenklap svar som standard

Som standard vises svar på overordnede kommentarer.

Dette kan konfigureres, så brugeren skal klikke "Vis svar" på topniveau-kommentarerne for at se underkommentarerne.

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>

Dette kan tilpasses uden kode, på siden til tilpasning af widgeten:

Collapse Replies

Denne indstilling påvirker ikke antallet af topniveau-kommentarer, der indlæses initialt. Hvis du har én topniveau-kommentar og 29 underkommentarer, vil du med denne indstilling slået til:

Se topniveau-kommentaren.
Se Vis svar (29) under denne kommentar.

Hvis du ønsker at vise alle topniveau-kommentarer i kombination med denne mulighed, sæt startside til -1.

Aktivere WYSIWYG

Som standard udføres formateringsfunktionerne i FastComments ved at tilføje synlige anker-tags som <b></b> omkring din tekst. At klikke på værktøjslinjen eller bruge genvejstaster gør dette for dig. Dog kan nogle fællesskaber ønske at vælge at bruge formatering uden anker-tags. Dette kaldes at aktivere WYSIWYG (hvad du ser er hvad du får)-editoren. Denne editor ser præcis ud som standardeditoren, bortset fra at den indlæser noget ekstra kode, som tillader brugere at gøre tekst fed, understrege osv. uden synlige 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>

Dette kan også gøres uden kode. På widget-tilpasningssiden skal du se indstillingen "Aktivér avanceret formatering".

Enable WYSIWYG

Som standard viser FastComments en værktøjslinje, når man skriver en kommentar for at give genveje til at formatere tekst og uploade billeder.

Denne værktøjslinje kan deaktiveres i koden eller via Tilpasnings-UI'en.

Dette kan også gøres uden kode. På widget-tilpasningssiden skal du se efter indstillingen "Deaktiver svarværktøjslinjen".

Disabling The Toolbar

Deaktivere blokering

Som standard tillader FastComments brugere at blokere andre brugere. At blokere en bruger vil få deres kommentarer til at blive maskeret, forhindre notifikationer mellem brugerne osv.

Det kan være ønskeligt at deaktivere denne funktionalitet. Det kan gøres på følgende måde:

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>

Dette kan også gøres uden kode, hvilket også aktiverer korrekt server-side-validering, via Widget-tilpasningsgrænsefladen:

Disable Blocking

Bestemme hvilken side der skal gengives

Når der hentes og gengives kommentarer, skal kommentarwidgeten vide, hvilken side den skal starte på. Som standard starter den med den første side og gengiver kun den side.

Hvis ønsket, kan den præcise side, der skal gengives, sendes til kommentarwidgeten som indstillingen 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>

Bemærk, at sidetal begynder ved nul, så ovenstående eksempel gengiver den anden side.

Skifte kommentartråde uden at genindlæse siden

Vi har gennemgået, hvordan urlId er id'et for siden eller artiklen, som kommentarerne er tilknyttet.

For at opsummere: hvis ikke defineret, vil urlId som standard være den aktuelle sides URL.

Hvad med SPAs, eller Single-Page-Applications, hvor siden eller indholdet, som kommentarerne er tilknyttet, ændrer sig dynamisk uden en ny sideindlæsning?

Angular, React, Vue, osv.

Med vores biblioteker som Angular og React vil en simpel opdatering af urlId-egenskaben, der sendes til widget'en, få kommentarswidget'en til at opdatere. Du kan se dette i praksis for React-appen, for eksempel, her.

VanillaJS

Hvis du bruger VanillaJS-biblioteket, er det en smule mere kompliceret, da der ikke er et framework som Angular eller React til at håndtere databinding eller udbredelse af tilstand.

Når du instantierer VanillaJS-widget'en, returnerer den nogle funktioner, der kan kaldes for at opdatere den.

Her er et funktionelt eksempel, hvor vi ændrer side-hashen og opdaterer kommentarswidget'en:

Eksempel på skift af side-hash

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 update url, too, so notifications can link back to the right page
            config.urlId = locationString;
            instance.update(config);
        }
        nextPage();
        button.addEventListener('click', nextPage);
    })();
</script>

Absolutte datoer (deaktiver menneskevenlige tidsstempler)

Som standard bruges lokaliserede relative datoer. For eksempel kan du ved siden af en nyligt efterladt kommentar se "11 minutter siden".

Det kan være nødvendigt eller ønskeligt at bruge absolutte datoer, i så fald sætter du denne parameter til 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>

Dette kan tilpasses uden kode, på siden for widget-tilpasning, under Avancerede indstillinger:

Use Absolute Dates

Vis både absolutte og relative datoer

Som standard bruges lokaliserede relative datoer. For eksempel kan du ved en nyligt efterladt kommentar se "11 minutter siden".

Det kan være nødvendigt eller ønskeligt at bevare dette relative datoformat, men også vise den fulde dato ved siden af; i så fald sætter du denne parameter til 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>

Dette kan tilpasses uden kode, på widgetens tilpasningsside, under Avancerede indstillinger. Du skal først aktivere Absolutte datoer for at se denne mulighed i brugergrænsefladen.

Use Both Absolute and Relative Dates

Tilføje overskriftstekst

Noget tekst, som en overskrift eller besked, kan vises under kommentarantallet, men over loginstatus-teksten.

Vi kalder dette overskriften, og som standard er den skjult.

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>

Dette kan tilpasses uden kode på widget-tilpasningssiden under Avancerede indstillinger:

Specifying Header HTML

Gengive links som tekst

Som standard gengiver FastComments links som dette: https://exmaple.com - hvor link-URL'en bliver et klikbart HTML-anker-tag.

Nogle websteder vil måske deaktivere dette, for eksempel for at afskrække svindlere. Vi tilbyder dette ved at indstille Comment HTML Rendering Option til Links as Text.

Dette kan tilpasses uden kode, på widget-tilpasningssiden, for et helt domæne, eller en side:

Render Links as Text

Skifte kommentarer med en knap

Som standard gengiver FastComments kommentarboksen og kommentartråden samtidig. For at spare noget lodret plads, vil den også skjule alle andre påkrævede felter, indtil der interageres med widgeten.

Kommentarwidgeten kan dog skjules bag en knap, for eksempel:

Click to Show Comments

Knappen bruger forskellig oversat tekst afhængigt af, om kommentarerne i øjeblikket vises eller ej. Hvis kommentarerne er skjult, bruger den translations.SHOW_COMMENTS_BUTTON_TEXT. Hvis kommentarerne vises, bruger den translations.HIDE_COMMENTS_BUTTON_TEXT. Oversættelserne kan indeholde teksten [count] som vil blive erstattet af det lokaliserede antal.

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>

Dette er designet til at erstatte konfigurationen hideCommentsUnderCountTextFormat.

Tælleren opdateres live sammen med kommentartråden. Knappen vises ikke, hvis der ikke er nogen kommentarer.

Dette kan aktiveres uden kode ved at oprette en tilpasningsregel og aktivere "Click to Show Comments":

Enable Click to Show Comments

Tilpasse tekst for antallet af kommentarer

Antal kommentarer, der vises øverst i kommentarboksen, kan tilpasses.

Dette kan erstattes med en vilkårlig tekststreng, og værdien [count] bliver erstattet med antallet, lokaliseret for brugeren.

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>

Dette kan tilpasses uden kode, på widget-tilpasningssiden:

Customizing The Comment Count Text

Deaktivere billedomdirigering

Som standard tillader FastComments brugere at uploade billeder. Når en bruger klikker på det billede, åbner FastComments som standard, en ny fane for at vise billedet i fuld størrelse. At sætte denne indstilling til true deaktiverer denne adfærd:

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>

Hvis du ikke planlægger at fange klik på billedet selv (se onImageClicked), anbefaler vi, at dette kombineres med noget styling for at fjerne indtrykket af, at billedet kan klikkes på.

Deaktivere automatisk oprettelse af hashtags

Når brugere indtaster hashtags i formen #someexampletag, opretter FastComments automatisk det HashTag og fremhæver det i deres kommentar.

I nogle tilfælde er det ønskeligt at deaktivere denne funktion eller kontrollere, hvilke hashtags der kan bruges via API'en.

For at gøre dette skal du blot aktivere Disable Automatic #hashtag Creation via Widget-tilpasningsbrugerfladen.

Disabling Automatic HashTag Creation

Deaktivere notifikationsklokke

Som standard vil FastComments vise en notifikationsklokke øverst til højre i kommentarfeltet.

Denne klokke bliver rød og viser antallet af notifikationer, brugeren har. Eksempler på notifikationer er:

En bruger svarede dig.
En bruger svarede i en tråd, du har kommenteret i.
En bruger stemte din kommentar op.
En bruger svarede på en side, du har abonneret på.

Notifikationsklokken gør det også muligt at abonnere på en hel side.

Men vi kan deaktivere notifikationsklokken helt:

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>

Dette kan også gøres uden kode. På siden for tilpasning af widgeten, se afsnittet "Deaktiver notifikationsklokken".

Disable Notification Bell

Deaktivere profiler

Som standard viser FastComments brugerens profil, når du klikker på deres avatar.

Du kan dog deaktivere denne funktionalitet:

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>

Dette kan også gøres uden kode. På widget-tilpasningssiden skal du se afsnittet "Deaktiver profiler".

Disable Profiles

Deaktivere succesmeddelelse

Som standard vil FastComments vise en succesmeddelelse efter kommentering. Dette kan deaktiveres som følger:

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>

Dette kan også gøres uden kode. På widgetens tilpasningsside:

Disable Success Message

Ændre indholdsvurdering af GIF'er

Som standard vil FastComments' kommentar-widget indstille en gif rating på pg.

Tilgængelige muligheder er g, pg, pg-13, og r.

Dette kan indstilles i koden eller via UI'en. I koden kan vi gøre det som følger:

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>

I UI'en vil du finde dette under Gif Picker Rating, så længe Disable Image Uploads? ikke er markeret.

Setting The Gif Rating

Moderering af billedindhold

Som standard er billedindholdssensur i FastComments-kommentarswidgeten slået off.

Tilgængelige muligheder er off, low, medium og high.

I widgetens tilpasnings-UI finder du dette under Image Content Moderation Level, så længe Disable Image Uploads? ikke er markeret.

Setting The Image Content Moderation Level

Ændre stemmestil

Som standard viser FastComments stemmeindstillinger som op- og ned-knapper, så brugere kan stemme en kommentar op eller ned.

Det er dog muligt at ændre stilen på stemmeværktøjslinjen. De nuværende muligheder er standard op-/ned-knapperne eller at bruge en hjertebaseret stemmefunktion.

Vi bruger voteStyle-flaget som følger:

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>

Vi anbefaler kraftigt, at du gør dette uden kode, da det også aktiverer validering på serversiden. På siden til tilpasning af widgeten, se sektionen "Vote Style".

Change Voting Style

Stemmegivning kan også deaktiveres, se Disable Voting ovenfor ved stilindstillingerne.

Deaktivere sletning

Som standard tillader FastComments brugere at slette deres kommentarer.

Det er dog muligt at forhindre dette.

På siden til tilpasning af widgeten, se indstillingen "Deaktiver sletning".

Disable Comment Deleting

Dette påvirker kun almindelige kommentatorer og ikke moderatorer eller administratorer, som stadig vil kunne slette.
Dette vil også påvirke API-integrationer, når contextUserId angives.

Deaktivere redigering

Som standard tillader FastComments brugere at redigere deres kommentarer.

Det er dog muligt at forhindre dette.

På siden til tilpasning af widgeten skal du se indstillingen "Deaktiver redigering".

Disable Comment Editing

Dette påvirker kun almindelige kommentatorer og ikke moderatorer eller administratorer, som stadig vil kunne redigere.
Dette vil også påvirke API-integrationer, når contextUserId sendes.

Fremhæve nye kommentarer

FastComments tilbyder flere måder at fremhæve nye kommentarer på.

For det første, som standard vil kommentarer der udløste en in-app-meddelelse (svar, svar i samme tråd, eller kommentarer på en side som du abonnerer på), automatisk blive fremhævet ved, at brugerens avatar får en svag glød. Farven kan tilpasses via CSS ved hjælp af klassen is-unread.

Kommentarer postet inden for de sidste 24 timer får anvendt klassen 24hr, som kan bruges til styling.

Endelig vil nye live-kommentarer, der dukker op i brugerens session, blive fremhævet i flere sekunder via en animation. Dette sker via CSS-klassen is-live og kan også tilpasses.

Sidestørrelser

Som standard er FastComments' sidestørrelse 30. Dette inkluderer svar i tråde.

Sidestørrelsen kan tilpasses i Widget-konfigurationsgrænseflade i forskellige størrelser fra 10 til 200.

Bemærk, at ændring af sidestørrelsen kræver genberegning af alle kommentartråde i din konto. Dette kan tage et par minutter.

Dette kan ikke konfigureres i klient-side-widgeten, da siderne beregnes på serversiden.

Et eksempel på konfiguration vises nedenfor:

Custom Page Sizes

Sidestørrelser kan tilpasses globalt, per domæne eller per side ved at oprette forskellige tilpasningsregler.

Dette vil påvirke alle klienter, integrationer og rammeværk, som du måtte bruge til at vise kommentarer via vores platform.

E-mail-skabeloner

E-mails sendt fra FastComments til dine kunder kan tilpasses. Skabelonen, logikken og oversættelserne kan alle ændres. Tekst kan tilpasses pr. lokalitet, og udseendet kan endda ændres pr. domæne. Læs mere om tilpassede e-mail-skabeloner her.

Formater for brugernavne

Som standard viser FastComments brugerens navn, som de indtastede det, eller som det blev sendt til os via SSO.

Dog kan det være ønskeligt at maskere eller vise brugerens navn på en anden måde. For eksempel, hvis brugerens navn er Allen Rex, måske du kun vil vise "Allen R.".

Dette kan gøres uden kode i Widget Customization UI, under indstillingen kaldet Commenter Name Format:

Change Name Format

De tilgængelige formater er:

Capitalize (viser eksempelbrugeren som Example User)
Last Initial (viser Example User som Example U.)
All Initials (viser Example User som E. U.)
Show "Anonymous"

Ændringen træder i kraft med det samme. Brugere vil stadig se deres fulde brugernavn øverst i kommentarfeltet, for dem selv, men deres kommentarer vil vise det ændrede brugernavn.

Brugernavne maskeres på serversiden for at beskytte brugerne.

Deaktivere billeduploads

Som standard tillader FastComments upload af billeder. Dette kan deaktiveres ved at sætte noImageUploads-flaget til true.

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>

Dette kan tilpasses uden kode på siden til tilpasning af widgeten:

Disabling Image Uploads

Aktivere søgefelt

Som standard vises der ikke noget søgefelt i kommentar-widgeten.

Du kan dog aktivere det ved at sætte flaget enableSearch til true:

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>

Dette kan også gøres uden kode. På siden for tilpasning af widget'en, se indstillingen "Aktiver søgefelt".

Enable Search Box

Aktivere spoilers

Vi kan aktivere spoiler-understøttelse ved at sætte enableSpoilers-flaget til true:

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>

Dette kan også gøres uden kode. På siden til tilpasning af widgetten, se indstillingen "Aktivér spoilere".

Enable Spoilers

Når tekst markeres, og den nu synlige SPOILER-knap klikkes, vil teksten blive maskeret, indtil brugeren holder musen over den. For mørk tilstand gør vi det samme, med forskellige farver, der passer bedre til mørk tilstand.

Dette er også kompatibelt med WYSIWYG-editoren.

Aktivere visningsantal for kommentarer

Som standard sporer FastComments ikke, hvem der har set hver kommentar, eller giver nogen statistik omkring dette.

Vi kan dog aktivere denne funktion, og så vil systemet begynde at spore, når hver bruger scroller hen til en kommentar.

Når dette sker, bliver et tal ved siden af et øjeikon vist på hver kommentar øget. Tallet opdateres live og forkortes i henhold til brugerens lokalitet.

Vi kan aktivere dette ved at sætte flaget enableViewCounts til true:

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>

Dette kan tilpasses uden kode på widget-tilpasningssiden:

Enabling Comment View Counts

Vi sporer bruger-id'et* for den, der så kommentaren, så hvis du ser kommentaren igen, bliver det ikke talt op. Hvis du ser kommentaren igen efter to år, vil tællingen øges.

*Bemærk: eller det anonyme session-id, eller brugerens IP som en hash-værdi.

Vis live-kommentarer med det samme

Som standard er live-kommentering aktiveret. Det betyder, at hvis kommentarer tilføjes, slettes, redigeres eller fastgøres, skal ændringerne vises for alle brugere, der ser kommentartråden samtidig.

Men som standard vil de nye kommentarer blive vist under en dynamisk knap med tekst svarende til "Vis 2 nye kommentarer".

Hvis de nye kommentarer er svar direkte på siden, vises knappen øverst i kommentartråden. Hvis de er svar på en bestemt kommentar, vises knappen under den kommentar.

Dette er for at forhindre, at sidens størrelse konstant ændrer sig for brugeren, hvilket potentielt kan skabe frustration, når man prøver at gribe fat i rullebjælken.

For nogle brugstilfælde, som live-budgivning eller onlinebegivenheder, er dette ikke den ønskede opførsel - du vil måske gerne have kommenteringswidgeten til at fungere mere som et "chat"-felt, hvor nye kommentarer "vises med det samme".

Deraf navnet på flaget, der aktiverer denne funktion: showLiveRightAway.

Vi kan aktivere det som følger:

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>

Dette kan tilpasses uden kode, på widget-tilpasningssiden:

Show Live Comments Right Away

Deaktivere live-kommentering

Som standard har FastComments live-kommentering aktiveret.

Det betyder, at alle seere af kommentartråden bør se det samme indhold.

For eksempel, hvis en kommentar tilføjes, skal den vises. Hvis en kommentar redigeres eller fjernes, vil den blive redigeret eller fjernet for alle seere af tråden. Det samme gælder for stemmer og alle moderationshandlinger.

Du kan dog deaktivere dette:

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>

Dette kan også gøres uden kode. På widget-tilpasningssiden, se afsnittet "Deaktiver live-kommentering".

Disable Live Commenting

Nye live-kommentarer nederst

Som standard vises nye live-kommentarer øverst i kommentarliste, når de postes i realtid.

Når denne indstilling er aktiveret, tilføjes nye live-kommentarer i stedet til bunden af listen. Dette påvirker, hvordan kommentarer vises, når de postes live, mens brugere ser kommentart tråden.

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>

Når denne indstilling er aktiveret:

Nye live-kommentarer, som postes af andre brugere, vises nederst i kommentarlisten
Brugere vil se nye kommentarer dukke op under eksisterende kommentarer i realtid
Dette påvirker kun live-opdateringer af kommentarer – ikke den oprindelige sideindlæsning
Dette kan hjælpe med at bevare læseflowet, når brugere følger en diskussion

Bemærk, at denne indstilling kun påvirker, hvor nye live-kommentarer placeres, når de ankommer i realtid. Den påvirker ikke den oprindelige sorteringsrækkefølge, når siden indlæses.

Aktivere uendelig rulning

Som standard ændrer FastComments-widgetten sin højde for at passe til alle synlige kommentarer. Paginering opnås via en "Vis næste" knap i slutningen af den aktuelle side, da vi har fundet, at denne interaktion føles mest behagelig for de fleste brugere.

Der er dog nogle tilfælde, hvor uendelig rulning foretrækkes. For eksempel bruger vi denne funktion i vores Stream Chat-produkt.

Vi kan skjule "Vis næste"-knapperne og skifte til uendelig rulning ved at sætte enableInfiniteScrolling-flaget til true:

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>

Dette kræver også, at der tilføjes brugerdefineret CSS. Tilføj brugerdefineret CSS for .comments-vælgeren for at aktivere rulning, for eksempel:

Aktiver uendelig rulning

Copy

Run

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

Et fuldt fungerende eksempel ville være:

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>

I eksemplet ovenfor bruger vi customCSS-egenskaben; det anbefales dog at bruge Widget Configuration UI i stedet af hensyn til ydeevnen. Se dokumentationen om Custom CSS.

Ændre standard sorteringsretning

Som standard sorterer FastComments kommentarer efter "Mest relevante" sorteringsretning.

Sorteringen "Mest relevante" tager tidspunktet, hvor kommentaren blev skrevet, og antallet af stemmer i betragtning ved sortering.

Brugeren kan derefter ændre sorteringsretningen til enten "Ældste først" eller "Nyeste først" i kommentarswidgetens brugerflade.

Vi kan dog ændre standarden til en af de tre. For eksempel, hvis du ønsker at vise de ældste kommentarer først:

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>

Vi sætter værdien af defaultSortDirection til "OF" for at sætte retningen til "OF".

For sorteringsretningen "Nyeste først" ville vi gøre følgende:

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 gyldige værdier for defaultSortDirection er:

MR: "Mest nylig"
NF: "Nyeste først"
OF: "Ældste først"

Dette kan også gøres uden kode. På widgetens tilpasningsside, se afsnittet "Standard sorteringsretning".

Changing The Default Sort Direction

Bemærk, at kommentarerne på hver side for hver sorteringsretning er forudberegnede, så alle sorteringsretninger har samme ydeevne.

Gengiv alle kommentarer på én gang - deaktiver paginering

For at deaktivere paginering og blot gengive alle kommentarer på én gang, skal du sætte startingPage til -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>

Flyt svarboksen til efter kommentarerne

Som standard er kommentarfeltet før kommentartråden. Men ved at sætte denne konfigurationsparameter til true kan vi flytte det til efter.

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>

Dette kan tilpasses uden kode, på widgetens tilpasningsside:

Moving The Reply Box to The Bottom

Begrænse kommentarens længde

Det maksimale antal tegn, som kan indtastes i kommentarindtastningsfeltet, kan begrænses af parameteren maxCommentCharacterLength.

Standardværdien er 2000.

Elementer som billed-URL'er medregnes ikke i længdeberegningen.

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>

Dette kan tilpasses uden kode på widget-tilpasningssiden:

Limit Comment Length

Deaktivere multiline-kommentarer

Som standard tillader FastComments brugeren at indtaste en kommentar med så mange linjer, de ønsker, op til standardtegnbegrænsningen.

Det kan dog være ønskeligt at begrænse brugeren til kun at indtaste en enkelt linje tekst. Nogle eksempler på anvendelsestilfælde omfatter online budgivning eller live chat, som FastComments kan bruges til.

Vi aktiverer useSingleLineCommentInput-flaget som følger:

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>

Dette kan også gøres uden kode. På siden til tilpasning af widget'en, se afsnittet "Aktivér enkeltlinje-kommentarinput".

Enable Single-Line Comment Input

Bemærk, at kommentarerne på hver side for hver sorteringsretning er forudberegnede, så alle sorteringsretninger har samme ydeevne.

Begræns antal kommentarer per bruger

Som standard kan hver bruger indsende op til 5 comments i samme minut.

Dette spores ud fra user id, anon user id og ip address (hashed).

Dette kan tilpasses uden kode på widget-tilpasningssiden:

Limiting Comment Volume Per User

Bemærk, at hvis du bruger comment creation API, vil du måske sende brugerens oprindelige ip address i anmodningen til vores backend, så rate limiting anvendes per user og ikke globalt for din account.

Forhindre nye topniveau-kommentarer

Indstilling af noNewRootComments til true får widgeten til at skjule det øverste svarområde, men tillader stadig brugere at svare på underkommentarer. Du kan for eksempel sætte dette betinget ved sideindlæsning, så kun nogle brugere kan efterlade kommentarer på øverste niveau.

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>

Maksimal svardybde

Som standard tillader FastComments ubegrænset indlejring af svar, hvilket skaber en trådstruktur, hvor brugere kan svare på svar på ubestemt tid.

Indstillingen maxReplyDepth giver dig mulighed for at begrænse, hvor dybt svartråde kan gå. Når den maksimale dybde er nået, vil brugerne ikke længere se en svar-knap på kommentarer på det 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>

Med maxReplyDepth sat til 2:

Brugere kan kommentere på øverste niveau (dybde 0)
Brugere kan svare på kommentarer på øverste niveau (dybde 1)
Brugere kan svare på disse svar (dybde 2)
Ingen yderligere svar er tilladt ud over dybde 2

At sætte maxReplyDepth til 1 vil kun tillade svar på kommentarer på øverste niveau, hvilket skaber en fladere diskussionsstruktur.

At sætte maxReplyDepth til 0 vil deaktivere alle svar og kun tillade kommentarer på øverste niveau. Hvis ikke angivet, kan svar indlejres uden begrænsning.

Oversigt over Single Sign-On (SSO)

SSO, eller single-sign-on, er et sæt konventioner, der bruges til at lade dig eller dine brugere bruge FastComments uden at skulle oprette en separat konto.

Antager vi, at du ikke tillader anonyme kommentarer, kræves der en konto for at kommentere med FastComments. Vi gør denne tilmeldingsproces meget nem - brugeren efterlader bare deres e-mail, når de kommenterer. Vi forstår dog, at selv det kan være ekstra friktion, som nogle sider ønsker at undgå.

Vi kan reducere den friktion ved kun at have én login-flow for hele dit site.

How do I get it?

Alle kontotyper får i øjeblikket adgang til SSO. Antallet af SSO-brugere vil dog variere afhængigt af din pakke. Som med andre funktioner tilbyder Pro-planerne og højere direkte udviklingssupport.

Lad os sammenligne mulighederne, og så gå i detaljer om hver.

User and Comment Migrations

Når du migrerer fra en platform med SSO som Disqus, vil du allerede have brugere og deres kommentarer.

Kommentarer importeres som en del af din migration, enten via API'et, vores Import UI eller kundesupport. Import UI foretrækkes, hvis det understøtter den platform, du migrerer fra, da det indeholder fejlhåndtering, avatar- og medie-ekstraktion og uploads samt et batch-job-overvågningssystem.

Brugerne tilføjes automatisk, når kommentartråde ses for første gang. Alternativt kan de forudtilføjes via API'et, men dette arbejde har ikke mange fordele.

Hvis kommentarer er importeret, og SSO-brugere ikke tilføjes manuelt via API'et, vil kommentarerne automatisk blive migreret til brugerens konto første gang den oprettes, når de ser en hvilken som helst kommentartråd. De vil derefter kunne administrere, redigere og slette de kommentarer, de oprindeligt skrev.

Den automatiske migrering sker via e-mail eller brugernavn. Nogle platforme leverer ikke e-mails ved eksport, som Disqus, så vi falder tilbage til brugernavn i dette tilfælde.

Så længe du sender et matchende brugernavn og en e-mail i SSO-payloaden, vil vi tilføje e-mailen til de enkelte kommentarobjekter, så notifikationer og mentions fungerer.

Hvis det ønskes at importere dine kommentarer og brugere på én gang, så arbejd med support for at migrere kommentarerne over til brugernes respektive konti efter brugerne er importeret via API'et.

Sammenfattende er den nemmeste fremgangsmåde til migreringen:

Importer kommentarer.
1. Avatarer og andet medieindhold migreres automatisk, hvis du bruger Import UI under Manage Data -> Imports.
Opsæt Secure eller Simple SSO.
Lad migreringen ske per bruger automatisk, når de logger ind første gang.
1. Dette tilføjer normalt mindre end et sekund til indlæsningstiden, hvis brugeren har mindre end 50k kommentarer.

WordPress Users

Hvis du bruger vores WordPress-plugin er der ingen kode at skrive! Gå blot til pluginets Admin-side, klik på SSO Settings, og tryk derefter Enable.

Dette fører dig til en enkelt-knap-vejledning, som vil oprette din API-nøgle, sende den til din WordPress-installation og slå SSO til. Vi har konsolideret dette til et enkelt knap-klik for dig.

Bemærk, at hvis du installerer pluginet for første gang, skal du følge opsætningsprocessen, før du ser admin-siden med SSO Settings-knappen.

WordPress SSO - Moderators

Bemærk, at for at "Moderator"-badge aktuelt skal vises ved siden af dine moderatorer, når de kommenterer med FastComments WordPress-pluginet, skal de også være tilføjet som Moderator i FastComments-dashboardet og have deres e-mail bekræftet.

Custom Integrations

For tilpassede integrationer er der to muligheder.

Option One - Secure SSO

Med Secure SSO ved FastComments, at brugeren, der kommenterer, stemmer og læser kommentarer, er en reel bruger på dit site.

Så længe du opretter en gyldig payload, vil brugeren altid få en sømløs kommenteringsoplevelse.

Med Secure SSO oprettes SSO-payloaden på serversiden ved hjælp af HMAC-autentificering og sendes derefter til widget'en på klienten.

Med Secure SSO er brugerens konto helt adskilt fra resten af FastComments brugerbase. Det betyder, at hvis vi har to partnere Company A og Company B, kan hver have en SSO-bruger med brugernavnet "Bob".

Requirements

Nogen grundlæggende viden om backend-udvikling.
Nogen grundlæggende viden om håndtering af hemmelige API-nøgler.
Nogen grundlæggende viden om API-udvikling eller server-side rendering.

Pros

Sikkert.
Sømløs kommenteringsoplevelse.

Cons

Kræver backend-udvikling.

Updating User Data

Med Secure SSO vil vi hver gang du sender sso-bruger-payloaden, opdatere deres bruger med de seneste oplysninger. For eksempel, hvis brugeren har brugernavnet X, og du sender Y i SSO-payloaden, vil deres brugernavn blive Y.

Hvis du vil fjerne værdier ved hjælp af denne tilgang, så sæt dem til null (ikke undefined).

Secure SSO API

Vi tilbyder også et API til at interagere med SSO-brugerne. Se dokumentationen.

Bemærk, at når du bruger Secure SSO, oprettes brugere automatisk bag kulisserne ved sideindlæsning. Du behøver ikke at importere dine brugere i bulk.

Option Two - Simple SSO

Alternativet til Secure SSO er simpelthen at sende brugeroplysningerne til kommenteringswidget'en.

Det er ikke nødvendigt at angive en e-mail med Simple SSO; uden denne vil deres kommentarer dog blive vist som "Uverificeret".

^Bemærk! Pr. begyndelsen af 2022 behøver brugernavne med Simple SSO ikke at være unikke på tværs af hele FastComments.com.

Ideelt set bør Simple SSO kun vælges, når der udvikles på en platform, der ikke giver adgang til backend.

Requirements

Nogen grundlæggende viden om klient-side udvikling.
Skal kende mindst brugerens e-mail.

Pros

Simpelt.
Al aktivitet bliver stadig verificeret.
Brugeren indtaster aldrig deres brugernavn eller e-mail.

Cons

Mindre sikkert end Secure SSO, da client-side payloaden kunne blive manipuleret til at blive en anden bruger.

Simple SSO API

Brugere, der automatisk oprettes via Simple SSO-flowet, gemmes som SSOUser objekter. De kan tilgås og administreres via SSOUser API'et. Se dokumentationen.

Tilpassede integrationer - sikker Single Sign-On (SSO)

FastComments Secure SSO bruger HMAC-SHA256-kryptering som mekanismen til at implementere SSO. Først gennemgår vi den overordnede arkitektur, giver eksempler og detaljerede trin.

Der er også noget dokumentation vedrørende migrering fra andre udbydere med lignende SSO-mekanismer, samt forskellene.

Flowet ser sådan ud:

Sikker SSO-flow

Da Secure SSO involverer full-stack-udvikling, er fuldt fungerende kodeeksempler i Java/Spring, NodeJS/Express og vanilla PHP i øjeblikket på GitHub.

Selvom vi bruger ExpressJS i NodeJS-eksemplet og Spring i Java-eksemplet, er der ingen frameworks/biblioteker påkrævet i disse runtime-miljøer for at implementere FastComments SSO - de indbyggede crypto-pakker fungerer fint.

Du behøver ikke at skrive nye API-endpoints med FastComments SSO. Krypter blot brugerens information med din hemmelige nøgle og send payloaden til kommentar-widget'en.

Get Your API Secret Key

Din API Secret kan hentes fra denne side. Du kan også finde siden ved at gå til My Account, klikke på API/SSO-flisen og derefter klikke på "Get API Secret Key".

Overordnet API-dokumentation for kommentar-widgeten kan findes her.

Lad os gå lidt mere i dybden med, hvad disse parametre betyder.

Kommentar-widget'en tager et konfigurationsobjekt - du sender allerede dette, hvis du bruger FastComments til at sende dit kunde-id (kaldet tenantId).

For at aktivere SSO, send et nyt "sso"-objekt, som skal have følgende parametre. Værdierne bør genereres server-side.

userDataJSONBase64: Brugerens data i JSON-format, som derefter Base64-enkodes.
verificationHash: HMAC-SHA256-hashen oprettet fra UNIX_TIME_MILLIS + userDataJSONBase64.
timestamp: Epoch-tidspunkt, i millisekunder. Må ikke være i fremtiden, eller mere end to dage i fortiden.
loginURL: En URL, som kommentar-widget'en kan vise for at logge brugeren ind.
logoutURL: En URL, som kommentar-widget'en kan vise for at logge brugeren ud.
loginCallback: Når det leveres i stedet for login-URL'en, en funktion som kommentar-widget'en vil kalde ved klik på login-knappen.
logoutCallback: Når det leveres i stedet for logout-URL'en, en funktion som kommentar-widget'en vil kalde ved klik på logout-knappen.

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": 1768890092008,
        "loginURL": "https://example.com/login",
        "logoutURL": "https://example.com/logout"
    }
}];
</script>

The User Object

Brugerobjektet indeholder følgende skema:

Brugerobjektet

Copy

interface SSOUser {
    /** Påkrævet. Maks. 1k tegn. **/
    id: string;
    /** Påkrævet. Maks. 1k tegn. Bemærk: Skal være unik. **/
    email: string;
    /** Påkrævet. Maks. 1k tegn. Bemærk: Brugernavnet kan ikke være en e-mail. Behøver ikke være unikt. **/
    username: string;
    /** Valgfri. Maks. 3k tegn for URL'er. Standard er fra gravatar baseret på e-mail. Understøtter base64-kodede billeder, i så fald er grænsen 50k tegn. **/ 
    avatar?: string;
    /** Valgfri. Standard: false. **/
    optedInNotifications?: boolean;
    /** Valgfri. Standard: false. **/
    optedInSubscriptionNotifications?: boolean;
    /** Valgfri. Maks. 100 tegn. Denne label vil blive vist ved siden af deres navn. Standard er Administrator/Moderator, hvor relevant. **/
    displayLabel?: string;
    /** Valgfri. Maks. 500 tegn. Dette vises i stedet for brugernavnet. **/
    displayName?: string;
    /** Valgfri. Maks. 2k tegn. Brugerens navn vil linke til dette. **/
    websiteUrl?: string;
    /** Valgfri. Op til 100 grupper per bruger. Et gruppe-id må ikke være længere end 50 tegn. **/
    groupIds?: string[];
    /** Valgfri. Angiver brugeren som administrator. **/
    isAdmin?: boolean;
    /** Valgfri. Angiver brugeren som moderator. **/
    isModerator?: boolean;
    /** Valgfri, standard true. Sæt til false for at aktivere fanen "activity" i brugerens profil. **/
    isProfileActivityPrivate?: boolean;
    /** Valgfri, standard false. Sæt til true for at deaktivere profilkommentarer. **/
    isProfileCommentsPrivate?: boolean;
    /** Valgfri, standard false. Sæt til true for at deaktivere direkte beskeder til denne bruger. **/
    isProfileDMDisabled?: boolean;
}

Moderators and Administrators

For administratorer og moderatorer, angiv de respektive isAdmin eller isModerator flag i SSOUser-objektet.

Notifications

For at aktivere eller deaktivere notifikationer, sæt værdien af optedInNotifications til henholdsvis true eller false. Første gang brugeren indlæser siden med denne værdi i SSO-payloaden, vil deres notifikationsindstillinger blive opdateret.

Derudover, hvis du ønsker at brugere skal modtage notifikations-e-mails for aktivitet på sider, de har abonneret på (i stedet for kun in-app-notifikationer), så sæt optedInSubscriptionNotifications til true.

VIP Users & Special Labels

Du kan vise en særlig label ved siden af brugerens navn ved at bruge det valgfrie felt "displayLabel".

Unauthenticated users

For at repræsentere en uautentificeret bruger, udfyld simpelthen ikke userDataJSONBase64, verificationHash eller timestamp. Angiv en loginURL.

Disse brugere vil ikke kunne kommentere, og i stedet vil de blive præsenteret for en login-besked (besked, link eller knap, afhængigt af konfiguration).

Direct Examples for Serializing and Hashing User Data

Flere detaljer og eksempler findes her (js), her (java) og her (php).

Vi forstår, at enhver integration kan være en kompliceret og besværlig proces. Tøv ikke med at kontakte din repræsentant eller bruge support-siden.

Tilpassede integrationer - simpel Single Sign-On (SSO)

Med Simple SSO kan vi give kommenteringswidget'en oplysninger om brugeren, så de ikke behøver at indtaste deres brugernavn eller e-mail for at kommentere.

Vi kan konfigurere Simple SSO som følger:

Simple 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>

Brugeren vil blive logget ind, og der oprettes en SSO-bruger bag kulisserne. Brugeren vil have createdFromSimpleSSO sat til true hvis den hentes fra API'en.

Noter:

E-mail er den unikke identifikator for Simple SSO.
Det er ikke påkrævet at angive en e-mail ved Simple SSO; som standard vil deres kommentarer dog vises som "Uverificeret". Hvis der ikke angives en e-mail, kan brugeren ikke blive fuldt autentificeret.
NYT Siden Jan 2022: Brugernavne behøver ikke være unikke på tværs af hele fastcomments.com
Simple SSO kan automatisk oprette og opdatere SSO-brugere, hvis der angives en e-mail, og brugeren ikke oprindeligt blev oprettet fra Secure SSO.
Du kan angive badges for brugeren med egenskaben badgeConfig. Arrayet badgeIds indeholder ID'erne for badges, der skal tilknyttes brugeren. Hvis override er sat til true, vil det erstatte alle eksisterende badges, der vises på kommentarer; hvis false vil det blive føjet til de eksisterende badges.

Tilpassede integrationer - migrering fra Disqus SSO

De største forskelle mellem Disqus og FastComments Secure SSO er, at Disqus bruger SHA1 til kryptering, mens vi bruger SHA256. Dette betyder, at migrering fra Disqus er nem - skift den anvendte hashing-algoritme fra SHA1 til SHA256 og opdater property-navnene, der sendes til UI.

Tilpassede integrationer - migrering fra Commento SSO

Commento bruger en drastisk anderledes SSO-tilgang - de kræver, at du har et endepunkt, som de kalder for at autentificere brugeren.

FastComments gør det omvendt - kod og hash blot brugerens oplysninger ved hjælp af din hemmelige nøgle og send dem videre.

Beskytte kommentartråde med Single Sign-On

FastComments SSO (detaljer her) giver dine brugere mulighed for at kommentere uden at skulle logge ind på en anden platform.

Denne funktion alene sikrer dog ikke dine kommentartråde, da kommentardata som standard er offentligt tilgængelig information - enhver, der kan se siden, kan se kommentarerne.

Ved at ændre en indstilling kan vi forhindre, at kommentarer hentes, medmindre det er af en administrator eller en gyldig SSO-bruger.

No-Code Setup

Vi kan forhindre visning og interaktion med vores kommentartråde, når SSO er opsat, ved at oprette en tilpasningsregel.

Søg efter SSO, og du vil finde denne mulighed:

Require SSO To View Comments

Aktivér den og gem tilpasningsreglen.

Only Protect a Certain Domain or Page

For kun at beskytte et bestemt domæne eller en bestemt side, konfigurerer vi simpelthen tilpasningsreglen til dette.

Øverst i tilpasnings-UI'et finder vi to inputfelter, Domain og URL ID.

For kun at beskytte et bestemt domæne, indtast det pågældende domæne i feltet "domain".

For at beskytte en bestemt side, indtast en side-URL i feltet "URL ID". Hvis du har en brugerdefineret integration med FastComments, kan du i stedet for en URL indtaste en type ID her.

Security Levels

Når du kræver SSO, skal du beslutte, om du kræver Simple SSO eller Secure SSO. Hvis du kræver Simple SSO, så er begge tilladt, men hvis du kræver Secure SSO, skal indholdet hentes med et Secure SSO-payload, der er hashet med din API-nøgle for at kunne blive vist.

Sikkerhedsniveauindstillingen vises, når du vælger "Require SSO To View Comments".

Protection Beyond Reading

Aktivering af denne indstilling vil beskytte siden eller domænet fra at blive kommenteret på, medmindre brugeren er logget ind via SSO.

Gotchas

Brugere, der oprettede kommentarer før din SSO-integration, vil ikke kunne se dem, medmindre de logger ind via din SSO-integration.

Tillad anonym kommentering

Som standard kræver FastComments en e-mail for at kommentere. Det behøver ikke at være en gyldig e-mail, men indtil brugeren klikker på et link sendt til dem, vil deres kommentar vise etiketten "Uverificeret kommentar".

Vi kan dog fjerne krav om e-mail. E-mailindtastningsfeltet vil stadig blive vist, men det vil ikke længere være obligatorisk.

Dette kan konfigureres via widget-tilpasningsgrænsefladen:

Enabling Anonymous Comments

Forhindre at anonyme kommentarer udløber

FastComments kan konfigureres til at fjerne uverificerede kommentarer efter et ønsket antal dage. Dette hjælper med at bekæmpe spam.

Som standard gør det ikke.

Dette kan konfigureres, eller deaktiveres, via Moderationsindstillinger-siden.

Moderation Settings

Deaktivere e-mailindtastning

Når brugere kommenterer og ikke er logget ind, bliver de bedt om at angive deres e-mail.

Dette vil oprette en "uverificeret session" for den bruger, og vi vil bede dem om at bekræfte den session via e-mail.

For nogle websteder eller applikationer er det ønskeligt ikke at bede brugeren om deres e-mail, når de kommenterer eller stemmer.

Aktivering af anonyme kommentarer gør e-mailindtastningsfeltet valgfrit. Vi kan dog deaktivere det helt. Først skal du aktivere anonyme kommentarer, og så vil muligheden for at deaktivere e-mailindtastningsfelterne dukke op.

Disable Email Inputs

Med dette slået til vil e-mailfelterne overhovedet ikke blive vist i nogen af vores kommenteringsprodukter.

Bemærk, at med denne konfiguration vil alle kommentarer være uverificerede, medmindre brugeren opretter en konto og logger ind på https://fastcomments.com.

Du vil måske overveje at deaktivere mærket for uverificerede.

Deaktivere etiketten 'uverificeret'

Som standard viser FastComments en etiket "Uverificeret kommentar" for kommentarer, der er efterladt til en bruger, som har en uverificeret browser-session. Læs mere om uverificeret kommentering her.

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>

Derudover kan denne funktion bruges uden at skrive kode i Tilpasnings-UI'en:

Disable The Unverified Label

Tillad anonym afstemning

Når brugere forsøger at stemme på en kommentar, og de ikke er logget ind, vil de blive bedt om at angive deres brugernavn og e-mail.

Vi kan fjerne dette krav, så alle kan stemme på en kommentar uden at efterlade nogen oplysninger.

Allow Anonymous Votes

Indstille et standardbrugernavn

Når brugere kommenterer eller stemmer, og de ikke er logget ind, vil de blive bedt om at angive deres e-mail og brugernavn.

I tilfælde af anonym kommentering kan det nogle gange være ønskeligt at definere et standardbrugernavn for at reducere friktionen ved kommentering. Dette kan gøres fra Tilpasnings-UI'et. Anonym kommentering skal være aktiveret først.

Setting The Default Username

Callbacks

Alle biblioteker for kommentars-widgeten (i øjeblikket Angular, React, Vue) understøtter callbacks.

Callbacks angives i konfigurationsobjektet, med samme signatur for hvert bibliotek.

De understøttede callbacks er:

onInit
onAuthenticationChange
onRender
commentCountUpdated
onReplySuccess
onVoteSuccess
onImageClicked
onOpenProfile
onCommentSubmitStart
onCommentsRendered

De præcise signaturer kan findes i TypeScript definitions.

Her er et eksempel med alle callbacks i brug:

Eksempler på 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 for at forhindre standardadfærden (åbning af fastcomments.com-brugerprofil).
        },
        onCommentSubmitStart: function(comment, continueSubmitFn, cancelFn) {
            console.log('Trying to submit comment', comment);
            setTimeout(function() { // efterligner asynkron adfærd (kalder API osv).
                if(confirm('Should submit?')) {
                    continueSubmitFn();
                } else {
                    cancelFn('Some optional error message');
                }
            }, 1000);
        },
        onCommentsRendered: function(comments) {
            // comments er sorteret efter standardsorteringen på siden, som kan være 'Mest relevante' (f.eks. mest opstemte, osv.), eller 'Nyeste først'
            const topCommentInList = comments[0];
            console.log('First Comment Rendered:', topCommentInList.avatarSrc, topCommentInList.commenterName, topCommentInList.commentHTML);
        }
    });
</script>

Manuelt definere brugerens lokalitet

Som standard viser FastComments kommenteringswidgeten i den locale, der bestemmes af brugerens system og browser.

Når en bruger kommenterer eller logger ind, opdaterer vi deres sidst anvendte locale og bruger denne til også at sende e-mails.

Dette påvirker, hvordan kommenteringswidgeten oversættes for brugeren. Locale består af brugerens sprog og region, så konfiguration af locale vil normalt ændre det sprog, der bruges til at vise tekst for brugeren.

Via brugergrænsefladen

Dette kan defineres ved hjælp af widgetens tilpasnings-UI. Se indstillingen "Locale / Language":

Changing The Locale / Language

Via kode

Dette kan tilsidesættes med en ønsket 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>

Understøttede sprog og locale-koder

Du kan finde den komplette liste over understøttede sprog og de tilsvarende locale-koder her.

Bemærkning vedr. SSO

Hvis du bruger SSO, vil du måske sende brugerens locale i brugerobjektet, så e-mails og andre ting bliver korrekt lokaliseret for dem.

Begrænse tilladte sprog

Som standard begrænser FastComments ikke de sprog, der bruges til at kommentere.

Det kan være ønskeligt at begrænse de sprog, et fællesskab bruger.

Dette kan konfigureres uden kode på siden til tilpasning af widgeten:

Allowed Languages

Systemet vil analysere kommentaren og bestemme sproget, og derefter sammenligne det med den tilladte liste.

Hvis kommentaren er skrevet på et sprog, der ikke er tilladt, vises en lokaliseret fejlmeddelelse.

Sidetitler

Den aktuelle sidetitel er knyttet til den angivne urlId og gemmes til brug i moderationsværktøjer.

Som standard hentes denne fra document.title.

Hvis du ønsker det, kan du angive din egen sidetitel som følger:

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>

Forhindre nye svar og deaktivere stemmer

Kommentering kan låses, så der ikke kan efterlades nye kommentarer eller stemmer ved at sætte readonly-flaget til true.

Kommentarer vil også ikke kunne redigeres eller slettes.

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>

Dette kan tilpasses uden kode, på widget-tilpasningssiden, for et helt domæne, eller en side:

Making The Comment Thread Readonly

Opdatering!

Fra november 2022 kan tråde låses eller låses op live af administratorer og moderatorer via tre-punkts-menuen over svarområdet.

Dette vil forhindre nye kommentarer, mens stemmegivning stadig er tilladt, og brugere kan slette deres kommentarer, hvis de ønsker det, mens readonly ikke tillader disse ting.

Dette svarer til feltet isClosed i Page API'en.

Begrænsning af linkdomæner

Som standard tillader FastComments links til enhver ekstern side.

Dette kan begrænses til i stedet en ønsket liste over sider eller domæner. Forsøg på at indsende et link til en side eller et domæne, som ikke er på den definerede liste, vil få vist en fejl for brugeren.

Denne validering gælder kun for Kommentar-widgeten og API'en. Importer påvirkes ikke.

Dette gøres uden kode, på widget-tilpasningssiden:

Restrict External Link Domains

Kommentarantal og optælling af alle indlejrede svar

Antallet af kommentarer, der vises øverst i kommentar-widgetet, kan enten vise alle "top-level" kommentarer, altså de svar, som er direkte svar på siden eller artiklen selv, eller det kan være et tal for alle indlejrede kommentarer.

Som standard er dette true - det er et optælling af sidstnævnte - alle kommentarer. I ældre versioner af kommentar-widgetet var standardværdien false.

Vi kan ændre adfærden, så den tæller alle indlejrede kommentarer ved at sætte countAll-flaget til true.

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>

Hvis vi ønskede, at optællingen kun skulle afspejle topniveau-kommentarer, sætter vi flaget til 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>

Dette kan i øjeblikket ikke tilpasses uden kodeændringer.

Aktivere links til kommentatorer

Som standard vil FastComments kun bede brugeren om deres kommentar, deres brugernavn og deres e-mail.

I nogle situationer vil du dog måske have, at brugeren efterlader et link til deres egen blog eller hjemmeside.

Vi kan aktivere visningen af et ekstra inputfelt til brugerens websteds-URL ved at sætte flaget enableCommenterLinks til true:

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>

Når den nævnte URL angives, opdateres brugerens konto, og alle deres brugernavne på tidligere og fremtidige kommentarer vil linke til denne URL.

Dette kan tilpasses uden kode på siden til widget-tilpasning:

Enabling Commenter Links

Moderationsgrupper

En liste over id'er genereret fra Moderationsgrupper siden.

Når det er angivet, vil kommentarer, der afgives med den specificerede konfiguration, indeholde det samme sæt moderationGroupIds.

Hvis en Moderator har en eller flere Moderationsgrupper defineret, vil de kun se kommentarer på siden Moderate Comments, som er tilknyttet deres gruppe(r).

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>

Nævn gruppe-id'er

En liste med id'er til brug for @mentions autokomplettering. Nyttigt, når du vil forhindre at tagge brugere, hvis de ikke har overlappende grupper.

Når det er angivet, vil kun brugere i andre grupper blive vist i autokompletteringen efter at have skrevet @-tegnet.

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>

For authentication, FastComments depends on third party cookies to be enabled in your browser. Without them, users will always have to leave their email to comment (unless the email input field is hidden), and their comments will always show as unverified (by default).

Til autentificering er FastComments afhængig af, at tredjepartscookies er aktiveret i din browser. Uden dem vil brugere altid skulle angive deres e-mail for at kommentere (medmindre e-mailinputfeltet er skjult), og deres kommentarer vil som standard altid blive vist som uverificerede.

To get around this, you can enable the third party cookie bypass.

For at omgå dette kan du aktivere omgåelse af tredjepartscookies.

When this setting is enabled, it will cause a small popup that shows a message saying the user is being logged in. This popup shows whenever the user interacts with the comment widget; for example, if they leave a comment.

Når denne indstilling er aktiveret, vil den udløse et lille popup-vindue, der viser en besked om, at brugeren logges ind. Dette popupvindue vises hver gang brugeren interagerer med kommentarboksen; for eksempel hvis de efterlader en kommentar.

We can do this in code by setting the enableThirdPartyCookieBypass flag to true:

Det kan vi gøre i koden ved at sætte flaget enableThirdPartyCookieBypass til true:

We can also set this up via the Widget Customization UI, under Enable Third-Party Cookie Popup:

Vi kan også sætte dette op via Widget-tilpasnings-UI'en under Enable Third-Party Cookie Popup:

Enabling Third-Party Cookie Bypass

Slette kommentarer med svar

Som standard kan brugere slette deres egne kommentarer. Desuden medfører sletning af deres kommentar automatisk sletning af alle underordnede og midlertidige kommentarer i tråden. Denne adfærd gælder også i live-miljøet.

Du kan begrænse dette på følgende måder:

I stedet anonymiser den slettede kommentar (sæt navn og tekst til [deleted] eller en brugerdefineret værdi).
Tillad ikke sletning af kommentarer, når der er svar. En tilpasset fejlmeddelelse vises.
Begræns sletning, når en kommentar har svar, til kun administratorer og moderatorer.

Dette kan konfigureres via Comment Thread Deletion-sektionen i Widget Customization UI.

Customize Delete Behavior for Replies

Vis badges i topbjælken

Som standard viser FastComments bruger-badges kun på deres kommentarer i kommentarsamtalen.

Vi kan dog vise bruger-badges ved siden af deres navn over kommentarfeltet ved at aktivere denne funktion på siden til tilpasning af widgeten:

Show Badges in Top Bar Option

Dette viser brugerens badges ved siden af deres navn i topbjælken, så deres præstationer og status fremhæves, når de skriver en kommentar.

Bemærk, at denne funktion skal være aktiveret i widgetens tilpasnings‑UI for at fungere. Du kan valgfrit sætte flaget showBadgesInTopBar til false i din kodekonfiguration for selektivt at deaktivere det, selv når det er slået til på serverniveau:

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>

Forrige guide Næste guide

Sprog 🇩🇰 Dansk

Grundlæggende

Udseende og design

Live-kommentering

Pagination & Sorting

Svarboksen

SSO

Anonym kommentering

Misc

Tilpasninger og konfiguration

Kontekst

Identificering af din konto

Hvordan kommentarer er knyttet til sider og artikler

Faldgruber

Visning af de samme kommentarer på forskellige sider

Brugerdefineret styling

External CSS Files

In Code - Not Recommended

User Profile Modal Styling

Backwards Compatibility

Brugerdefinerede skrifttyper

Sådan defineres skrifttypen

Fjern branding

Understøttelse af mørke baggrunde (mørk tilstand)

Skifte mørk tilstand

Overskrive tekst

Ændre standardavatar

Deaktivere avatarer

Deaktivere alle standardstilarter

Linke fra kommentarer til sider

Sammenklap svar som standard

Aktivere WYSIWYG

Deaktivere værktøjslinjen

Deaktivere blokering

Bestemme hvilken side der skal gengives

Skifte kommentartråde uden at genindlæse siden

Angular, React, Vue, osv.

VanillaJS

Absolutte datoer (deaktiver menneskevenlige tidsstempler)

Vis både absolutte og relative datoer

Tilføje overskriftstekst

Gengive links som tekst

Skifte kommentarer med en knap

Tilpasse tekst for antallet af kommentarer

Deaktivere billedomdirigering

Deaktivere automatisk oprettelse af hashtags

Deaktivere notifikationsklokke

Deaktivere profiler

Deaktivere succesmeddelelse

Ændre indholdsvurdering af GIF'er

Moderering af billedindhold

Ændre stemmestil

Deaktivere sletning

Deaktivere redigering

Fremhæve nye kommentarer

Sidestørrelser

E-mail-skabeloner

Formater for brugernavne

Deaktivere billeduploads

Aktivere søgefelt

Aktivere spoilers

Aktivere visningsantal for kommentarer

Vis live-kommentarer med det samme

Deaktivere live-kommentering

Nye live-kommentarer nederst

Aktivere uendelig rulning

Ændre standard sorteringsretning

Gengiv alle kommentarer på én gang - deaktiver paginering

Flyt svarboksen til efter kommentarerne

Begrænse kommentarens længde

Deaktivere multiline-kommentarer

Begræns antal kommentarer per bruger

Forhindre nye topniveau-kommentarer

Maksimal svardybde

Oversigt over Single Sign-On (SSO)

How do I get it?

User and Comment Migrations

WordPress Users

WordPress SSO - Moderators

Custom Integrations