Installation | FastComments Docs

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

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 "To je demo"

To se prikaže, ko ste kopirali kodo pripomočka z naše domače strani, ki uporablja naš demo najemnik. Za uporabo vašega najemnika kopirajte kodo pripomočka od tukaj.

Napaka "FastComments se ne more naložiti na tej domeni"

FastComments mora vedeti, katere domene so v vaši lasti, da lahko avtenticira zahteve, povezane z vašim računom. Oglejte si našo dokumentacijo, da vidite, kako odpraviti to napako (preprosto dodajte natančno poddomeno + domeno v vaš račun).

Upoštevajte, da bi se to moralo zgoditi šele po preteku preizkusnega obdobja. Med preizkusnim obdobjem se bodo vse zahteve z novih domen samodejno dodale v vaš račun.

Preseljeni komentarji se ne prikazujejo za prilagojene namestitve

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

To lahko razhroščujete z izvozom vaših komentarjev in ogledom stolpca URL ID (trenutno stolpec B).

Zagotovite, da so vrednosti, ki jih vidite v stolpcu URL ID, enake vrednostim, ki jih posredujete konfiguraciji pripomočka kot parameter urlId.

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

Če vse drugo odpove, se obrnite na nas.

Pripomoček za komentarje se ne prikazuje

Če se pripomoček za komentarje ne prikazuje, preverite razvojno konzolo Chrome za napake.

Za večino napačnih konfiguracij bo pripomoček za komentarje vsaj prikazal napako na strani, če se lahko naloži. Ne videti ničesar običajno kaže na skriptno napako.

Želena konfiguracija ne deluje po pričakovanjih

Preizkusite našo razširitev za Chrome, da vidite, katera konfiguracija se posreduje pripomočku za komentarje. Če vse odpove, naredite posnetek zaslona, kaj pravi razširitev chrome, in se obrnite na nas.

Komentarji manjkajo na istem URL z različnim hash bangom

Privzeto bo FastComments uporabil URL strani za "vedro", kjer se shranjujejo komentarji. Če vaši URL-ji vključujejo #hashbange, in ti #hashbangi ne bi smeli biti del identifikatorja, ki identificira nit komentarjev, lahko preprosto ignoriramo vrednost hash bang, na primer:

Primer ignoriranja hash bangov

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>

Upoštevajte, da bo po tej spremembi za obstoječe komentarje potrebna migracija. Za to se obrnite na nas.

Parametri poizvedbe URL vplivajo na pripomoček

Privzeto bo FastComments uporabil URL strani za "vedro", kjer se shranjujejo komentarji. Če vaši URL-ji vključujejo parametre poizvedbe, ki ne bi smeli biti del identifikatorja, ki identificira nit komentarjev, jih lahko preprosto ignoriramo, na primer:

Ignoriraj parametre poizvedbe

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>

Upoštevajte, da bo po tej spremembi za obstoječe komentarje potrebna migracija. Za to se obrnite na nas.

Ne prejemate e-pošte

Pri FastComments vlagamo veliko truda, da zagotovimo, da je dostava naše e-pošte čim bolj zanesljiva. Vendar pa je nekaterim ponudnikom e-pošte notorično težko zanesljivo dostavljati. Preverite svojo mapo spam za sporočila od fastcomments.com.

Če se obrnete na nas, vam lahko običajno zagotovimo več vpogleda, zakaj morda ne vidite e-pošte od nas.

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

Namestitev

WordPress

VanillaJS / HTML-vstavek

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 "To je demo"

Napaka "FastComments se ne more naložiti na tej domeni"

Preseljeni komentarji se ne prikazujejo za prilagojene namestitve

Pripomoček za komentarje se ne prikazuje

Želena konfiguracija ne deluje po pričakovanjih

Komentarji manjkajo na istem URL z različnim hash bangom

Parametri poizvedbe URL vplivajo na pripomoček

Ne prejemate e-pošte

Notion in Google Sites

Notion

Google Sites

Jezik 🇸🇮 Slovenščina

Vtičniki tretjih oseb

Prilagojene namestitve

Vstavljanje v dokumente

Namestitev

WordPress

VanillaJS / HTML-vstavek

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 "To je demo"

Napaka "FastComments se ne more naložiti na tej domeni"

Preseljeni komentarji se ne prikazujejo za prilagojene namestitve

Pripomoček za komentarje se ne prikazuje

Želena konfiguracija ne deluje po pričakovanjih

Komentarji manjkajo na istem URL z različnim hash bangom

Parametri poizvedbe URL vplivajo na pripomoček

Ne prejemate e-pošte

Notion in Google Sites

Notion

Google Sites