Tilpasninger & Konfiguration

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 du gengiver en kommentartråd, eller efterlader en kommentar, skal FastComments vide, hvilken side, artikel eller produkt de kommentarer tilhører.

For at gøre 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 den blive sidens URL. Vi tager den aktuelle sides URL og renser den for at fjerne eventuelle almindelige marketingparametre eller sporingsidentifikatorer.

I tilfælde af tredjepartsintegrationer, som WordPress, vil vores plugin normalt bruge den identifikator, der repræsenterer den aktuelle information, der vises, som URL ID, for eksempel artikel-/side-id'et.

Definere en brugerdefineret 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>

En ting, vi ofte vil referere til i dette dokument, er Widget-tilpasnings‑UI.

Dette UI kan bruges til at foretage mange ændringer af kommentarfunktionen uden at bruge kode.

Når du opretter en tilpasningsregel, vil vi ofte have den til at gælde for alle sider på vores site. I nogle tilfælde vil vi dog tilpasse kommentarfunktionen på en bestemt side, enten for at anvende brugerdefineret styling eller måske gøre kommentarer for den pågældende side anonyme. Du kunne også for eksempel få live‑kommentarer til at vises med det samme på nogle sider, mens de skjules under notifikationsknapper på andre.

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

URL ID-indtastning på widget‑tilpasningssiden

