Installation | FastComments Docs

Instalacija

FastComments je dizajniran da se može instalirati na bilo koju vrstu stranice - statičku ili dinamičku, sa svijetlom ili tamnom temom, javne ili interne stranice. Treba biti lako instalirati i prilagoditi za bilo koju vrstu stranice ili web-aplikacije.

WordPress

Naš WordPress dodatak možete pronaći ovdje.

Potpuni vodič za instalaciju i dokumentacija o dodatku nalaze se ovdje.

Ovaj dodatak podržava komentiranje uživo, SSO i instalaciju bez koda.

VanillaJS / HTML isječak

VanillaJS verzija widgeta vrlo je jednostavna za instalaciju, ne zahtijeva sustave za izradu ili kod na strani poslužitelja.

Jednostavno dodajte sljedeći isječak koda na bilo koju stranicu:

Jednostavan isječak koda

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>

Možete koristiti isti isječak koda na mnogim stranicama; automatski će stvoriti zasebnu nit za svaku stranicu.

Dokumentaciju o konfiguriranju widgeta možete pronaći ovdje.

Angular

Našu Angular biblioteku možete pronaći na NPM-u ovdje.

FastComments Angular widget za komentare podržava sve iste značajke kao VanillaJS verzija — komentiranje u stvarnom vremenu, SSO i tako dalje.

Trebat će vam fastcomments-typescript, koji je peer ovisnost. Molimo osigurajte da je uključen u vašu TypeScript kompilaciju. U budućnosti će ova peer ovisnost biti premještena u @types/fastcomments što će pojednostaviti instalaciju.

FastComments Angular putem NPM-a

Copy

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

Peer ovisnost treba dodati u vašu tsconfig.json datoteku, na primjer:

Dodavanje fastcomments-typescript peer ovisnosti

Copy

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

Zatim dodajte FastCommentsModule u vašu aplikaciju:

Dodajte modul u vašu aplikaciju

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

Korištenje

Za početak, prosljeđujemo konfiguracijski objekt za demo tenant:

Korištenje - Inline konfiguracija

Copy

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

Budući da konfiguracija može postati prilično složena, možemo proslijediti referencu objekta:

Korištenje - Proslijedi objekt za konfiguraciju

Copy

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

Korištenje - EU

Copy

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

Widget koristi detekciju promjena, tako da će promjena bilo kojih svojstava konfiguracijskog objekta uzrokovati ponovno učitavanje.

Konfiguraciju koju Angular komponenta podržava možete pronaći ovdje.

React

Našu React biblioteku možete pronaći na NPM-u ovdje.

FastComments React widget za komentare podržava sve iste značajke kao VanillaJS verzija — komentiranje u stvarnom vremenu, SSO i tako dalje.

FastComments React putem NPM-a

Copy

npm install --save fastcomments-react

FastComments React putem Yarna

Copy

yarn add fastcomments-react

React primjer

Copy

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

Ako ste u EU, željet ćete postaviti parametar region ovako:

React primjer - EU

Copy

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

Konfiguraciju koju React komponenta podržava možete pronaći ovdje.

React Native

Našu React Native biblioteku možete pronaći na NPM-u ovdje.

FastComments React Native widget za komentare podržava sve iste značajke kao VanillaJS verzija — komentiranje u stvarnom vremenu, SSO i tako dalje.

FastComments React Native putem NPM-a

Copy

npm install --save fastcomments-react-native

FastComments React Native putem Yarna

Copy

yarn add fastcomments-react-native

Konfiguracija se specificira malo drugačije u usporedbi s fastcomments-react bibliotekom:

React Native primjer

Copy

import { FastCommentsCommentWidget } from 'fastcomments-react-native';
// ...
  const tenantId = 'demo'; // Vaš tenant id. Može se dohvatiti s https://fastcomments.com/auth/my-account/api-secret
  const pageId = 'native-test'; // ID ili URL niti komentara u vašoj aplikaciji.
  const config = {
    tenantId: tenantId,
    urlId: pageId
  };
  return (
      <FastCommentsCommentWidget config={config}/>
  );

