FastComments.com

Tilføj kommentarer til et websted

Installation

FastComments gør det nemt at tilføje kommentarer til dit websted, uanset om det er statisk eller dynamisk, lyst eller mørkt tema, offentlige eller interne sider. Det bør være nemt at installere og tilpasse til enhver form for websted eller webbaseret applikation. Det giver dig live-kommentarer med det samme, ofte uden yderligere konfiguration i mange tilfælde.


WordPress Internal Link

For at tilføje kommentarer til dit WordPress-websted kan du finde vores WordPress-plugin her.

En komplet installationsvejledning og dokumentation om plugin'et findes her.

Dette plugin understøtter live-kommentering, SSO og installation uden kode. Følg blot installationsvejledningen på administrationssiden efter installation af plugin'et. Den vil guide dig gennem at forbinde din WordPress-installation til din konto.

Alle kommentarer efterladt med FastComments via vores WordPress-plugin kan automatisk synkroniseres tilbage til din WordPress installation, så du bevarer kontrollen over dine data. Dette kan slås fra for at begrænse størrelsen på din WordPress-database.

VanillaJS / HTML-udsnit Internal Link


VanillaJS-versionen af widgeten er den simpleste måde at tilføje kommentarer til dit websted på, og den kræver hverken build-systemer eller server-side kode.

Tilføj blot følgende kodeudsnit til enhver side for at tilføje kommentarer til dit websted:

Simple Code Snippet
Copy CopyRun External Link
1
2<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>
3<div id="fastcomments-widget"></div>
4<script>
5window.fcConfigs = [{
6 "tenantId": "demo"
7}];
8</script>
9

Du kan bruge det samme kodeudsnit på flere sider; det vil automatisk oprette en separat tråd for hver side.

Mange applikationer har en "HTML Embed Code"-mulighed. Vælg den og indsæt kodeudsnittet ovenfor.

Du behøver heller ikke en konto for at prøve det! Du kan se "tenantId: demo" i ovenstående udsnit, hvis du ikke er logget ind. På den måde bruger den demokontoen.

Du kan finde dokumentation om konfiguration af widgeten her.

Alle versioner af FastComments-widgeten er wrappers omkring kernebiblioteket VanillaJS. Dette gør os i stand til at tilføje funktioner og rette problemer ét sted - og ændringerne udbredes automatisk til de andre varianter af kommentar-widgeten.


Angular Internal Link

For at tilføje kommentarer til et websted bygget med Angular, kan du finde vores Angular-bibliotek på NPM her.

FastComments Angular-kommenteringswidget'en understøtter alle de samme funktioner som VanillaJS-versionen - live-kommentering, sso, og så videre.

Du skal bruge fastcomments-typescript, som er en peer-afhængighed. Sørg venligst for, at dette er inkluderet i din TypeScript-kompilering. I fremtiden vil denne peer-afhængighed blive flyttet til @types/fastcomments, hvilket vil forenkle denne installation.

FastComments Angular via NPM
Copy Copy
1
2 npm install fastcomments-typescript --save
3 npm install ngx-fastcomments --save
4

Peer-afhængigheden skal tilføjes i din tsconfig.json-fil, for eksempel:

Tilføjelse af fastcomments-typescript peer-afhængighed
Copy Copy
1
2"include": [
3 "src/**/*.ts",
4 "node_modules/fastcomments-typescript/src/index.ts"
5],
6

Tilføj derefter FastCommentsModule til din applikation:

Tilføj modulet til din app
Copy Copy
1
2import { BrowserModule } from '@angular/platform-browser';
3import { NgModule } from '@angular/core';
4
5import { AppComponent } from './app.component';
6import { FastCommentsModule } from 'ngx-fastcomments';
7
8@NgModule({
9 declarations: [
10 AppComponent
11 ],
12 imports: [
13 BrowserModule,
14 FastCommentsModule
15 ],
16 providers: [],
17 bootstrap: [AppComponent]
18})
19export class AppModule { }
20

Brug

For at komme i gang angiver vi et konfigurationsobjekt for demo-tenant:

Brug - Inline-konfiguration
Copy Copy
1
2<lib-fastcomments [config]="{ tenantId: 'demo' }"></lib-fastcomments>
3

Da konfigurationen kan blive ret kompliceret, kan vi videregive en objektreference:

Brug - Videregiv objekt til konfiguration
Copy Copy
1
2<lib-fastcomments [config]="fastcommentsConfig"></lib-fastcomments>
3
Brug - EU
Copy Copy
1
2<lib-fastcomments [config]="{ tenantId: 'demo', region: 'eu' }"></lib-fastcomments>
3

Widget'en bruger change detection, så ændring af nogen egenskaber i konfigurationsobjektet vil få den til at blive genindlæst.

Du kan finde den konfiguration, som Angular-komponenten understøtter her.


React Internal Link


For at tilføje kommentarer til et site bygget med React kan du finde vores React-bibliotek på NPM her.

FastComments React-kommentar-widgetten understøtter alle de samme funktioner som VanillaJS-udgaven - live-kommentering, sso og så videre.