URL ID-feltet bruges til at afgrænse en tilpasningsregel til én side eller til et mønster såsom */blog/*

Værdien i dette felt skal matche urlId-parameteren, der sendes til kommentarfunktionen. Hvis du vil have din tilpasningsregel til at være urlId-agnostisk, så lad dette felt stå tomt eller indtast *.

Fra 2023 accepterer URL ID-feltet i widget‑tilpasning nu også mønstre! For eksempel kan du have */blog/* for at tilføje styling specifik for din blog og */store/* for at have styling specifik for din butik, alt sammen mens du bruger 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.
Under migrationer, for eksempel fra WordPress til Gatsby, kan du blive nødt til at migrere URL ID‑kommentarværdierne efter den første migration. I så fald kan du kontakte os.

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>

Tilpasset styling

FastComments er designet til at kunne tilpasses. Kommentar-widget'en kører i en iframe af sikkerhedsmæssige årsager, så for at anvende brugerdefineret styling skal du følge én af to fremgangsmåder.

Den første, den letteste fremgangsmåde, og den vi foretrækker, er at bruge widget customization page.

På widget-tilpasningssiden, se sektionen "Show Advanced Options", hvor der er et område mærket "Custom CSS":

Custom CSS-indtastningsområde

Custom CSS-editor under Vis avancerede indstillinger på widget-tilpasningssiden

Denne fremgangsmåde har nogle fordele:

Den indtastede CSS minimeres, før den sendes til brugeren, og formateringen holdes konsistent i redigerings‑UI’et.
Du får alle fordelene ved widget‑tilpasnings‑UI’et, f.eks. nem tilpasning af kommentar‑widget’en forskelligt for forskellige sites.
Når vi laver ændringer i kommentar‑widget’en, vil din brugerdefinerede styling blive testet som en del af vores udgivelsesproces.

Den anden fremgangsmåde er at angive customCSS‑parameteren i widget‑konfigurationen, som følger:

Overførsel af 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 custom CSS der kan sendes, før vores servere afviser anmodningen, på grund af header‑størrelsen.
Du skal selv håndtere den brugerdefinerede CSS i din infrastruktur og dit build‑system. Dette kan også være en fordel snarere end 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 minimere CSS’en for at reducere dens størrelse over netværket, men med denne fremgangsmåde skal du selv håndtere det.
Din brugerdefinerede CSS vil ikke blive testet, når vi laver ændringer.

Eksterne CSS-filer

Du kan fortælle widget'en at hente en ekstern fil ved at bruge @import!

Det anbefales at placere @import i en tilpasningsregel. På den måde kan vi, hvis vi nogensinde skal foretage en ændring i kommentar‑widget'en, bruge vores automatiserings‑værktøjer til at verificere din opsætning. Så for eksempel ville du oprette en tilpasningsregel i Widget‑Customization‑UI’et, klikke på Advanced og indtaste i Custom CSS:

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

I kode - Ikke anbefalet

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

Ekstern CSS-fil

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>

Men husk, at din CSS ikke vil kunne blive testet af os, hvis du gør dette.

Styling af brugerprofilmodal

Brugerprofil‑modaler kan også styles med custom CSS. For at sikre, at brugerdefineret styling anvendes på brugerprofiler, skal alle CSS‑selektorer være forudgået af .user-profile. Uden dette præfiks vil brugerdefineret styling blive ignoreret for brugerprofil‑modaler.

For eksempel:

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

Bagudkompatibilitet

Hos FastComments ved vi, at vores kunder tilpasser kommentar‑widget'en. Det er med vilje – det sidste, vi ønsker, er at vores produkt forårsager design‑inkonsistens 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 i kommentar‑widget'en per kunde ved hver udgivelse.

Hvis vi finder mindre problemer, vil vi opdatere din konto for at sikre, at udgivelsen forløber glat. Hvis vi ser større, kritiske ændringer, giver dette os mulighed for at stoppe udgivelsen.

Tilpassede 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;
}

Fjernelse af 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>

Skift mellem mørk tilstand

For sider, der tillader at skifte dark mode efter den indledende sideindlæsning, er dette lidt mere kompliceret.

Først indeholder alle aktuelle versioner af Comment widget-biblioteket (React, Vue) eksempler på at skifte dark mode i deres respektive repositories.

For VanillaJS-widgetten skal vi lave lidt mere arbejde. Først returnerer FastCommentsUI et objekt med funktionerne "destroy" og "update".

Vi kan simpelthen kalde update-funktionen, hver gang vi vil opdatere comment widget-konfigurationen, som følger. Her er et komplet fungerende eksempel på at skifte dark mode med VanillaJS-widgetten.

Komplet eksempel på skift af Dark Mode

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 kommentarfunktionen tilpasses.

Du kan tilsidesætte et enkelt stykke tekst, som f.eks. send‑knappen, eller al tekst i hele kommentarfunktionen.

Som standard oversættes teksten i kommentarfunktionen baseret på brugerens locale. Men vi kan tilsidesætte teksten, hvis vi er sikre på, at vores brugerbase bruger den samme locale/sprog, for eksempel:

Tilpasset tekst

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 tilpasselige oversættelser kan findes her under fanen "avancerede indstillinger".

Der er dog en nemmere måde via widget‑tilpasnings‑UI'en. Der kan vi blot finde den tekst, der vises i kommentarfunktionen i EN_US‑locale, og angive en erstatning.

Tilpasset tekst

Alle oversættelses‑overrides påvirker i øjeblikket alle locale.

Dette dækker widgetens egen tekst. For at oversætte de kommentarer, dine besøgende skriver, se Comment Translation.

Ændring af standardavatar

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

Hvis vi dog ikke finder en avatar, eller brugeren aldrig indstiller en i deres konto, viser vi et statisk standardavatarbillede.

For at angive dit eget statiske avatarbillede kan du 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å widget-tilpasningssiden, se sektionen "Default Avatar".

Tilpasning af standardavatar

Bemærk, at definition af avataren for en bestemt bruger, som med SSO, er dækket i sin egen sektion.

Deaktivering af avatarer

Avatarer kan fjernes helt fra kommentar-widgeten, selvom brugerne har defineret deres egen avatar.

Skjuler avatarer

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:

Skjuler avatarer

Skjul avatarer-indstillingen på widget-tilpasningssiden, som fjerner alle avatarer fra kommentar-widgeten

Deaktivering af alle standardstile

For større tilpassede stylingprojekter kan det være ønskeligt at starte med en ren tavle og slet ikke bruge standardstylingen.

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

Deaktivering af alle standardstilarter

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å widgettilpasningssiden under Avancerede indstillinger:

Deaktivering af alle standardstilarter

Deaktiver alle standardstilindstillingsafkrydsningsfelt aktiveret under Avancerede indstillinger på widgettilpasningssiden

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

Sammenfold svar som standard

Som standard vises svar på top‑niveau kommentarer.

Dette kan konfigureres, så brugeren skal klikke på "Show Replies" på top‑niveau kommentarer for at se svarene.

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å widget‑tilpasningssiden:

Skjul svar

Mulighed for at skjule svar i widget‑tilpasnings‑UI'et, som gemmer underkommentarer bag et "Show Replies"-link

Denne indstilling påvirker ikke antallet af top‑niveau kommentarer, der indlæses initialt. Hvis du har én top‑niveau kommentar og 29 svar, vil du med denne indstilling:

Se top‑niveau kommentaren.
Se "Show Replies" (29) under denne kommentar.

Hvis du ønsker at vise alle top‑niveau kommentarer i kombination med denne mulighed, skal du sætte starting page to -1.

Aktiver WYSIWYG

Som standard udføres formateringsfunktionerne i FastComments ved at tilføje synlige anker‑tags som <b></b> omkring din tekst. Når du klikker på værktøjslinjen eller bruger genveje, sker dette automatisk. Nogle fællesskaber kan dog ønske at bruge formatering uden anker‑tags. Dette kaldes at aktivere WYSIWYG‑editoren (what you see is what you get). Denne editor ser nøjagtig ud som standardeditoren, men indlæser ekstra kode, så brugere kan gøre deres tekst fed, understreget osv. uden synlige anker‑tags.

Aktivering af WYSIWYG-redigering

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, se indstillingen "Enable Advanced Formatting".

Aktiver WYSIWYG

Widget-tilpasningsside med Enable Advanced Formatting afkrydsningsfeltet markeret for at aktivere WYSIWYG-editoren

Som standard vil FastComments vise en værktøjslinje, når du skriver en kommentar, for at give genveje til at dekorere tekst og uploade billeder.

Denne værktøjslinje kan deaktiveres i kode eller med tilpasnings‑UI'en.

Deaktivering af værktøjslinjen

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",
    "disableToolbar": true
}];
</script>

Dette kan også gøres uden kode. På widget‑tilpasningssiden, se indstillingen "Disable The Reply Toolbar".

Deaktivering af værktøjslinjen

Widget tilpasningsside med afkrydsningsfeltet "Disable The Reply Toolbar" markeret for at fjerne formateringsgenveje

Deaktivering af blokering

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

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

Deaktiver blokering

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å muliggør korrekt server‑side validering, via Widget‑tilpasnings‑UI'en:

Deaktiver blokering

Bestemmelse af hvilken side der skal vises

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.

Skift kommentarfærd 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.

Brug absolutte datoer

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å widget-tilpasningssiden under Avancerede indstillinger:

Brug absolutte datoer

Avancerede indstillinger på widget-tilpasningssiden med den absolutte dato-tilstand slået til

Vis både absolutte og relative datoer

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 beholde dette relative datoformat, men også vise den fulde dato ved siden af, i så fald sætter du denne parameter til true.

Brug både absolutte og relative datoer

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å widget-tilpasningssiden under Avancerede indstillinger. Du skal først aktivere Absolutte datoer for at se denne indstilling i brugergrænsefladen.

Brug både absolutte og relative datoer

Avancerede indstillinger på widget-tilpasningssiden med både absolutte datoer og den kombinerede relative datoindstilling aktiveret

Tilføjelse af overskriftstekst

Nogle tekst, som en overskrift eller besked, kan vises under kommentarantallet men over login-status-teksten.

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

Angivelse af 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:

Angivelse af Header HTML

Avancerede indstillinger område på widget-tilpasningssiden hvor brugerdefineret header HTML indtastes

Vis links som tekst

Som standard vil FastComments gengive links som dette: https://exmaple.com - hvor link-URL'en bliver et klikbart HTML-ankertag.

Nogle sites 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:

Gengiv links som tekst

Comment HTML Rendering Option sat til Links as Text under Avancerede indstillinger i widget-tilpasning

Skift kommentarer med en knap

Som standard vil FastComments gengive kommentarfeltet og kommentartråden på samme tid. For at spare noget lodret plads, vil den også skjule eventuelle andre påkrævede felter, indtil widget'en interageres med.

Dog kan kommentarswidget'en skjules bag en knap, for eksempel:

Klik for at vise kommentarer

Kommentarswidget kollapset bag en knap, der viser kommentarantallet, indtil en læser klikker på den

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

Klik for at vise eller skjule kommentarer

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 hideCommentsUnderCountTextFormat-konfigurationen.

Antallet opdateres live med kommentartråden. Knapperne vises ikke, hvis der ingen kommentarer er.

Dette kan aktiveres uden kode ved at oprette en tilpasningsregel og aktivere "Klik for at vise kommentarer":

Aktiver Klik for at vise kommentarer

Klik for at vise kommentarer afkrydsningsfelt markeret i en tilpasningsregel på widgetens tilpasningsside

Tilpasning af kommentarantal-tekst

Kommentarantallet, der vises øverst i kommentarfunktionen, kan tilpasses.

Dette kan erstattes med en vilkårlig streng, og værdien [count] vil blive erstattet med antalsværdien, lokalt for brugeren.

Tilpasning af kommentarantalleteksten

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å siden for widgettilpasning:

Tilpasning af kommentarantalleteksten

Tekstfelt for kommentarantal på siden for widgettilpasning, hvor [count] erstattes med den aktuelle total

Deaktiver 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å.

Deaktiver automatisk oprettelse af hashtags

Når brugere indtaster hashtags i formen #someexampletag, vil FastComments automatisk oprette den HashTag og fremhæve den 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 Customization UI.

Deaktivering af automatisk HashTag-oprettelse

Deaktivér automatisk #hashtag Oprettelse indstilling aktiveret i widget-tilpasnings UI

Deaktiver notifikationsklokke

Som standard viser FastComments en notifikationsklokke i øverste højre hjørne af kommentarfeltet.

Denne klokke vil blive rød og vise et antal af de notifikationer, brugeren har. Nogle eksempler på notifikationer er:

Bruger svarede dig.
Bruger svarede i en tråd, du har kommenteret i.
Bruger gav din kommentar en positiv stemme.
Bruger svarede på en side, du har abonneret på.

Notifikationsklokken giver også en mekanisme til at abonnere på en hel side.

Vi kan dog deaktivere notifikationsklokken helt:

Deaktiver notifikationsklokke

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å widget-tilpasningssiden, se afsnittet "Deaktiver notifikationsklokke".

Deaktiver notifikationsklokke

Deaktiver profiler

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

Vi kan dog deaktivere denne funktionalitet:

Deaktiver profiler

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, se afsnittet "Deaktiver profiler".

Deaktiver profiler

Deaktiver profilkommentarer

Som standard vil FastComments vise en "Profilkommentarer"-faneblad på brugerprofiler, så besøgende kan efterlade kommentarer på en persons profil.

Men vi kan deaktivere dette faneblad:

Deaktiver profilkommentarer

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",
    "disableProfileComments": true
}];
</script>

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

Deaktiver profilkommentarer

Deaktiver direkte beskeder i profiler

Som standard vil FastComments vise en "Direkte beskeder" faneblad på brugerprofiler, så besøgende kan sende direkte beskeder til en bruger.

Vi kan dog deaktivere dette faneblad:

Deaktiver direkte beskeder på profil

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",
    "disableProfileDirectMessages": true
}];
</script>

Dette kan også gøres uden kode. På widget-tilpasningssiden, se sektionen "Deaktiver direkte beskeder".

Deaktiver direkte beskeder på profil

Widget-tilpasningsside med afkrydsningsfeltet Deaktiver direkte beskeder markeret for at skjule fanebladet med profilbeskeder

Deaktiver succesmeddelelse

Som standard viser FastComments en succesmeddelelse efter at have kommenteret. 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å widget-tilpasningssiden:

Deaktiver succesmeddelelse

Ændring af indholdsvurdering for GIF'er

Som standard vil FastComments-kommentarwidgetten sætte en gif rating til 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 finder du dette under Gif Picker Rating, så længe Disable Image Uploads? ikke er markeret.

Indstilling af Gif Rating

Gif Picker Rating dropdown på widget-tilpasningssiden, der tilbyder g, pg, pg-13 og r

Billedindhold moderation

Som standard har FastComments-kommentarwidgeten billedindholdsmoderation slået off.

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

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

Indstilling af Image Content Moderation Level

Image Content Moderation Level dropdown på widget-tilpasningssiden sat til off, low, medium eller high

Ændring af afstemningsstil

Som standard vil FastComments gengive afstemningsmuligheder som op- og ned-pile, så brugerne kan enten op- eller nedstemme en kommentar.

Det er dog muligt at ændre stilen på afstemningsværktøjslinjen. De aktuelle muligheder er standard Op/Ned-knapperne eller at bruge en hjerte‑stil afstemningsmekanisme.

Vi bruger voteStyle‑flaget som følger:

Aktiver hjerteknap

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 server‑side valideringer. På widget‑tilpasningssiden, se sektionen "Vote Style".

Skift afstemningsstil

Afstemningsstil-indstilling på widget‑tilpasningssiden, der tilbyder op- og ned-pile eller hjerteafstemning

Afstemning kan også deaktiveres, se Disable Voting over stilindstillingerne.

Deaktiver sletning

Som standard tillader FastComments brugere at slette deres kommentarer.

Det er dog muligt at forhindre dette.

På widget-tilpasningssiden kan du se indstillingen "Disable Deleting".

Deaktivér sletning af kommentarer

Disable Deleting-indstillingen på widget-tilpasningssiden, som forhindrer kommentatorer i at fjerne deres kommentarer

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

Deaktiver redigering

Som standard vil FastComments tillade brugere at redigere deres kommentarer.

Det er dog muligt at forhindre dette.

På widget-tilpasningssiden, se indstillingen "Disable Editing".

Deaktiver kommentarredigering

Deaktiver redigering-indstillingen på widget-tilpasningssiden, som forhindrer kommentatorer i at redigere deres kommentarer

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 bliver videregivet.

Fremhævning af 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 Configuration UI i varierende størrelser fra 10 til 200.

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

Dette kan ikke konfigureres i klient‑side widgeten, da sider beregnes på server‑siden.

Eksempelkonfiguration vises nedenfor:

Tilpassede sidestørrelser

Side størrelse vælger på widget‑tilpasningssiden, hvor en værdi fra 10 til 200 kan vælges

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

Dette vil påvirke alle klienter, integrationer og frameworks, 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.

Brugernavnsformater

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

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

Dette kan gøres uden kode i Widget‑tilpasnings‑UI’en, under indstillingen kaldet Commenter Name Format:

Skift navneformat

Commenter Name Format dropdown åbnet med valg som Capitalize, Last Initial og All Initials

De tilgængelige formater er:

Capitalize (vis eksempelbruger som Example User)
Last Initial (vis Example User som Example U.)
All Initials (vis Example User som E. U.)
Vis "Anonymous"

Effekten af at ændre dette er øjeblikkelig. Brugere vil stadig se deres fulde brugernavn øverst i kommentarfeltet for sig selv, men deres kommentarer vil vise det modificerede brugernavn.

Brugernavne maskeres på serveren for at beskytte brugerne.

Deaktivering af billeduploads

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

Deaktivering af billeduploads

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å widget-tilpasningssiden:

Deaktivering af billeduploads

Deaktiver billeduploads afkrydsningsfeltet slået til i widget-tilpasningssidens indstillinger

Tillad medieindlejringer

Som standard tillader FastComments ikke iframes i kommentarer. Når du aktiverer medie-indlejringer, kan kommentatorer indsætte embed-koden (<iframe>-uddraget) fra betroede udbydere som YouTube, Vimeo, SoundCloud og Spotify, og den vil blive vist inline i kommentaren.

Af sikkerhedsmæssige årsager er dette ikke et client-side widget-konfigurationsflag. Det er en server-side indstilling, der valideres, hver gang en kommentar gemmes, så den kan ikke aktiveres fra siden. Kun iframes, der peger på en indbygget liste over betroede udbydere, tillades. Alle andre iframes fjernes.

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

Tillad medie-indlejringer

Indstillingen for medie-indlejringer aktiveret på widget-tilpasningssiden, så kommentatorer kan indsætte betroede iframe-embeds

Tilføj dine egne udbydere

Hvis du vil tillade indlejringer fra en udbyder, der ikke er på den indbyggede liste over betroede, skal du tilføje dets hostname i feltet "Additional Embed Domains" på samme side. Disse hostnames tillades ud over de indbyggede udbydere. Matchingen er eksakt, så inkluder det fulde hostname (for eksempel player.example.com). Alt, hvad du ikke angiver, forbliver blokeret.

Både den almindelige kommentarboks og WYSIWYG-editoren understøtter indsættelse af en embed. I WYSIWYG-editoren indsættes embed'en som en blok, der kan fjernes.

Aktiver søgeboks

Som standard vises der ingen søgeboks i kommentarfunktionen.

Vi kan dog aktivere dette ved at sætte enableSearch-flaget 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 widget-tilpasning, se indstillingen "Enable Search Box".

Aktiver søgeboks

Widget-tilpasningsside med afkrydsningsfeltet Enable Search Box markeret for at vise et søgefelt i widget'en

Aktiver spoilers

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

Aktivering af 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å widget‑tilpasningssiden, se indstillingen "Enable Spoilers" option.

Aktiver Spoilers

Widget‑tilpasningsside med afkrydsningsfeltet Enable Spoilers markeret for at tilføje SPOILER‑knappen til editoren

Når tekst er markeret, 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, men med andre farver, der passer bedre til mørk tilstand.

Dette er også kompatibelt med WYSIWYG‑editoren.

Aktiver visningstællere 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, hvorefter systemet begynder at spore, når hver bruger ruller til en kommentar.

Når dette sker, vil en tæller ved siden af et øjeikon, der vises på hver kommentar, blive forøget. Tælleren opdateres live og forkortes i henhold til brugerens locale.

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

Aktivering af visningstællere for kommentarer

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

Widget customization page with the view counts checkbox checked so each comment shows an eye icon and count

Vi sporer bruger-id'et* der har set kommentaren i en uge, så hvis du ser kommentaren igen inden for den uge, øges tælleren ikke. Hvis du ser kommentaren igen efter ugen er udløbet, vil tælleren blive forøget igen.

*Bemærk: eller den anonyme sessions-id, eller brugerens IP som en hashvæ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 kommentarfæden på samme tid.

Dog vil de nye kommentarer som standard vises under en dynamisk vist knap med tekst, der ligner "Vis 2 nye kommentarer".

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

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

For nogle anvendelsestilfælde, som livebudgivning eller online‑begivenheder, er dette ikke den ønskede adfærd – du vil måske have kommentarfunktionen til at ligne en "chat"-boks, hvor nye kommentarer "vises med det samme".

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

Vi kan aktivere den som følger:

Vis live kommentarer med det samme

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:

Vis live kommentarer med det samme

Indstillingen for at skjule live kommentarer er slået til, så nye kommentarer vises øjeblikkeligt i stedet for bag en knap

Deaktivering af live-kommentarer

Som standard vil FastComments have live-kommentering aktiveret.

Det betyder, at hver bruger af kommentarthreaden skal se det samme indhold.

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

Vi 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 sektionen "Disable Live Commenting".

Deaktiver Live Kommentar

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.

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

Ændring af standard sorteringsretning

Som standard vil FastComments sortere kommentarer efter sorteringsretningen "Most Relevant".

Most Relevant-sortering tager tidspunktet for hvornår kommentaren blev skrevet og antallet af stemmer i betragtning ved sortering.

Brugeren kan derefter ændre sorteringsretningen til enten Oldest eller Newest First i kommentar-widgetens UI.

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

Ændring af standard sortering til ældste først

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 indstille retningen til "OF".

For sorteringsretningen newest-first ville vi gøre følgende:

Ændring af standard sortering til nyeste først

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: "Most Recent"
NF: "Newest First"
OF: "Oldest First"

Dette kan også gøres uden kode. På widget-tilpasningssiden, se sektionen "Default Sort Direction".

Ændring af standard sorteringsretning

Standard sorteringsretning vælger, der tilbyder Most Relevant, Newest First og Oldest First

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

Vis 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 kommentarindtastningsområdet før kommentartråden. Men ved at sætte denne konfigurationsparameter til true kan vi flytte den til efter.

Flyt svarboksen til bunden

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å widget-tilpasningssiden:

Flyt svarboksen til bunden

Widget-tilpasningssideindstilling, der placerer kommentarindtastningsområdet efter kommentartråden i stedet for før den

Begrænsning af kommentarens længde

Det maksimale antal tegn, der må indtastes i kommentarfeltet, kan begrænses af maxCommentCharacterLength-parameteren.

Standardværdien er 2000.

Elementer som billed-URL'er medtages ikke i længdebestemmelsen.

Begræns kommentarlængde

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å widgettilpasningssiden:

Begræns kommentarlængde

Feltet for maksimal kommentarlængde på widgettilpasningssiden, der bruges til at begrænse, hvor mange tegn en kommentar kan indeholde

Deaktiver multiline-kommentarer

Som standard tillader FastComments brugeren at indtaste en kommentar med så mange linjer, som 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 inkluderer onlinebudgivning eller live chat, som FastComments kan bruges til.

Vi aktiverer flaget useSingleLineCommentInput 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å widget-tilpasningssiden, se afsnittet "Aktiver enkeltlinje-kommentarinput".

Aktiver enkeltlinje-kommentarinput

Enkeltlinje-kommentarinput afkrydsningsfelt slået til på widget-tilpasningssiden, begrænser input til én linje

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

Begræns kommentarvolumen pr. bruger

Som standard kan hver bruger indsende op til 5 kommentarer inden for samme minut.

Dette spores via bruger-id, anonym bruger-id og IP-adresse (hashet).

Dette kan tilpasses uden kode på widget-tilpasningssiden:

Begrænsning af kommentarmængde pr. bruger

Maksimalt antal kommentarer pr. minut-feltet på widget-tilpasningssiden, sat til 5 som standard

Bemærk, at hvis du bruger kommentarskabelses-API'en, vil du måske sende brugerens originale ip-adresse i anmodningen til vores backend, så hastighedsbegrænsning anvendes pr. bruger og ikke globalt for din konto.

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 svar-dybde

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.

Kræv accept af servicevilkår

FastComments giver dig mulighed for at kræve, at første‑gangs kommentatorer accepterer dine Servicevilkår, før de indsender en kommentar.

Når aktiveret:

Anonyme brugere vil se en TOS‑afkrydsningsboks hver gang de kommenterer
Godkendte brugere vil kun se afkrydsningsboksen på deres første kommentar, eller når du opdaterer dine TOS

Konfiguration

Naviger til widget‑tilpasningssiden og aktivér afkrydsningsfeltet "Kræv accept af Servicevilkår". Når den er aktiveret, vil du se følgende indstillinger:

Indstillinger for servicevilkår

Servicevilkår-panel, der viser TOS-teksttilstandsvælgeren og feltet for seneste opdateringsdato

TOS Teksttilstand: Som standard viser afkrydsningsboksen "Jeg accepterer Servicevilkårene og Privatlivspolitikken" med links til begge dokumenter. Vælg "Tilpas tekst pr. locale" for at angive din egen tekst for hvert sprog.
TOS Seneste opdateringsdato: Når du opdaterer dine Servicevilkår, angiv denne dato. Brugere, der accepterede før denne dato, vil blive bedt om at acceptere igen.

Sådan fungerer det

TOS‑accept‑tidsstemplet gemmes per‑bruger og per‑kommentar
Når en bruger accepterer TOS, registreres datoen på deres brugerprofil (per‑tenant)
Hvis du angiver en "Seneste opdateret"-dato, der er efter brugerens acceptdato, skal de acceptere igen
For anonyme brugere, som ikke kan spores, vises afkrydsningsboksen ved hver kommentarindsendelse

Advar før du forlader med en usendt kommentar

Som standard, hvis en bruger skriver en kommentar og derefter opdaterer siden, lukker fanen eller navigerer væk før indsendelse, går udkastet tabt uden varsel.

Indstilling af warnOnUnsavedComment til true får browseren til at bede brugeren bekræfte, før de forlader siden, mens enhver kommentarboks eller en igangværende redigering stadig indeholder tekst. Når kommentaren er indsendt, ryddes teksten, så der ikke vises nogen prompt.

Advarsel om ikke-gemt kommentar

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",
    "warnOnUnsavedComment": true
}];
</script>

Prompten bruger browserens egen dialog. Moderne browsere viser deres egen formulering og ignorerer tilpasset tekst, så beskeden kan ikke tilpasses.

Denne indstilling indlæser en lille udvidelse på efterspørgsel, så den tilføjer intet til widgeten for sider, der ikke aktiverer den.

Aktiver afstemninger

Polls giver kommentatorer mulighed for at vedhæfte et spørgsmål med 2 til 10 svarmuligheder til en kommentar. Alle på siden stemmer på stedet og ser resultaterne opdatere live.

Polls er deaktiveret som standard. Marker Enable Polls i widget‑tilpasningsindstillingerne for at tilføje en afstemningsknap til kommentarværktøjslinjen. To yderligere indstillinger vises derefter:

Who Can Create Polls: Kun administratorer/moderatorer (standard), eller alle.
Allow Anonymous Poll Votes: når den er fravalgt (standard), kan kun loggede brugere stemme.

Aktiver afstemninger

Widget-tilpasningsside med indstillingen Enable Polls markeret

Se Afstemningsguide for hvordan oprettelse, afstemning, privatliv og afstemningsmeddelelser fungerer.

Oversigt over Single Sign On (SSO)

SSO, eller single-sign-on, er et sæt konventioner, der giver dig eller dine brugere mulighed for at bruge FastComments uden at skulle oprette endnu en konto.

Hvis du ikke tillader anonym kommentering, kræves der en konto for at kommentere med FastComments. Vi gør denne tilmeldingsproces meget nem - brugeren skal blot angive deres e-mail, når de kommenterer. Vi forstår dog, at selv det er ekstra friktion, som nogle sider ønsker at undgå.

Vi kan reducere den friktion ved kun at have ét login-flow for hele din side.

Hvordan får jeg det?

Alle kontotyper har i øjeblikket adgang til SSO. Det maksimale antal SSO-brugere varierer dog afhængigt af din pakke. Som med andre funktioner giver Pro-planer og derover direkte udviklersupport.

Lad os sammenligne mulighederne og derefter gå i detaljer med hver af dem.

Bruger- og kommentarmigrering

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

Kommentarer importeres som en del af din migrering, enten via API'en, vores Import UI eller kundesupport. Import UI foretrækkes, hvis den understøtter den platform, du migrerer fra, da den indeholder fejlhåndtering, udtrækning og upload af avatarer og medier samt et batchjob-overvågningssystem.

Brugerne selv tilføjes automatisk, første gang de ser en kommentartråd. Alternativt kan de forudtilføjes via API'en, men dette arbejde har ikke mange fordele.

Hvis kommentarer importeres, og SSO-brugere ikke tilføjes manuelt via API'en, vil kommentarerne automatisk blive migreret til brugerens konto, første gang den oprettes, når de ser en 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 giver ikke e-mails ved eksport, som Disqus, så vi falder tilbage på brugernavn i dette tilfælde.

Så længe du angiver et matchende brugernavn og en e-mail i SSO-payload'en, tilføjer vi e-mailen til de enkelte kommentarobjekter, så notifikationer og omtaler fungerer.

Hvis du ønsker at importere dine kommentarer og brugere på én gang, så samarbejd med support om at migrere kommentarerne over til brugernes respektive konti, efter brugerne er importeret via API'en.

For at opsummere den nemmeste vej for migreringen:

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

WordPress-brugere

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

Dette fører dig til en guide med én enkelt knap, som opretter din API-nøgle, sender den til din WordPress-installation og slår SSO til. Vi har konsolideret dette til ét enkelt knapklik for dig.

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

WordPress SSO - Moderatorer

Bemærk, at i øjeblikket, for at "Moderator"-mærket skal vises ved siden af dine moderatorer, når de kommenterer med FastComments WordPress-pluginet, skal de også tilføjes som Moderator i FastComments-dashboardet og have deres e-mail verificeret.

Brugerdefinerede integrationer

For brugerdefinerede integrationer er der to muligheder.

Mulighed ét - Secure SSO

Med Secure SSO ved FastComments, at brugeren, der kommenterer, stemmer og læser kommentarer, er en rigtig bruger på din side.

Så længe du opretter en gyldig payload, vil brugeren altid have en problemfri kommentaroplevelse.

Med Secure SSO oprettes SSO-payload'en server-side ved hjælp af HMAC-godkendelse og sendes derefter til widgetten på klientsiden.

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 især have en SSO-bruger med brugernavnet "Bob".

Krav

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

Fordele

Sikkert.
Problemfri kommentaroplevelse.

Ulemper

Kræver backend-udvikling.

Opdatering af brugerdata

Med Secure SSO opdaterer vi brugerens konto med de nyeste oplysninger, hver gang du sender SSO-bruger-payload'en. For eksempel, hvis brugeren har brugernavnet X, og du sender Y i SSO-payload'en, bliver deres brugernavn Y.

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

Secure SSO API

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

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

Mulighed to - Simple SSO

Alternativet til Secure SSO er blot at sende brugeroplysningerne til kommentar-widgetten.

Det er ikke påkrævet at angive en e-mail med Simple SSO, men uden denne vises deres kommentarer som "Unverified".

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

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

Krav

Grundlæggende viden om klientudvikling.
Man skal kende mindst brugerens e-mail.

Fordele

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

Ulemper

Mindre sikkert end Secure SSO, da klient-side-payload'en kunne manipuleres til at blive enhver 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'en. Se dokumentationen.

Tilpassede integrationer - Sikker Single Sign On (SSO)

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

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

Flowet ser sådan ud:

Secure SSO Flow

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

Selvom vi bruger ExpressJS i NodeJS-eksemplet og Spring i Java-eksemplet, er der ingen frameworks/libraries påkrævet i disse run-times for at implementere FastComments SSO - de native crypto-pakker fungerer.

Du behøver ikke skrive nogen nye API-endpoints med FastComments SSO. Krypter blot brugerens oplysninger med din hemmelige nøgle og send payload'en til comment widget'en.

Hent din API Secret Key

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

API-dokumentation på højt niveau for comment widget'en kan findes her.

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

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

For at aktivere SSO skal du sende et nyt "sso"-objekt, som skal have følgende parametre. Værdierne skal genereres på serversiden.

userDataJSONBase64: Brugerens data i JSON-format, som derefter Base64-enkodes.
verificationHash: HMAC-SHA256-hashen oprettet fra UNIX_TIME_MILLIS + userDataJSONBase64.
timestamp: Epoch-tidsstempel, i millisekunder. Må ikke være i fremtiden eller mere end to dage i fortiden.
loginURL: En URL, som comment widget'en kan vise for at logge brugeren ind.
logoutURL: En URL, som comment widget'en kan vise for at logge brugeren ud.
loginCallback: Når denne angives i stedet for login-URL'en, en funktion, som comment widget'en kalder, når der klikkes på login-knappen.
logoutCallback: Når denne angives i stedet for logout-URL'en, en funktion, som comment widget'en kalder, når der klikkes på logout-knappen.

Secure SSO Klientkode

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

Brugerobjektet

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 må 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 64-kodede billeder, i hvilket tilfælde grænsen er 50k tegn. **/ 
    avatar?: string;
    /** Valgfri. Standard false. **/
    optedInNotifications?: boolean;
    /** Valgfri. Standard false. **/
    optedInSubscriptionNotifications?: boolean;
    /** Valgfri. Maks 100 tegn. Dette label vises ved siden af deres navn. Standard er Administrator/Moderator når 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 pr. 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 "activity"-fanen 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;
    /** Valgfri konfiguration for brugerbadges. **/
    badgeConfig?: {
        /** Array af globale badge-id'er, der skal tildeles. Begrænset til 30 badges. Rækkefølgen respekteres. **/
        badgeIds: string[];
        /** Array af badge-id'er afgrænset til den aktuelle side (urlId). Vises kun på den tildelte side. **/
        pageBadgeIds?: string[];
        /** Hvis true, erstatter eksisterende viste badges. Global og sideafgrænset tilsidesættes uafhængigt. **/
        override?: boolean;
        /** Hvis true, opdaterer badge-visningsegenskaber fra tenant-konfigurationen. **/
        update?: boolean;
    };
}

