Add Comments To a Website

Namestitev

FastComments je zasnovan tako, da ga je mogoče namestiti na katerokoli stran - statično ali dinamično, s svetlo ali temno temo, na javne ali notranje strani. Namestitev bi morala biti enostavna in prilagoditev za katerokoli vrsto spletnega mesta ali spletne aplikacije.

WordPress

Naš WordPress vtičnik lahko najdete tukaj.

Popoln vodnik za namestitev in dokumentacija o vtičniku sta tukaj.

Ta vtičnik podpira komentiranje v živo, SSO in namestitev brez kode.

VanillaJS / HTML izsek

VanillaJS različica pripomočka je zelo enostavna za namestitev, ne zahteva gradbenih sistemov ali strežniške kode.

Preprosto dodajte naslednji delček kode na katerokoli stran:

Preprost delček kode

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>

Isti delček kode lahko uporabite na več straneh; samodejno bo ustvaril ločeno nit za vsako stran.

Dokumentacijo o konfiguraciji pripomočka lahko najdete tukaj.

Angular

Našo Angular knjižnico lahko najdete na NPM tukaj.

FastComments Angular pripomoček za komentarje podpira vse enake funkcije kot različica VanillaJS — komentiranje v realnem času, SSO in tako naprej.

Potrebovali boste fastcomments-typescript, ki je peer odvisnost. Prosimo, zagotovite, da je vključen v vašo TypeScript kompilacijo. V prihodnosti bo ta peer odvisnost premaknjena v @types/fastcomments, kar bo poenostavilo namestitev.

FastComments Angular prek NPM

Copy

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

Peer odvisnost je treba dodati v vašo datoteko tsconfig.json, na primer:

Dodajanje fastcomments-typescript peer odvisnosti

Copy

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

Nato dodajte FastCommentsModule v vašo aplikacijo:

Dodajte modul v vašo aplikacijo

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 { }

Uporaba

Za začetek posredujemo konfiguracijski objekt za demo najemnika:

Uporaba - Inline konfiguracija

Copy

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

Ker lahko konfiguracija postane precej zapletena, lahko posredujemo referenco objekta:

Uporaba - Posreduj objekt za konfiguracijo

Copy

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

Uporaba - EU

Copy

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

Pripomoček uporablja zaznavanje sprememb, zato bo sprememba katerihkoli lastnosti konfiguracijskega objekta povzročila ponovno nalaganje.

Konfiguracijo, ki jo podpira Angular komponenta, lahko najdete tukaj.

React

Našo React knjižnico lahko najdete na NPM tukaj.

FastComments React pripomoček za komentarje podpira vse enake funkcije kot različica VanillaJS — komentiranje v realnem času, SSO in tako naprej.

FastComments React prek NPM

Copy

npm install --save fastcomments-react

FastComments React prek Yarn

Copy

yarn add fastcomments-react

React primer

Copy

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

Če ste v EU, boste želeli nastaviti parameter region takole:

React primer - EU

Copy

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

Konfiguracijo, ki jo podpira React komponenta, lahko najdete tukaj.

React Native

Našo React Native knjižnico lahko najdete na NPM tukaj.

FastComments React Native pripomoček za komentarje podpira vse enake funkcije kot različica VanillaJS — komentiranje v realnem času, SSO in tako naprej.

FastComments React Native prek NPM

Copy

npm install --save fastcomments-react-native

FastComments React Native prek Yarn

Copy

yarn add fastcomments-react-native

Konfiguracija je določena nekoliko drugače v primerjavi s knjižnico fastcomments-react:

React Native primer

Copy

import { FastCommentsCommentWidget } from 'fastcomments-react-native';
// ...
  const tenantId = 'demo'; // Vaš tenant id. Lahko ga dobite na https://fastcomments.com/auth/my-account/api-secret
  const pageId = 'native-test'; // ID ali URL niti komentarjev v vaši aplikaciji.
  const config = {
    tenantId: tenantId,
    urlId: pageId
  };
  return (
      <FastCommentsCommentWidget config={config}/>
  );