FastComments React via NPM
Copy Copy
1
2npm install --save fastcomments-react
3
FastComments React via Yarn
Copy Copy
1
2yarn add fastcomments-react
3
React-eksempel
Copy Copy
1
2import React, { Component } from 'react'
3
4import {FastCommentsCommentWidget} from 'fastcomments-react'
5
6class Example extends Component {
7 render() {
8 return <FastCommentsCommentWidget tenantId="demo" />
9 }
10}
11

Hvis du er i EU, bør du sætte region-parameteren således:

React-eksempel - EU
Copy Copy
1
2 <FastCommentsCommentWidget tenantId="demo" region="eu" />
3

Du kan finde den konfiguration, som React-komponenten understøtter, her.


Vue Internal Link


For at tilføje kommentarer til dit websted bygget med Vue, kan du finde vores Vue-bibliotek på NPM her.

Derudover findes et vue-next-bibliotek på NPM her

Kildekoden kan findes på GitHub.

FastComments Vue-kommentarwidgeten understøtter alle de samme funktioner som VanillaJS-versionen - live-kommentering, sso og så videre.

Følgende instruktioner er for Vue 3, da det har været ude i noget tid, dog understøtter FastComments også Vue 2 via fastcomments-vue-biblioteket.

FastComments Vue via NPM
Copy Copy
1
2npm install --save fastcomments-vue-next
3
FastComments Vue via Yarn
Copy Copy
1
2yarn add fastcomments-vue-next
3
Vue-eksempel
Copy Copy
1
2<template>
3 <img alt="Vue logo" src="./assets/logo.png">
4 <fast-comments v-bind:config="{tenantId: 'demo'}"/>
5</template>
6
7<script>
8import {FastComments} from 'fastcomments-vue-next';
9
10export default {
11 name: 'App',
12 components: {
13 FastComments
14 }
15}
16</script>
17

Hvis du er i EU, skal du sætte region til EU:

FastComments Vue - EU
Copy Copy
1
2<fast-comments v-bind:config="{tenantId: 'demo', region: 'eu'}"/>
3

fastcomments-vue og fastcomments-vue-next bibliotekerne understøtter den samme konfiguration som VanillaJS-kommentarwidgeten.

Du kan finde den konfiguration, som Vue-komponenten understøtter her.


TypeScript Internal Link

TypeScript-definitionerne for FastComments, som inkluderer typer for al konfiguration sendt til kommentar-widgetten, kan findes på NPM her.

Du kan finde det på GitHub her.

Flere forekomster på samme side Internal Link

Each instance of the comment widget is isolated. Because of this, FastComments inherently supports more than one instance per page, or multiple instances pointing to the same chat thread.

In the case of the VanillaJS library you simply have to tie the comment widget to different DOM nodes. If you want to simply update the current thread on the page, see Skift af kommentarstråde uden at genindlæse siden;

Synkronisering af godkendelsestilstand på tværs af flere forekomster

Lad os gennemgå eksemplet med en tilpasset single-page-applikation, der er en liste over ofte stillede spørgsmål med deres egen kommentarstråd.

I dette tilfælde har vi flere forekomster af FastComments i DOM'en på én gang.

Det er i orden, men det medfører nogle udfordringer for brugeroplevelsen.

Overvej dette forløb:

  1. Brugeren besøger siden med en liste over spørgsmål, hver med deres egen kommentarswidget.
  2. Brugeren indtaster sit brugernavn og e‑mail og stiller et spørgsmål på en af trådene.
  3. De ser et andet FAQ‑element, de har et spørgsmål om.
  4. De går igen til at kommentere. Skal de indtaste deres e‑mail og brugernavn igen?

I dette tilfælde håndterer FastComments synkroniseringen af godkendelsestilstanden på tværs af widget‑forekomster for dig. I trin fire vil brugeren allerede være midlertidigt godkendt, da de indtastede deres brugernavn og e‑mail på samme side.

Almindelige brugstilfælde Internal Link

Visning af live kommentarer med det samme

Kommentar-widgeten er live som standard, men live kommentarer vises under en "Vis N nye kommentarer"-knap for at forhindre, at sideindholdet flytter sig.

I nogle tilfælde er det stadig ønskeligt at vise de nye kommentarer med det samme, uden at skulle klikke på en knap.

I dette tilfælde vil du aktivere showLiveRightAway-flaget, som du kan finde dokumentation for her.

Tillad anonyme kommentarer (kræver ikke e‑mail)

Som standard kræver FastComments, at brugeren angiver en e‑mail, når de kommenterer.

Dette kan deaktiveres, instruktionerne er her.

Tilpasset styling

Mange af vores kunder anvender deres egen styling på kommentar-widgeten. Du kan finde dokumentationen her.

Visning af de samme kommentarer på flere domæner

Visning af de samme kommentarer på flere sider er noget, FastComments understøtter som standard. Se vores dokumentation om dette emne.

Skift af den aktuelle side

FastComments understøtter SPA'er og komplekse applikationer. Skift af den aktuelle side er nemt, og er dækket her.