Moderatorer og Administratorer

For admins og moderatorer skal du sende de respektive isAdmin- eller isModerator-flag i SSOUser-objektet.

Notifikationer

For at aktivere eller deaktivere notifikationer skal du sætte værdien af optedInNotifications til henholdsvis true eller false. Første gang brugeren indlæser siden med denne værdi i SSO-payload'en, opdateres deres notifikationsindstillinger.

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

VIP-brugere & Særlige labels

Du kan vise et særligt label ved siden af brugerens navn ved at bruge det valgfrie "displayLabel"-felt.

Uautentificerede brugere

For at repræsentere en uautentificeret bruger skal du blot ikke udfylde userDataJSONBase64, verificationHash eller timestamp. Angiv en loginURL.

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

Direkte eksempler på serialisering og hashing af brugerdata

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

Vi forstår, at enhver integration kan være en kompliceret og smertefuld proces. Tøv ikke med at kontakte din repræsentant eller bruge supportsiden.

Tilpassede integrationer - Simpel Single Sign On (SSO)

Med Simple SSO kan vi give kommentarfunktionen information om brugeren, så de ikke behøver at indtaste 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"
            ],
            "pageBadgeIds": [
                "badge-id-3"
            ],
            "override": false
        }
    }
}];
</script>

Brugeren vil være logget ind og vil bag kulisserne oprette en SSO‑bruger. Brugeren vil have createdFromSimpleSSO sat til true, hvis den hentes fra API‑et.