Če ste v EU, boste želeli nastaviti parameter region:

React Native - EU

Copy

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

Konfiguracijo, ki jo podpira React Native komponenta, lahko najdete tukaj.

Vue

Našo Vue knjižnico lahko najdete na NPM tukaj.

Dodatno je knjižnica vue-next na NPM tukaj

Izvorno kodo lahko najdete na GitHub.

FastComments Vue pripomoček za komentarje podpira vse enake funkcije kot različica VanillaJS — komentiranje v realnem času, SSO in tako naprej.

Navodila spodaj so za Vue 3, saj je izšel že nekaj časa, vendar FastComments podpira tudi Vue 2 prek knjižnice fastcomments-vue.

FastComments Vue prek NPM

Copy

npm install --save fastcomments-vue-next

FastComments Vue prek Yarn

Copy

yarn add fastcomments-vue-next

Vue primer

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>

Če ste v EU, boste želeli nastaviti region na EU:

FastComments Vue - EU

Copy

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

Knjižnici fastcomments-vue in fastcomments-vue-next podpirata enako konfiguracijo kot VanillaJS pripomoček za komentarje.

Konfiguracijo, ki jo podpira Vue komponenta, lahko najdete tukaj.

TypeScript

TypeScript definicije za FastComments lahko najdete na NPM tukaj.

Najdete jih na GitHub tukaj.

Več primerkov na isti strani

Vsaka instanca pripomočka za komentarje je izolirana. Zato FastComments naravno podpira več kot eno instanco na stran.

Pogosti primeri uporabe

Prikaži komentarje v živo takoj

Pripomoček za komentarje je privzeto v živo, vendar se komentarji v živo prikažejo pod gumbom "Prikaži N novih komentarjev".

Dovoli anonimno komentiranje

Privzeto FastComments zahteva, da uporabnik ob komentiranju pusti e-pošto. To je mogoče onemogočiti.

Odpravljanje pogostih težav

Tukaj je nekaj simptomov, s katerimi se pogosto srečujemo, in pogoste rešitve.

Sporočilo "This is a demo"

To se prikaže, ko ste kopirali kodo vtičnika z naše domače strani, ki uporablja naš demo tenant. Če želite uporabljati svoj tenant, kopirajte kodo vtičnika s te strani.

Napaka "FastComments cannot load on this domain"

FastComments mora vedeti, katera domenska imena so v vaši lasti, da lahko preveri zahteve, povezane z vašim računom. Oglejte si našo dokumentacijo, da vidite, kako odpraviti to napako (preprosto dodajte točno subdomeno + domeno v svoj račun).

Upoštevajte, da se to običajno zgodi šele po koncu poskusnega obdobja. Med poskusnim obdobjem bodo vse zahteve z novih domen samodejno dodane v vaš račun.

Migrirani komentarji se ne prikazujejo za prilagojene inštalacije

Običajno se to zgodi, ko so uvoženi komentarji vezani na Page ID, vi pa posredujete URL (ali nobene vrednosti, v tem primeru privzeto uporabljeno vrednost URL strani).

To lahko odpravite tako, da izvozite svoje komentarje in si ogledate stolpec URL ID (trenutno stolpec B).

Prepričajte se, da so vrednosti, ki jih vidite v stolpcu URL ID, enake vrednostim, ki jih posredujete konfiguraciji vtičnika kot parameter urlId.

Za dodatno razlago poskusite prebrati našo dokumentacijo Kako so komentarji vezani na strani in članke.

Če vse drugo odpove, nam pišite.

Komentarni vtičnik se ne prikazuje

Če se komentarni vtičnik ne prikaže, preverite Chrome razvojno konzolo za napake.

Pri večini napačnih konfiguracij se bo komentarni vtičnik vsaj prikazal z napako na strani, če se mu uspe naložiti. Če ne vidite ničesar, je to običajno znak skriptne napake.

