Add Comments To a Website

Installation

FastComments er designet til at blive installeret på enhver slags side - statisk eller dynamisk, med lyst eller mørkt tema, offentlige eller interne sider. Det bør være nemt at installere og tilpasse til enhver slags websted eller webbaseret applikation.

WordPress

Du kan finde vores WordPress-plugin her.

En komplet installationsvejledning og dokumentation om pluginnet findes her.

Dette plugin understøtter live kommentering, SSO og installation uden kode. Følg blot installationsvejledningen på admin-siden efter installation af pluginnet. Det vil guide dig gennem forbindelsen af din WordPress-installation til din konto.

Alle kommentarer efterladt med FastComments gennem 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

VanillaJS-versionen af widgetten er meget nem at installere og kræver ikke build-systemer eller server-side kode.

Tilføj blot følgende kodestykke til enhver side:

Simpelt kodestykke

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>

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

Mange applikationer har en "HTML Embed Code" mulighed. Vælg det og indsæt kodestykket ovenfor.

Du behøver ikke engang en konto for at prøve det! Du kan se "tenantId: demo" i kodestykket ovenfor, hvis du ikke er logget ind. På den måde vil det bruge demo-kontoen.

Du kan finde dokumentation om konfiguration af widgetten her.

Alle versioner af FastComments-widgetten er wrappers omkring det centrale VanillaJS-bibliotek. Dette giver os mulighed for at tilføje funktioner og rette problemer ét sted - og ændringerne spredes automatisk til de andre varianter af kommentar-widgetten.

Angular

Du kan finde vores Angular-bibliotek på NPM her.

FastComments Angular kommentar-widget 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 for at dette er inkluderet i din TypeScript-kompilering. I fremtiden vil denne peer-afhængighed blive flyttet til @types/fastcomments, hvilket vil forenkle installationen.

FastComments Angular via NPM

Copy

  npm install fastcomments-typescript --save
  npm install ngx-fastcomments --save

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

Tilføj fastcomments-typescript peer-afhængighed

Copy

"include": [
  "src/**/*.ts",
  "node_modules/fastcomments-typescript/src/index.ts"
],

Derefter tilføj FastCommentsModule til din applikation:

Tilføj modulet til din app

Copy

import { BrowserModule } from '@angular/platform-browser';
import { NgModule } from '@angular/core';
import { AppComponent } from './app.component';
import { FastCommentsModule } from 'ngx-fastcomments';
@NgModule({
  declarations: [
    AppComponent
  ],
  imports: [
    BrowserModule,
    FastCommentsModule
  ],
  providers: [],
  bootstrap: [AppComponent]
})
export class AppModule { }

Brug

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

Brug - Inline konfiguration

Copy

<lib-fastcomments [config]="{ tenantId: 'demo' }"></lib-fastcomments>

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

Brug - Send objekt til konfiguration

Copy

<lib-fastcomments [config]="fastcommentsConfig"></lib-fastcomments>

Brug - EU

Copy

<lib-fastcomments [config]="{ tenantId: 'demo', region: 'eu' }"></lib-fastcomments>

Widget'en bruger ændringsdetektion, så ændring af egenskaber på konfigurationsobjektet vil få det til at genindlæses.

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

React

Du kan finde vores React-bibliotek på NPM her.

FastComments React kommentar-widget understøtter alle de samme funktioner som VanillaJS-versionen - live kommentering, SSO og så videre.

FastComments React via NPM

Copy

npm install --save fastcomments-react

FastComments React via Yarn

Copy

yarn add fastcomments-react

React eksempel

Copy

import React, { Component } from 'react'
import {FastCommentsCommentWidget} from 'fastcomments-react'
class Example extends Component {
  render() {
    return <FastCommentsCommentWidget tenantId="demo" />
  }
}

Hvis du er i EU, skal du indstille region-parameteren sådan:

React eksempel - EU

Copy

    <FastCommentsCommentWidget tenantId="demo" region="eu" />

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

React Native

Du kan finde vores React Native-bibliotek på NPM her.

FastComments React Native kommentar-widget understøtter alle de samme funktioner som VanillaJS-versionen - live kommentering, SSO og så videre.

FastComments React Native via NPM

Copy

npm install --save fastcomments-react-native

FastComments React Native via Yarn

Copy

yarn add fastcomments-react-native