Bemærk:

E‑mail er den unikke identifikator for Simple SSO.
Det er ikke påkrævet at angive en e‑mail med Simple SSO, men som standard vil deres kommentarer vises som "Ubekræftet". Hvis der ikke angives e‑mail, kan brugeren ikke blive fuldt autentificeret.
NY Siden januar 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 en e‑mail er angivet, og brugeren ikke oprindeligt blev oprettet fra Secure SSO. Hvis en Simple SSO‑payload navngiver en bruger, der er oprettet af Secure SSO eller API‑et, forbliver den bruger urørt, og besøgende får en separat bruger.
Du kan angive badges for brugeren med badgeConfig‑egenskaben. badgeIds‑arrayet indeholder ID‑erne på globale badges, der skal knyttes til brugeren. pageBadgeIds‑arrayet indeholder badge‑ID‑er, der er scoped til den aktuelle side (urlId) — disse badges vises kun på den side, hvor de blev tildelt. Hvis override er sat til true, erstattes eksisterende viste badges (globale og side‑scoped overskrives uafhængigt); hvis false, tilføjes de til eksisterende badges.

Simple SSO-indstillinger

Simple SSO er altid tilgængelig. To indstillinger styrer, hvor meget FastComments stoler på den. Du kan finde dem ved at søge efter SSO i en tilpasningsregel. Begge er deaktiveret som standard, og de gælder uanset om "Kræv SSO for at se kommentarer" er slået til.

