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.

Typiske 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 støder på, og almindelige løsninger.

"This is a demo" besked

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

"FastComments cannot load on this domain" fejl

FastComments skal vide, hvilke domæner der tilhører dig, for at autentificere anmodninger forbundet med din konto. Se vores dokumentation for at se, hvordan du løser denne fejl (tilføj blot det præcise underdomæne + domæne til din konto).

Bemærk at dette kun bør forekomme efter prøveperioden er udløbet. Under prøveperioden vil alle anmodninger fra nye domæner automatisk blive tilføjet til din konto.

Migrerede kommentarer vises ikke for tilpassede installationer

Dette sker normalt, når de importerede kommentarer er knyttet til et Page ID, og du sender en URL (eller ingen værdi, i hvilket tilfælde den 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 værdierne du ser i URL ID-kolonnen er de samme værdier, du sender til widget-konfigurationen som urlId-parameteren.

For yderligere forklaring, prøv at læse vores dokumentation om hvordan kommentarer er knyttet til sider og artikler.

Hvis alt andet fejler, kontakt os.

Hvis kommentar-widget'en ikke vises, tjek Chrome developer-konsollen for fejl.

For de fleste fejlkonfigurationer vil kommentar-widget'en i det mindste vise en fejl på siden, hvis den kan indlæses. At se ingenting er normalt en indikation af en scripting-fejl.

Ønsket konfiguration virker ikke som forventet

Prøv vores Chrome-udvidelse for at se, hvilken konfiguration kommentar-widget'en modtager. Hvis alt fejler, tag et screenshot af hvad chrome-udvidelsen siger og kontakt os.

Kommentarer mangler på samme URL med forskellig hash bang

Som standard vil FastComments bruge sidens URL til den "bucket", hvor kommentarer gemmes. Hvis dine URL'er inkluderer #hashbangs, og disse #hashbangs ikke skal være en del af identifikatoren, der identificerer en kommentartråd, kan vi blot ignorere hash bang-værdien, for eksempel:

Ignorer hash bangs eksempel

Copy

<script src="https://cdn.fastcomments.com/js/embed-v2.min.js"></script>
<div id="fastcomments-widget"></div>
<script>
window.FastCommentsUI(document.getElementById('fastcomments-widget'), {
    tenantId: "demo",
    url: location.href.replace(location.hash, ''),
    urlId: location.href.replace(location.hash, '')
});
</script>

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

URL-forespørgselsparametre påvirker widget'en

Som standard vil FastComments bruge sidens URL til den "bucket", hvor kommentarer gemmes. Hvis dine URL'er inkluderer forespørgselsparametre der ikke skal være en del af identifikatoren, der identificerer en kommentartråd, kan vi blot ignorere dem, for eksempel:

Ignorer forespørgselsparametre

Copy

<script src="https://cdn.fastcomments.com/js/embed-v2.min.js"></script>
<div id="fastcomments-widget"></div>
<script>
window.FastCommentsUI(document.getElementById('fastcomments-widget'), {
    tenantId: "demo",
    url: location.protocol + '//' + location.host + location.pathname,
    urlId: location.pathname
});
</script>

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

Modtager ikke e-mails

Hos FastComments arbejder vi hårdt på at sikre, at vores e-mail-levering er så pålidelig som muligt. Dog er nogle e-mail-udbydere notorisk svære at levere til pålideligt. Tjek din spam-mappe for beskeder fra fastcomments.com.

Hvis du kontakter os kan vi normalt give mere indsigt i, hvorfor du måske ikke ser 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

Tredjepartsplugins

Tilpassede installationer

Indlejring i dokumenter

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

Typiske 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" besked

"FastComments cannot load on this domain" fejl

Migrerede kommentarer vises ikke for tilpassede installationer

Kommentar-widget vises ikke

Ønsket konfiguration virker ikke som forventet

Kommentarer mangler på samme URL med forskellig hash bang

URL-forespørgselsparametre påvirker widget'en

Modtager ikke e-mails

Notion og Google Sites

Notion

Google Sites

Nimbus Note

Sprog 🇩🇰 Dansk

Tredjepartsplugins

Tilpassede installationer

Indlejring i dokumenter

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

Typiske 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" besked

"FastComments cannot load on this domain" fejl

Migrerede kommentarer vises ikke for tilpassede installationer

Kommentar-widget vises ikke

Ønsket konfiguration virker ikke som forventet

Kommentarer mangler på samme URL med forskellig hash bang

URL-forespørgselsparametre påvirker widget'en

Modtager ikke e-mails

Notion og Google Sites

Notion

Google Sites

Nimbus Note