Konfigurationen specificeres lidt anderledes sammenlignet med fastcomments-react-biblioteket:

React Native eksempel

Copy

import { FastCommentsCommentWidget } from 'fastcomments-react-native';
// ...
  const tenantId = 'demo'; // Dit tenant id. Kan hentes fra https://fastcomments.com/auth/my-account/api-secret
  const pageId = 'native-test'; // ID eller URL for kommentartråden i din app.
  const config = {
    tenantId: tenantId,
    urlId: pageId
  };
  return (
      <FastCommentsCommentWidget config={config}/>
  );

Hvis du er i EU, vil du gerne sætte region-parameteren:

React Native - EU

Copy

  // ...
  const config = {
    tenantId: tenantId,
    urlId: pageId,
    region: 'eu'
  };
  // ...

Du kan finde konfigurationen, som React Native-komponenten understøtter her.

Vue

Du kan finde vores Vue-bibliotek på NPM her.

Derudover findes vue-next-biblioteket på NPM her

Kildekoden kan findes på GitHub.

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

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

FastComments Vue via NPM

Copy

npm install --save fastcomments-vue-next

FastComments Vue via Yarn

Copy

yarn add fastcomments-vue-next

Vue eksempel

Copy

<template>
  <img alt="Vue logo" src="./assets/logo.png">
    <fast-comments v-bind:config="{tenantId: 'demo'}"/>
</template>
<script>
import {FastComments} from 'fastcomments-vue-next';
export default {
  name: 'App',
  components: {
    FastComments
  }
}
</script>

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

FastComments Vue - EU

Copy

<fast-comments v-bind:config="{tenantId: 'demo', region: 'eu'}"/>

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

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

TypeScript

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 instanser på samme side

Hver instans af kommentar-widgetten er isoleret. Derfor understøtter FastComments naturligt mere end én instans pr. side eller flere instanser, der peger på den samme chat-tråd.

I tilfældet med VanillaJS-biblioteket skal du for eksempel blot binde kommentar-widgetten til forskellige DOM-noder.

Synkronisering af autentificeringstilstand på tværs af flere instanser

FastComments håndterer synkronisering af autentificeringstilstanden på tværs af widget-instanser for dig.

Almindelige anvendelsestilfælde

Vis live kommentarer med det samme

Kommentar-widgetten er live som standard, men live kommentarer vises under en "Vis N nye kommentarer" knap for at forhindre sideindholdet i at flytte 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, dokumentationen for hvilket du kan finde her.

Tillad anonym kommentering (kræver ikke e-mail)

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

Dette kan deaktiveres, instruktioner er her.

Tilpasset styling

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

Fejlfinding af almindelige problemer

Her er nogle symptomer, vi ofte ser, og almindelige løsninger.

"This is a demo" Message

Dette vises, når du har kopieret widget-koden fra vores startside, som bruger vores demo tenant. For at bruge din tenant skal du kopiere widget-koden fra her.

"FastComments cannot load on this domain" Error

FastComments skal vide, hvilke domæner der ejes af dig for at godkende forespørgsler tilknyttet din konto. Se vores dokumentation for at se, hvordan du løser denne fejl (tilføj blot det præcise subdomæne + domæne til din konto).

Bemærk, at dette kun burde forekomme efter prøveperioden er slut. I prøveperioden vil forespørgsler fra nye domæner automatisk blive tilføjet til din konto.

Migrated Comments Not Showing for Custom Installations

Normalt sker dette, når de importerede kommentarer er knyttet til en Page ID, og du sender en URL (eller ingen værdi, i hvilket tilfælde den som standard bruger sidens URL).

Du kan fejlsøge dette ved at eksportere dine kommentarer og se på URL ID kolonnen (i øjeblikket Kolonne B).

Sørg for, at de værdier, du ser i URL ID kolonnen, er de samme værdier, du sender til widget- konfigurationen som urlId parameteren.

For yderligere forklaring kan du læse vores How Comments are Tied to Pages and Articles documentation.

Hvis intet hjælper, kontakt os.

Hvis kommentar-widgetten ikke vises, tjek Chrome udviklerkonsollen for fejl.

Ved de fleste fejlkonfigurationer vil kommentar-widgetten i det mindste vise en fejl på siden, hvis den kan indlæses. At intet vises er normalt et tegn på en script-fejl.

Desired Configuration Not Working as Expected