Konti, der allerede brugte Simple SSO, da disse indstillinger blev tilføjet, har begge slået til, så intet ændrede sig for dem.

Kun den tilpasningsregel, der bedst matcher en side, anvendes, så hvis du har mere end én regel, skal du sætte disse på hver af dem. En ny regel starter med dem slået til, hvis en af dine andre regler har dem slået til.

Auto‑bekræft kommentarer via Simple SSO

Når dette er slået til, bekræftes kommentarer fra Simple SSO‑brugere med det samme.

Når dette er slået fra, vises kommentarer fra Simple SSO‑brugere som "Ubekræftet", indtil brugeren klikker på et link, vi sender til adressen i Simple SSO‑payloaden. Hvis du kun automatisk godkender bekræftede kommentarer, venter de også på dette link. Hvis der ikke er nogen e‑mail i payloaden, forbliver kommentaren ubekræftet.

Denne indstilling påvirker kun kommentarer. Stemmer fra Simple SSO‑brugere tælles altid med det samme.

Tillad Simple SSO-administratorer

Når dette er slået til, kan en Simple SSO‑bruger være administrator eller moderator af din konto:

En Simple SSO‑bruger, der har administrator‑ eller moderatorrettigheder, beholder dem.
En Simple SSO‑bruger med samme e‑mail som en af dine administratorer eller moderatorer overtager deres rettigheder.

