Add Comments To a Website

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 upotrebe

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.

Otklanjanje uobičajenih problema

Ispod se nalaze neki simptomi koji se često pojavljuju i uobičajena rješenja.

"This is a demo" Poruka

Ovo se prikazuje kada ste kopirali kod widgeta s naše početne stranice, koja koristi naš demo tenant. Da biste koristili svoj tenant, kopirajte kod widgeta s ovdje.

"FastComments cannot load on this domain" Greška

FastComments mora znati koje domene pripadaju vama kako bi autentificirao zahtjeve povezane s vašim računom. Pogledajte našu dokumentaciju da vidite kako riješiti ovu grešku (jednostavno dodajte točan subdomen + domenu na svoj račun).

Imajte na umu da se ovo obično događa tek nakon isteka probnog razdoblja. Tijekom probnog razdoblja, svi zahtjevi s novih domena će se automatski 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 uz Page ID, a vi prosljeđujete URL (ili nijednu vrijednost, u kojem slučaju se koristi zadani URL stranice).

Možete debugirati ovo izvozom svojih komentara i pregledom stupca URL ID (trenutno stupac B).

Provjerite jesu li 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 How Comments are Tied to Pages and Articles.

Ako ništa drugo ne pomogne, obratite nam se.

Ako se widget za komentare ne prikazuje, provjerite Chrome konzolu za programere zbog grešaka.

Za većinu pogrešne konfiguracije, widget za komentare će se barem prikazati s greškom na stranici ako uspije učitati. Ako se ne vidi ništa, obično je to pokazatelj skriptne greške.

Željena konfiguracija ne radi kako se očekuje

Isprobajte našu Chrome ekstenziju da vidite koju konfiguraciju widget za komentare zapravo prima. Ako ništa ne pomogne, snimite zaslon onoga što Chrome ekstenzija prikazuje i obratite nam se.

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

Po defaultu, FastComments će koristiti URL stranice za "bucket" u kojem se komentari pohranjuju. Ako vaši URL-ovi uključuju #hashbangs, i ti #hashbangs ne bi trebali biti dio identifikatora koji identificira thread komentara, možemo jednostavno ignorirati vrijednost hash banga, na primjer:

Primjer ignoriranja hash-bangova

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>

Imajte na umu da će nakon ove promjene za postojeće komentare trebati izvršiti migraciju. Za to, obratite nam se.

Po defaultu, FastComments će koristiti URL stranice za "bucket" u kojem se komentari pohranjuju. Ako vaši URL-ovi uključuju query parametre koji ne bi trebali biti dio identifikatora koji identificira thread komentara, možemo ih jednostavno ignorirati, na primjer:

Ignoriraj parametre upita

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>

Imajte na umu da će nakon ove promjene za postojeće komentare trebati izvršiti migraciju. Za to, obratite nam se.

Ne primate e-poštu

U FastCommentsu ulažemo puno truda kako bismo osigurali da je slanje naših e-pošta što pouzdanije. Međutim, nekim pružateljima e-pošte je iznimno teško pouzdano dostaviti poruke. Provjerite svoju mapu neželjene pošte za poruke od fastcomments.com.

Ako nam obratite se obično možemo dati više informacija zašto možda ne vidite e-poruke 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

Ugrađivanje u dokumente

Add Comments To a Website

Instalacija

WordPress

VanillaJS / HTML isječak

Angular

Korištenje

React

React Native

Vue

TypeScript

Više instanci na istoj stranici

Uobičajeni slučajevi upotrebe

Prikaži komentare uživo odmah

Dopusti anonimno komentiranje

Otklanjanje uobičajenih problema

"This is a demo" Poruka

"FastComments cannot load on this domain" Greška

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 istoj URL-u s različitim hash-bangom

Parametri upita u URL-u koji utječu na widget

Ne primate e-poštu

Notion i Google Sites

Notion

Google Sites

Jezik 🇭🇷 Hrvatski

Dodaci trećih strana

Prilagođene instalacije

Ugrađivanje u dokumente

Add Comments To a Website

Instalacija

WordPress

VanillaJS / HTML isječak

Angular

Korištenje

React

React Native

Vue

TypeScript

Više instanci na istoj stranici

Uobičajeni slučajevi upotrebe

Prikaži komentare uživo odmah

Dopusti anonimno komentiranje

Otklanjanje uobičajenih problema

"This is a demo" Poruka

"FastComments cannot load on this domain" Greška

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 istoj URL-u s različitim hash-bangom

Parametri upita u URL-u koji utječu na widget

Ne primate e-poštu

Notion i Google Sites

Notion

Google Sites