Prøv vores Chrome-udvidelse for at se, hvilken konfiguration kommentar-widgetten får. Hvis intet hjælper, tag et skærmbillede af, hvad Chrome-udvidelsen siger og kontakt os.

Comments Missing on Same URL With Different Hash Bang

Som standard bruger FastComments sidens URL for den "bucket", hvor kommentarer gemmes. Hvis dine URL'er indeholder #hashbangs, og disse #hashbangs ikke bør være en del af identifikatoren, der identificerer en kommentartråd, kan vi simpelt ignorere hashbang-værdien, for eksempel:

Ignorer hashbangs-eksempel

Copy

<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",
    url: location.href.replace(location.hash, ''),
    urlId: location.href.replace(location.hash, '')
}];
</script>

Bemærk, at efter at have foretaget denne ændring, skal der udføres en migration for eksisterende kommentarer. Til det, kontakt os.

Som standard bruger FastComments sidens URL for den "bucket", hvor kommentarer gemmes. Hvis dine URL'er indeholder forespørgselsparametre, der ikke bør være en del af identifikatoren, som identificerer en kommentartråd, kan vi simpelt ignorere dem, for eksempel:

Ignorer forespørgselsparametre

Copy

<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",
    url: location.protocol + '//' + location.host + location.pathname,
    urlId: location.pathname
}];
</script>

Bemærk, at efter at have foretaget denne ændring, skal der udføres en migration for eksisterende kommentarer. Til det, kontakt os.

Not Receiving Emails

Hos FastComments gør vi en stor indsats for at sikre, at vores e-mails leveres så pålideligt som muligt. Dog er nogle e-mailudbydere notorisk svære at levere til pålideligt vis. Tjek din spam- mappe for beskeder fra fastcomments.com.

Hvis du kontakter os kan vi som regel give mere indsigt i, hvorfor du måske ikke modtager e-mails fra os.

Notion og Google Sites

Vil du tilføje kommentarer til dine Notion-sider? Vi har dig dækket.

Notion

For at tilføje kommentering til Notion-dokumenter, se forklaringsvideoen her.

Google Sites

Google Sites understøttes også, og flowet er lignende.

Opret en samtale til indlejring.
Når du redigerer dit Google Site, gå til Indsæt -> Indlejr. Vælg Via URL.
Indsæt URL'en fra trin 1.
Tryk på Indsæt. Færdig!

Nimbus Note

Tilføjelse af live kommentering til en Nimbus Note understøttes også, og flowet er lignende Notion.

Næste guide

Tredjeparts-plugins

Tilpassede installationer

Indlejring i dokumenter

Add Comments To a Website

Installation

WordPress

VanillaJS / HTML-udsnit

Angular

Brug

React

React Native

Vue

TypeScript

Flere instanser på samme side

Synkronisering af autentificeringstilstand på tværs af flere instanser

Almindelige anvendelsestilfælde

Vis live kommentarer med det samme

Tillad anonym kommentering (kræver ikke e-mail)

Tilpasset styling

Fejlfinding af almindelige problemer

"This is a demo" Message

"FastComments cannot load on this domain" Error

Migrated Comments Not Showing for Custom Installations

Comment Widget Not Showing

Desired Configuration Not Working as Expected

Comments Missing on Same URL With Different Hash Bang

URL Query Parameters Affecting Widget

Not Receiving Emails

Notion og Google Sites

Notion

Google Sites

Nimbus Note

Sprog 🇩🇰 Dansk

Tredjeparts-plugins

Tilpassede installationer

Indlejring i dokumenter

Add Comments To a Website

Installation

WordPress

VanillaJS / HTML-udsnit

Angular

Brug

React

React Native

Vue

TypeScript

Flere instanser på samme side

Synkronisering af autentificeringstilstand på tværs af flere instanser

Almindelige anvendelsestilfælde

Vis live kommentarer med det samme

Tillad anonym kommentering (kræver ikke e-mail)

Tilpasset styling

Fejlfinding af almindelige problemer

"This is a demo" Message

"FastComments cannot load on this domain" Error

Migrated Comments Not Showing for Custom Installations

Comment Widget Not Showing

Desired Configuration Not Working as Expected

Comments Missing on Same URL With Different Hash Bang

URL Query Parameters Affecting Widget

Not Receiving Emails

Notion og Google Sites

Notion

Google Sites

Nimbus Note