Når dette er slået fra, giver Simple SSO ikke disse rettigheder. En Simple SSO‑payload, der navngiver en bruger med disse rettigheder, får en separat bruger uden rettigheder, og den oprindelige bruger forbliver urørt.

Simple SSO‑payloads er ikke signeret, så når dette er slået til, kan enhver, der kender en administrators e‑mail eller bruger‑ID, handle som dem. Hvis det er vigtigt for dit site, så lad dette være slået fra og brug Secure SSO til dine administratorer.

Brugere oprettet af Secure SSO eller API‑et kan ikke nås af Simple SSO, uanset om dette er slået til eller ej.

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 en måde at kommentere på uden at skulle logge ind på en anden platform.

Men dette alene sikrer ikke dine kommentarfærdigheder, da kommentardata som standard er offentligt tilgængelige oplysninger – enhver, der kan se siden, kan se kommentarerne.

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

Opsætning uden kode

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

Når du gør det, så søg efter SSO, og du vil finde denne indstilling:

Kræv SSO for at se kommentarer

Aktiver den og gem tilpasningsreglen.

Beskyt kun et bestemt domæne eller en side

For kun at beskytte et bestemt domæne eller en side, vil vi blot konfigurere tilpasningsreglen til at gøre det.

Øverst i tilpasnings‑UI’en vil vi finde to inputfelter, Domæne 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 tilpasset integration med FastComments, kan du indtaste en form for ID her i stedet for en URL.

Sikkerhedsniveauer

Når du kræver SSO, vil 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, så skal indholdet hentes med en Secure SSO‑payload, der er hash'et med din API‑nøgle, for at kunne vises.

Sikkerhedsniveau‑indstillingen vises, når du vælger "Require SSO To View Comments", og træder kun i kraft, mens den indstilling er slået til.

De Automatisk bekræftelse af kommentarer via Simple SSO og tillad Simple SSO‑administratorer indstillinger er separate og gælder uanset om denne indstilling er slået til eller ej.

Beskyttelse ud over læsning

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

Faldgruber

Alle brugere, der har oprettet kommentarer før din SSO-integration, vil ikke kunne se dem, medmindre de logger ind via din SSO-integration.

Tillad anonym kommentering

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

Vi kan dog fjerne e‑mail‑kravet. E‑mail‑indtastningsfeltet vil stadig blive vist, men det vil ikke længere være påkrævet.

Dette kan konfigureres via widget‑tilpasnings‑UI'en:

Aktivering af anonyme kommentarer

Anonym kommentarindstilling i widget‑tilpasnings‑UI'en, som gør e‑mail‑feltet valgfrit

Et brugernavn er stadig påkrævet. For at fjerne dette trin også, kan du indstille et standardbrugernavn som alle deler, eller lade FastComments generere et unikt brugernavn for hver besøgende.

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 den det ikke.

Dette kan konfigureres eller deaktiveres via siden Moderationsindstillinger.

Moderationsindstillinger

Deaktiver e-mail-indtastning

Når brugere kommenterer, og de ikke er logget ind, vil de blive 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 sites eller applikationer er det ønskeligt ikke at bede brugeren om deres e‑mail, når de kommenterer eller stemmer.

Aktivering af anonym kommentering gør e‑mail‑indtastningsfeltet valgfrit. Vi kan dog deaktivere det helt. Først aktiveres anonym kommentering, og derefter vil muligheden for at deaktivere e‑mail‑indtastningsfelterne vises.

Deaktiver e‑mail‑inputfelter

Mulighed for at skjule e‑mail‑felterne helt, vist efter at anonym kommentering er aktiveret i tilpasnings‑UI'en

Med dette aktiveret vil e‑mail‑felterne slet ikke blive vist i alle 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 kan overveje at deaktivere den uverificerede etiket.

Deaktiver mærket 'Uverificeret'

Som standard vil FastComments vise en "Ubekræftet kommentar" etiket for kommentarer, der er efterladt til en bruger, der har en ubekræftet browsersession. Læs mere om ubekræftede kommentarer her.

