Add Comments To a Website

Instalacija

FastComments olakšava dodavanje komentara na vašu web-stranicu, bilo da je statična ili dinamična, u svijetlom ili tamnom izdanju, za javne ili interne stranice. Treba biti jednostavno instalirati i prilagoditi bilo kojoj vrsti stranice ili web-aplikacije. To vam omogućuje komentiranje uživo odmah, bez potrebe za dodatnom konfiguracijom u mnogim slučajevima.

WordPress

Da biste dodali komentare na svoju WordPress stranicu, naš WordPress dodatak možete pronaći ovdje.

Kompletan vodič za instalaciju i dokumentacija vezana uz dodatak nalaze se ovdje.

Ovaj dodatak podržava komentiranje uživo, SSO i instalaciju bez koda. Jednostavno slijedite vodič za instalaciju na administracijskoj stranici nakon instalacije dodatka. On će vas voditi kroz povezivanje vaše WordPress instalacije s vašim računom.

Svi komentari ostavljeni putem FastComments kroz naš WordPress dodatak mogu se automatski sinkronizirati natrag u vašu WordPress instalaciju tako da zadržite kontrolu nad svojim podacima. Ovo se može isključiti kako biste ograničili veličinu vaše WordPress baze podataka.

VanillaJS / HTML isječak

Verzija widgeta za VanillaJS najjednostavniji je način dodavanja komentara na vašu web-stranicu, ne zahtijevajući nikakve build sustave ili serverski kod.

Jednostavno dodajte sljedeći isječak koda na bilo koju stranicu da biste dodali komentare na vašu stranicu:

Simple Code Snippet
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 isječak koda možete koristiti na mnogim stranicama; automatski će stvoriti zasebnu temu za svaku stranicu.

Mnoge aplikacije imaju opciju "HTML kod za umetanje". Odaberite tu opciju i zalijepite gore navedeni isječak koda.

Ne morate imati račun da biste to isprobali! Možda ćete vidjeti "tenantId: demo" u gore navedenom isječku ako niste prijavljeni. Na taj način će se koristiti demo račun.

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

Sve verzije FastComments widgeta su omotači oko osnovne VanillaJS biblioteke. To nam omogućuje dodavanje značajki i ispravljanje problema na jednom mjestu - i promjene se automatski prosljeđuju na druge varijante widgeta za komentare.

Angular

Za dodavanje komentara na web-stranicu izgrađenu s Angularom, našu Angular biblioteku možete pronaći na NPM-u ovdje.

FastComments Angular widget za komentare podržava sve iste značajke kao i VanillaJS verzija - uživo komentiranje, SSO i slično.

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

FastComments Angular putem NPM-a

Copy

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

Peer ovisnost trebate dodati u svoju datoteku tsconfig.json, na primjer:

Dodavanje peer ovisnosti fastcomments-typescript

Copy

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

Zatim dodajte FastCommentsModule u svoju aplikaciju:

Dodajte modul u svoju 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 { }

Usage

Za početak, prosljeđujemo objekt konfiguracije 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 na objekt:

Korištenje - Proslijedite 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 koje svojstva objekta konfiguracije uzrokovati njegovo ponovno učitavanje.

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

React

Za dodavanje komentara na web-stranicu izrađenu s Reactom, našu React biblioteku možete pronaći na NPM-u ovdje.

FastComments React widget za komentiranje podržava sve iste značajke kao i VanillaJS - komentiranje uživo, sso, i tako dalje.

FastComments React putem NPM-a

Copy

npm install --save fastcomments-react

FastComments React putem Yarn-a

Copy

yarn add fastcomments-react

Primjer za React

Copy

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

Ako se nalazite u EU, trebali biste postaviti parametar region ovako:

Primjer za React - EU

Copy

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

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

React Native

Da biste dodali komentare u vašu React Native aplikaciju, možete pronaći našu React Native biblioteku na NPM-u ovdje.

Komentatorski widget FastComments za React Native podržava sve iste značajke kao i VanillaJS verzija — komentiranje uživo, SSO i slično.

FastComments React Native putem NPM

Copy

npm install --save fastcomments-react-native

FastComments React Native putem Yarn

Copy

yarn add fastcomments-react-native

Konfiguracija se navodi nešto drugačije u usporedbi s fastcomments-react bibliotekom:

Primjer React Native

Copy

import { FastCommentsCommentWidget } from 'fastcomments-react-native';
// ...
  const tenantId = 'demo'; // ID vašeg tenant-a. Može se dohvatiti na 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 se nalazite u EU, trebali biste postaviti parametar region:

React Native - EU

Copy

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

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

Vue

Da biste dodali komentare na vašu web stranicu izgrađenu s Vue, naš Vue paket možete pronaći na NPM-u ovdje.

Također, biblioteku vue-next možete pronaći na NPM-u ovdje

Izvorni kod možete pronaći na GitHubu.

FastComments Vue widget za komentare podržava sve iste značajke kao i VanillaJS - komentiranje uživo, sso i slično.

Upute u nastavku odnose se na Vue 3 jer je već neko vrijeme dostupan, no FastComments također podržava Vue 2 putem biblioteke fastcomments-vue.

FastComments Vue preko NPM

Copy

npm install --save fastcomments-vue-next

FastComments Vue preko Yarn

Copy

yarn add fastcomments-vue-next

Primjer Vue

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 se nalazite u EU, trebali biste 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 i 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 li dodati komentare na svoje Notion stranice, Google Sites ili Nimbus Notes? Imamo rješenje.

Notion

Za dodavanje komentiranja u Notion dokumente, pogledajte objašnjavajući video ovdje.

Google Sites

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

Kreirajte razgovor za ugradnju.
Prilikom uređivanja svojeg Google Site-a, idite na Insert -> Embed. Odaberite By URL.
Zalijepite URL iz koraka 1.
Kliknite Insert. Gotovo!

Napomena: komentari se neće pojaviti dok ne objavite

Nimbus Note

Dodavanje komentiranja uživo u Nimbus Note također je podržano, a postupak je sličan Notionu.

Kreirajte razgovor za ugradnju.
Prilikom uređivanja bilješke, dodajte blok za ugradnju.
Upotrijebite URL iz koraka 1 kao URL za ugradnju.
Gotovo!

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

Usage

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

Nimbus Note

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

Usage

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

Nimbus Note