Ako ste u EU, željet ćete postaviti parametar region:

React Native - EU

Copy

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

Konfiguraciju koju React Native komponenta podržava možete pronaći ovdje.

Vue

Našu Vue biblioteku možete pronaći na NPM-u ovdje.

Dodatno, vue-next biblioteka je na NPM-u ovdje

Izvorni kod možete pronaći na GitHubu.

FastComments Vue widget za komentare podržava sve iste značajke kao VanillaJS verzija — komentiranje u stvarnom vremenu, SSO i tako dalje.

Upute ispod su za Vue 3 budući da je izašao prije nekog vremena, međutim FastComments također podržava Vue 2 putem fastcomments-vue biblioteke.

FastComments Vue putem NPM-a

Copy

npm install --save fastcomments-vue-next

FastComments Vue putem Yarna

Copy

yarn add fastcomments-vue-next

Vue primjer

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>

Ako ste u EU, željet ćete postaviti region na EU:

FastComments Vue - EU

Copy

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

Biblioteke fastcomments-vue i fastcomments-vue-next podržavaju istu konfiguraciju kao VanillaJS widget za komentare.

Konfiguraciju koju Vue komponenta podržava možete pronaći ovdje.

TypeScript

TypeScript definicije za FastComments mogu se pronaći na NPM-u ovdje.

Možete ih pronaći na GitHubu ovdje.

Više instanci na istoj stranici

Svaka instanca widgeta za komentare je izolirana. Zbog toga FastComments prirodno podržava više od jedne instance po stranici.

Uobičajeni slučajevi korištenja

Prikaži komentare uživo odmah

Widget za komentare je uživo prema zadanim postavkama, ali se komentari uživo pojavljuju ispod gumba "Prikaži N novih komentara".

Dopusti anonimno komentiranje

Prema zadanim postavkama, FastComments zahtijeva da korisnik ostavi e-poštu prilikom komentiranja. Ovo se može onemogućiti.

Rješavanje uobičajenih problema

Ovdje su neki simptomi s kojima se često susrećemo i uobičajena rješenja.

Poruka "Ovo je demo"

Ovo se prikazuje kada ste kopirali kod widgeta s naše početne stranice, koji koristi naš demo tenant. Za korištenje vašeg tenanta, kopirajte kod widgeta odavde.

Greška "FastComments ne može se učitati na ovoj domeni"

FastComments mora znati koje domene su u vašem vlasništvu kako bi autentificirao zahtjeve povezane s vašim računom. Pogledajte našu dokumentaciju da biste vidjeli kako riješiti ovu grešku (jednostavno dodajte točnu poddomenu + domenu na vaš račun).

Imajte na umu da bi se ovo trebalo dogoditi samo nakon isteka probnog razdoblja. Tijekom probnog razdoblja, svi zahtjevi s novih domena automatski će se dodati na vaš račun.

Migrirani komentari se ne prikazuju za prilagođene instalacije

Obično se to događa kada su uvezeni komentari vezani za Page ID, a vi prosljeđujete URL (ili nikakvu vrijednost, u kojem slučaju se koristi URL stranice).

Ovo možete debugirati izvozom vaših komentara i pregledavanjem stupca URL ID (trenutno stupac B).

Osigurajte da su vrijednosti koje vidite u stupcu URL ID iste vrijednosti koje prosljeđujete konfiguraciji widgeta kao parametar urlId.

Za dodatno objašnjenje, pokušajte pročitati našu dokumentaciju Kako su komentari vezani za stranice i članke.

Ako sve drugo ne uspije, obratite nam se.

Ako se widget za komentare ne prikazuje, provjerite Chrome developer konzolu za greške.