Deaktiver den ubekræftede etiket

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:

Deaktiver den ubekræftede etiket

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å enhver kan stemme på en kommentar uden at efterlade nogen oplysninger.

Tillad anonyme stemmer

Widget-tilpasningsside med den anonyme stemmeindstilling aktiveret, så afstemning ikke kræver navn eller e‑mail

Indstilling af standardbrugernavn

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

I tilfælde af anonyme kommentarer er det nogle gange ønskeligt at definere et standardbrugernavn for at reducere friktionen ved kommentering. Dette kan gøres fra tilpasnings‑UI’en. Anonym kommentering skal først aktiveres.

Indstilling af standardbrugernavn

Standardbrugernavnsfelt, der vises i tilpasnings‑UI’en, når anonym kommentering er aktiveret

Deling af standardbrugernavnet

Standardbrugernavnet er et delt visningsnavn, ikke en identitet. En besøgende, der beholder standarden og indtaster sin e‑mail, får sin egen konto, hvor standarden vises som deres offentlige navn. Et vilkårligt antal besøgende kan beholde den samme standard, så "Anonymous" aldrig rapporteres som allerede optaget.

Brugernavne, som en besøgende indtaster selv, skal stadig være unikke.

Hvis du foretrækker, at hver besøgende får et særskilt navn uden at skulle tænke på et, se Generer brugernavne automatisk.

Generer brugernavne automatisk

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

For nogle websteder kan det være en barriere at bede en besøgende om at finde på et unikt brugernavn, især på mobil. FastComments kan generere et neutralt brugernavn til hver ny besøgende og forududfylde det i brugernavnsfeltet, f.eks. BraveOtter4172.

Den besøgende kan lade det stå som det er, eller erstatte det med et navn efter eget valg.

Dette kan aktiveres fra Customization UI under indstillingen Generate Usernames Automatically:

Generér brugernavne automatisk

Indstillingen Generate Usernames Automatically i widget-tilpasningsgrænsefladen

Sådan fungerer det

Hvert genererede navn er unikt. Det kontrolleres mod eksisterende konti og reserveres til den besøgendes browsersession, så to besøgende ikke tilbydes det samme navn.
Navnet genereres kun for besøgende, der ikke har et endnu. Loggede brugere, SSO-brugere og besøgende, der allerede har kommenteret, beholder deres eksisterende navn.
Det fungerer med eller uden anonym kommentering. Med anonym kommentering slået fra skal den besøgende stadig indtaste sin e-mail, men behøver ikke længere at finde på et brugernavn.
En tilbagevendende besøgende, der indtaster en e-mail, de har brugt før, matches til deres eksisterende konto og beholder navnet på den konto.
Hvis en Default Username også er angivet, har det genererede navn forrang.

Tilbagekald

Alle biblioteker til kommentar-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 nøjagtige signaturer findes i TypeScript-definitionerne.

Her er et eksempel med alle callbacks brugt:

Eksempler på callbacks

Copy

Run

<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>
<div id="fastcomments-widget"></div>
<script>
    window.fcConfigs = [{
        target: '#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() { // emulerer 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 Most Relevant (ex: most upvoted, etc), eller Newest First
            const topCommentInList = comments[0];
            console.log('First Comment Rendered:', topCommentInList.avatarSrc, topCommentInList.commenterName, topCommentInList.commentHTML);
        }
    }];
</script>

Manuel definition af brugerens lokalitet

Som standard vil FastComments gengive kommentarfunktionen i den lokalitet, der er bestemt af brugerens system og browser.

Når en bruger kommenterer eller logger ind, opdaterer vi deres sidst brugte lokalitet og bruger den også til at sende e‑mails.

Dette påvirker, hvordan kommentarfunktionen oversættes for brugeren. En lokalitet består af brugerens sprog og region, så konfiguration af lokalitet vil normalt ændre det sprog, der vises til brugeren.

Via UI'en

Dette kan defineres via widget‑tilpasnings‑UI'en. Se indstillingen "Locale / Language" option:

Ændring af lokalitet / sprog

Locale / Language‑rullemenu på widget‑tilpasningssiden, der bruges til at tilsidesætte den besøgendes registrerede lokalitet

Via kode

Dette kan tilsidesættes med en ønsket lokalitet.

Manuel definition af brugerens lokalitet

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 lokalitetskoder

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

SSO‑bemærkning

Hvis du bruger SSO, vil du måske sende brugerens lokalitet i brugerobjektet, så e‑mails og andre ting lokales korrekt for dem.

Begrænsning af 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 community bruger.

Dette kan konfigureres uden kode på widget-tilpasningssiden:

Tilladte sprog

Systemet vil analysere kommentaren, bestemme dens sprog og derefter matche den med listen over tilladte sprog.

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

Kommentaroversættelse

Som standard oversætter FastComments widgetens eget interface (knapper, etiketter, fejlmeddelelser) til seerens sprog, men kommentarer vises præcis som de blev skrevet.

Kommentaroversættelse tilføjer oversættelse af selve kommentarerne, så et fællesskab, der skriver på mere end ét sprog, kan læse hver kommentar på sit eget sprog.

Der er to tilstande:

Automatic: kommentarer skrevet på et andet sprog end widgetens sprog vises oversat. En linje "Translated from Spanish" vises under kommentaren med et Show original-link, der skifter mellem oversættelsen og den uoversatte tekst.
Manual: hver kommentar får et Translate-link. Når man klikker på det, oversættes den pågældende kommentar til seerens sprog, med den samme Show original-toggle bagefter. Kommentarer, der allerede er på seerens sprog, angiver dette i stedet.

Målsproget er widgetens sprog: Locale / Language-indstillingen på den samme tilpasningsregel, hvis den er sat, ellers besøgerens browsersprog. Der kræves intet fra besøgeren, ingen konto, udvidelse eller ekstra software, og det fungerer på samme måde i den indlejrede widget og på selvstændige kommentarsider.

Dette slås til pr. tilpasningsregel, så det kan gælde for hele dit site, et domæne eller en enkelt side. Det er slukket som standard.

Kommentaroversættelse

Oversættelse er en server-side indstilling. At videregive commentTranslation i widgetens JavaScript-konfiguration aktiverer det ikke; reglen gør.

Hver kommentar oversættes højst én gang pr. målsprog, og resultatet gemmes sammen med kommentaren, så en kommentar læst af tusind spanske brugere kun oversættes én gang. Hvis forfatteren eller en moderator redigerer kommentaren, forkastes den gemte oversættelse, og kommentaren oversættes igen ved næste visning. Oversat tekst gennemgår den samme saniterings- og linkregler som den originale kommentar. Kommentarer, der er for lange, eller hvis sproget ikke kan detekteres, vises uoversat.

Brug faktureres som LLM‑tokens til samme pris som AI Agents og vises på samme sted i dine faktureringsdetaljer.

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 & deaktiver afstemninger

Kommentar kan låses, så ingen nye kommentarer eller stemmer kan afgives ved at sætte readonly-flaget til true.

Kommentarer vil også ikke kunne redigeres eller slettes.

Gør kommentartråden skrivebeskyttet

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:

Gør kommentartråden skrivebeskyttet

Indstillingen for at forhindre nye svar på widget-tilpasningssiden, som låser en tråd for et domæne eller en side

Update!

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 stemmer stadig er tilladt, og brugere kan slette deres kommentarer, hvis de ønsker det, mens readonly ikke tillader disse ting.

Dette svarer til isClosed-feltet i Page-API'en.