Želena konfiguracija ne deluje po pričakovanjih

Poskusite naš Chrome razširitev, da vidite, katera konfiguracija se posreduje komentarjem. Če vse odpove, naredite posnetek zaslona tistega, kar pove razširitev, in nam pišite.

Komentarji manjkajo na istem URL z različnim hash-bangom

Privzeto FastComments uporablja URL strani kot "vedro", kjer so shranjeni komentarji. Če vaši URL-ji vsebujejo #hashbangs, in ti #hashbangs ne bi smeli biti del identifikatorja, ki določa niti komentarjev, jih lahko preprosto zanemarimo, na primer:

Primer: ignoriranje hash-bangov

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>

Upoštevajte, da bo po tej spremembi treba izvesti migracijo za obstoječe komentarje. V ta namen nam pišite.

Vpliv URL parametrov poizvedbe na vtičnik

Privzeto FastComments uporablja URL strani kot "vedro", kjer so shranjeni komentarji. Če vaši URL-ji vsebujejo parametre poizvedbe, ki ne bi smeli biti del identifikatorja niti komentarja, jih lahko preprosto zanemarimo, na primer:

Ignoriranje parametrov poizvedbe

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>

Upoštevajte, da bo po tej spremembi treba izvesti migracijo za obstoječe komentarje. V ta namen nam pišite.

Ne prejemate e-pošte

V FastComments vložimo veliko truda, da je dostava naših e-poštnih sporočil čim bolj zanesljiva. Vendar so nekateri ponudniki e-pošte znano težavni za zanesljivo dostavo. Preverite mapo z vsiljeno pošto za sporočila s strani fastcomments.com.

Če nam pišete, vam običajno lahko damo več informacij o tem, zakaj morda ne vidite naših e-poštnih sporočil.

Notion in Google Sites

Želite dodati komentarje na svoje Notion strani? Mi smo tu za vas.

Notion

Za dodajanje komentiranja na Notion dokumente, si oglejte pojasnjevalni video tukaj.

Google Sites

Google Sites je prav tako podprt in potek je podoben.

Naslednji vodnik

Vtičniki tretjih oseb

Prilagojene namestitve

Vstavljanje v dokumente

Add Comments To a Website

Namestitev

WordPress

VanillaJS / HTML izsek

Angular

Uporaba

React

React Native

Vue

TypeScript

Več primerkov na isti strani

Pogosti primeri uporabe

Prikaži komentarje v živo takoj

Dovoli anonimno komentiranje

Odpravljanje pogostih težav

Sporočilo "This is a demo"

Napaka "FastComments cannot load on this domain"

Migrirani komentarji se ne prikazujejo za prilagojene inštalacije

Komentarni vtičnik se ne prikazuje

Želena konfiguracija ne deluje po pričakovanjih

Komentarji manjkajo na istem URL z različnim hash-bangom

Vpliv URL parametrov poizvedbe na vtičnik

Ne prejemate e-pošte

Notion in Google Sites

Notion

Google Sites

Jezik 🇸🇮 Slovenščina

Vtičniki tretjih oseb

Prilagojene namestitve

Vstavljanje v dokumente

Add Comments To a Website

Namestitev

WordPress

VanillaJS / HTML izsek

Angular

Uporaba

React

React Native

Vue

TypeScript

Več primerkov na isti strani

Pogosti primeri uporabe

Prikaži komentarje v živo takoj

Dovoli anonimno komentiranje

Odpravljanje pogostih težav

Sporočilo "This is a demo"

Napaka "FastComments cannot load on this domain"

Migrirani komentarji se ne prikazujejo za prilagojene inštalacije

Komentarni vtičnik se ne prikazuje

Želena konfiguracija ne deluje po pričakovanjih

Komentarji manjkajo na istem URL z različnim hash-bangom

Vpliv URL parametrov poizvedbe na vtičnik

Ne prejemate e-pošte

Notion in Google Sites

Notion

Google Sites