Za većinu pogrešnih konfiguracija, widget za komentare će barem prikazati grešku na stranici ako se može učitati. Ne vidjeti ništa obično ukazuje na skriptnu grešku.

Željena konfiguracija ne radi kako se očekuje

Isprobajte naše Chrome proširenje da vidite koja konfiguracija se prosljeđuje widgetu za komentare. Ako sve propadne, napravite snimku zaslona što chrome proširenje kaže i obratite nam se.

Komentari nedostaju na istom URL-u s različitim hash bangom

Prema zadanim postavkama, FastComments će koristiti URL stranice za "bucket" gdje se komentari pohranjuju. Ako vaši URL-ovi uključuju #hashbangove, i ti #hashbangovi ne bi trebali biti dio identifikatora koji identificira nit komentara, možemo jednostavno ignorirati hash bang vrijednost, na primjer:

Primjer ignoriranja hash bangova

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>

Imajte na umu da će nakon ove promjene biti potrebna migracija za postojeće komentare. Za to nam se obratite.

Prema zadanim postavkama, FastComments će koristiti URL stranice za "bucket" gdje se komentari pohranjuju. Ako vaši URL-ovi uključuju parametre upita koji ne bi trebali biti dio identifikatora koji identificira nit komentara, možemo ih jednostavno ignorirati, na primjer:

Ignoriraj parametre upita

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>

Imajte na umu da će nakon ove promjene biti potrebna migracija za postojeće komentare. Za to nam se obratite.

Ne primate e-mailove

U FastCommentsu ulažemo puno truda kako bismo osigurali da je isporuka naših e-mailova što pouzdanija. Međutim, nekim pružateljima e-mail usluga notorno je teško pouzdano isporučivati. Provjerite vašu spam mapu za poruke od fastcomments.com.

Ako nam se obratite obično možemo pružiti više uvida zašto možda ne vidite e-mailove od nas.

Notion i Google Sites

Želite dodati komentare na svoje Notion stranice? Mi smo tu za vas.

Notion

Za dodavanje komentiranja na Notion dokumente, pogledajte video objašnjenje ovdje.

Google Sites

Google Sites je također podržan, a tijek je sličan.

Sljedeći vodič

Dodaci trećih strana

Prilagođene instalacije

Umetanje u dokumente

Instalacija

WordPress

VanillaJS / HTML isječak

Angular

Korištenje

React

React Native

Vue

TypeScript

Više instanci na istoj stranici

Uobičajeni slučajevi korištenja

Prikaži komentare uživo odmah

Dopusti anonimno komentiranje

Rješavanje uobičajenih problema

Poruka "Ovo je demo"

Greška "FastComments ne može se učitati na ovoj domeni"

Migrirani komentari se ne prikazuju za prilagođene instalacije

Widget za komentare se ne prikazuje

Željena konfiguracija ne radi kako se očekuje

Komentari nedostaju na istom URL-u s različitim hash bangom

URL parametri upita utječu na widget

Ne primate e-mailove

Notion i Google Sites

Notion

Google Sites

Jezik 🇭🇷 Hrvatski

Dodaci trećih strana

Prilagođene instalacije

Umetanje u dokumente

Instalacija

WordPress

VanillaJS / HTML isječak

Angular

Korištenje

React

React Native

Vue

TypeScript

Više instanci na istoj stranici

Uobičajeni slučajevi korištenja

Prikaži komentare uživo odmah

Dopusti anonimno komentiranje

Rješavanje uobičajenih problema

Poruka "Ovo je demo"

Greška "FastComments ne može se učitati na ovoj domeni"

Migrirani komentari se ne prikazuju za prilagođene instalacije

Widget za komentare se ne prikazuje

Željena konfiguracija ne radi kako se očekuje

Komentari nedostaju na istom URL-u s različitim hash bangom

URL parametri upita utječu na widget

Ne primate e-mailove

Notion i Google Sites

Notion

Google Sites