Begrænsning af linkdomæner

Som standard tillader FastComments at linke til enhver ekstern side.

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

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

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

Begræns eksterne linkdomæner

Eksterne linkindstillinger med den begrænsede liste over linkdomæner, hvor tilladte sider indtastes

Kommentarantal & tæ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.

Aktiver kommentator-links

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

Men i nogle situationer kan du ønske, at brugeren efterlader et link til deres egen blog eller hjemmeside.

Vi kan aktivere visning af et ekstra input‑felt til at indtaste brugerens website‑URL ved at sætte enableCommenterLinks‑flaget til true:

Aktivering af kommentatorlinks

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 pågældende URL er angivet, vil brugerens konto blive opdateret, og deres brugernavn på alle tidligere og fremtidige kommentarer vil linke til denne URL.

Dette kan tilpasses uden kode på widget‑tilpasningssiden:

Aktivering af kommentatorlinks

Widget-tilpasningsside med kommentatorlink‑afkrydsningsfeltet markeret for at tilføje et website‑URL‑felt til kommentarfeltet

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>

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

For at omgå dette kan du aktivere tredjepartscookie-bypass.

Når denne indstilling er aktiveret, vil det medføre en lille popup, der viser en besked om, at brugeren bliver logget ind. Denne popup vises, når brugeren interagerer med kommentar-widget'en; for eksempel, hvis de efterlader en kommentar.

Vi kan gøre dette i kode ved at sætte flaget enableThirdPartyCookieBypass til true:

Aktivering af tredjepartscookie-bypass

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",
    "enableThirdPartyCookieBypass": true
}];
</script>

Vi kan også konfigurere dette via Widget Customization UI, under Enable Third-Party Cookie Popup:

Aktivering af tredjepartscookie-bypass

Sletning af kommentarer med svar

Som standard kan brugere slette deres egne kommentarer. Når de sletter deres kommentar, slettes også automatisk alle underkommentarer og midlertidige kommentarer i tråden. Denne funktion er også aktiv.

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

I stedet kan du anonymisere 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 tilpasselig fejlmeddelelse vises.
Begræns sletning, når en kommentar har svar, til kun administratorer og moderatorer.

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

Tilpas sletningsadfærd for svar

Indstillinger for sletning af kommentartråde i widget-tilpasnings‑UI for at anonymisere eller begrænse sletninger med svar

Vis badges i topbjælken

Som standard vil FastComments kun vise brugerbadge på deres kommentarer inden for kommentartråden.

Men vi kan vise brugerbadge ved siden af deres navn over kommentarfeltet ved at aktivere denne funktion på widget-tilpasningssiden:

Vis badge i topbjælke-indstilling

Vis badge i topbjælke afkrydsningsfelt på widget-tilpasningssiden, placerer badge ved siden af navnet over kommentarfeltet

Dette vil vise brugerens badge ved siden af deres navn i topbjælkeområdet, så deres præstationer og status fremstår mere tydelige, når de skriver en kommentar.

Bemærk, at denne funktion skal være aktiveret i widget-tilpasnings‑UI’en for at fungere. Du kan valgfrit sætte showBadgesInTopBar‑flaget til false i din kodekonfiguration for selektivt at deaktivere den, selvom den er slået til på serverniveau:

Deaktiver visning af badge i topbjælke

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>

Vis online-brugerliste

Som standard viser FastComments ikke en liste over brugere på siden.

Du kan vise en liste over personer, der i øjeblikket ser siden, ved siden af kommentarfunktionen. Listen opdateres live, efterhånden som brugere kommer og går, og viser deres navn, avatar og en online‑indikator.

Der er tre layoutmuligheder:

1 - Top: en vandret række af overlappende avatarer vist over kommentarerne.
2 - Left: en sidebjælke med navne og online‑punkter vist til venstre for widget'en.
3 - Right: den samme sidebjælke vist til højre for widget'en.

Sæt flaget usersListLocation for at aktivere funktionen:

Vis brugerliste til højre

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",
    "usersListLocation": 3
}];
</script>

Som standard viser listen kun brugere, der er online i øjeblikket. For også at inkludere personer, der har kommenteret på siden tidligere (men som ikke ser den i øjeblikket), sæt usersListIncludeOffline til true:

Inkluder tidligere kommentatorer

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",
    "usersListLocation": 3,
    "usersListIncludeOffline": true
}];
</script>

Tidligere kommentatorer vises uden den grønne online‑punkt, så det er tydeligt, hvem der er til stede lige nu.

Brugere med private profiler vises med en generisk avatar og en "Privat profil"-etiket, så antallet forbliver nøjagtigt uden at afsløre identiteter.

Dette kan også konfigureres uden kode. På widget‑tilpasningssiden, se indstillingen "Users List Location". Når placeringen er sat til noget andet end Off, vises en "Include past commenters"-afkrydsningsboks nedenunder.

Indstillinger for brugerliste

Placeringen for brugerliste sat til Højre, med afkrydsningsboksen Inkluder tidligere kommentatorer vist nedenunder

Op til 500 live‑brugere, listen kan være op til 30 sekunder forældet.

Forrige guide Næste guide

Sprog 🇩🇰 Dansk

Grundlæggende

Udseende og fornemmelse

Live-kommentarer

Paginering & sortering

Svarboksen

SSO

Anonym kommentering

Diverse

Tilpasninger & Konfiguration

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

Tilpasset styling

Eksterne CSS-filer

I kode - Ikke anbefalet

Styling af brugerprofilmodal

Bagudkompatibilitet

Tilpassede skrifttyper

Sådan defineres skrifttypen

Fjernelse af branding

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

Skift mellem mørk tilstand

Overskrive tekst

Ændring af standardavatar

Deaktivering af avatarer

Deaktivering af alle standardstile

Linkning fra kommentarer til sider

Sammenfold svar som standard

Aktiver WYSIWYG

Deaktivering af værktøjslinjen

Deaktivering af blokering

Bestemmelse af hvilken side der skal vises

Skift kommentarfærd uden at genindlæse siden

Angular, React, Vue, osv.

VanillaJS

Absolutte datoer (Deaktiver menneskevenlige tidsstempler)

Vis både absolutte og relative datoer

Tilføjelse af overskriftstekst

Vis links som tekst

Skift kommentarer med en knap

Tilpasning af kommentarantal-tekst

Deaktiver billedomdirigering

Deaktiver automatisk oprettelse af hashtags

Deaktiver notifikationsklokke

Deaktiver profiler

Deaktiver profilkommentarer

Deaktiver direkte beskeder i profiler

Deaktiver succesmeddelelse

Ændring af indholdsvurdering for GIF'er

Billedindhold moderation

Ændring af afstemningsstil

Deaktiver sletning

Deaktiver redigering

Fremhævning af nye kommentarer

Sidestørrelser

E-mail-skabeloner

Brugernavnsformater

Deaktivering af billeduploads

Tillad medieindlejringer

Tilføj dine egne udbydere

Aktiver søgeboks

Aktiver spoilers

Aktiver visningstællere for kommentarer

Vis live-kommentarer med det samme

Deaktivering af live-kommentarer

Nye live-kommentarer nederst

Aktiver uendelig rulning

Ændring af standard sorteringsretning

Vis alle kommentarer på én gang - Deaktiver paginering

Flyt svarboksen til efter kommentarerne

Begrænsning af kommentarens længde

Deaktiver multiline-kommentarer

Begræns kommentarvolumen pr. bruger

Forhindre nye topniveau-kommentarer

Maksimal svar-dybde

Kræv accept af servicevilkår