FastComments.com

Dodavanje komentara na veb-sajt


Instalacija

FastComments olakšava dodavanje komentara na vaš sajt, bilo da je statičan ili dinamičan, sa svetlom ili tamnom temom, za javne ili interne stranice. Treba da bude lako instalirati i prilagoditi je bilo kojoj vrsti sajta ili veb aplikacije. Ovo vam odmah omogućava komentarisanje uživo, bez potrebe za dodatnom konfiguracijom u mnogim slučajevima.


WordPress Internal Link

Da biste dodali komentare na svoj WordPress sajt, naš WordPress dodatak možete naći ovde.

Kompletan vodič za instalaciju i dokumentacija za dodatak su ovde.

Ovaj dodatak podržava komentarisanje uživo, SSO i instalaciju bez kodiranja. Jednostavno sledite vodič za instalaciju na administratorskoj stranici nakon instaliranja dodatka. On će vas voditi kroz povezivanje vaše WordPress instalacije sa vašim nalogom.

Svi komentari ostavljeni putem FastComments preko našeg WordPress dodatka mogu biti automatski sinhronizovani nazad 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 Internal Link

VanillaJS verzija vidžeta je najjednostavniji način da dodate komentare na vaš sajt, bez potrebe za build sistemima ili serverskim kodom.

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

Simple Code Snippet
Copy CopyRun External Link
1
2<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>
3<div id="fastcomments-widget"></div>
4<script>
5window.fcConfigs = [{
6 "tenantId": "demo"
7}];
8</script>
9

Možete koristiti isti isječak koda na više stranica; on će automatski kreirati zasebnu nit po stranici.

Mnoge aplikacije imaju opciju "HTML Embed Code". Izaberite tu opciju i nalepite gorenavedeni isječak koda.

Takođe vam ne treba nalog da biste probali! Možda ćete u gornjem isječku videti "tenantId: demo" ako niste prijavljeni. Na taj način koristiće se demo nalog.

Dokumentaciju za konfigurisanje vidžeta možete naći ovde.

Sve verzije FastComments vidžeta su omotači oko osnovne VanillaJS biblioteke. To nam omogućava da dodajemo funkcije i popravljamo greške na jednom mestu - i izmene se automatski propagiraju na druge varijante widgeta za komentare.

Angular Internal Link

Za dodavanje komentara na sajt izgrađen sa Angular-om, možete pronaći našu Angular biblioteku na NPM-u ovde.

FastComments Angular widget za komentare podržava sve iste funkcije kao i VanillaJS - komentarisanje uživo, sso, i tako dalje.

Biće vam potreban fastcomments-typescript, koji je peer zavisnost. Molimo proverite da je ovo uključeno u vašu TypeScript kompilaciju. U budućnosti će ova peer zavisnost biti premeštena u @types/fastcomments što će pojednostaviti ovu instalaciju.

FastComments Angular preko NPM-a
Copy Copy
1
2 npm install fastcomments-typescript --save
3 npm install ngx-fastcomments --save
4

Peer zavisnost treba da bude dodata u vaš tsconfig.json fajl, na primer:

Dodavanje peer zavisnosti fastcomments-typescript
Copy Copy
1
2"include": [
3 "src/**/*.ts",
4 "node_modules/fastcomments-typescript/src/index.ts"
5],
6

Zatim, dodajte FastCommentsModule u vašu aplikaciju:

Dodajte modul u vašu aplikaciju
Copy Copy
1
2import { BrowserModule } from '@angular/platform-browser';
3import { NgModule } from '@angular/core';
4
5import { AppComponent } from './app.component';
6import { FastCommentsModule } from 'ngx-fastcomments';
7
8@NgModule({
9 declarations: [
10 AppComponent
11 ],
12 imports: [
13 BrowserModule,
14 FastCommentsModule
15 ],
16 providers: [],
17 bootstrap: [AppComponent]
18})
19export class AppModule { }
20

Upotreba

Za početak, prosleđujemo config objekat za demo tenant:

Upotreba - Inline konfiguracija
Copy Copy
1
2<lib-fastcomments [config]="{ tenantId: 'demo' }"></lib-fastcomments>
3

Pošto konfiguracija može postati prilično komplikovana, možemo proslediti referencu na objekat:

Upotreba - Prosleđivanje objekta za konfiguraciju
Copy Copy
1
2<lib-fastcomments [config]="fastcommentsConfig"></lib-fastcomments>
3
Upotreba - EU
Copy Copy
1
2<lib-fastcomments [config]="{ tenantId: 'demo', region: 'eu' }"></lib-fastcomments>
3

Widget koristi detekciju promena, tako da promena bilo koje osobine konfiguracionog objekta izaziva njegovo ponovno učitavanje.

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


React Internal Link

Za dodavanje komentara na sajt napravljen sa React, možete pronaći našu React biblioteku na NPM ovde.

FastComments React komentatorski widget podržava sve iste funkcije kao i VanillaJS — komentarisanje uživo, sso, i tako dalje.

FastComments React preko NPM-a
Copy Copy
1
2npm install --save fastcomments-react
3
FastComments React preko Yarn-a
Copy Copy
1
2yarn add fastcomments-react
3
Primer za React
Copy Copy
1
2import React, { Component } from 'react'
3
4import {FastCommentsCommentWidget} from 'fastcomments-react'
5
6class Example extends Component {
7 render() {
8 return <FastCommentsCommentWidget tenantId="demo" />
9 }
10}
11

Ako se nalazite u EU, treba da podesite region parametar ovako:

Primer za React - EU
Copy Copy
1
2 <FastCommentsCommentWidget tenantId="demo" region="eu" />
3

Možete pronaći konfiguraciju koju React komponenta podržava ovde.


Vue Internal Link

Da biste dodali komentare na vaš vebsajt napravljen u Vue, možete pronaći našu Vue biblioteku na NPM ovde.

Pored toga, biblioteka vue-next je na NPM ovde

Izvorni kod se može naći na GitHub.

FastComments Vue widget za komentare podržava sve iste funkcije kao i VanillaJS — komentarisanje uživo, sso, i tako dalje.

Sledeće instrukcije su za Vue 3 pošto je izašao već neko vreme, međutim FastComments takođe podržava Vue 2 preko biblioteke fastcomments-vue.

FastComments Vue preko NPM
Copy Copy
1
2npm install --save fastcomments-vue-next
3
FastComments Vue preko Yarn
Copy Copy
1
2yarn add fastcomments-vue-next
3
Primer za Vue
Copy Copy
1
2<template>
3 <img alt="Vue logo" src="./assets/logo.png">
4 <fast-comments v-bind:config="{tenantId: 'demo'}"/>
5</template>
6
7<script>
8import {FastComments} from 'fastcomments-vue-next';
9
10export default {
11 name: 'App',
12 components: {
13 FastComments
14 }
15}
16</script>
17

Ako ste u EU, trebalo bi da podesite region na EU:

FastComments Vue - EU
Copy Copy
1
2<fast-comments v-bind:config="{tenantId: 'demo', region: 'eu'}"/>
3

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 ovde.

TypeScript Internal Link

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

Možete ih pronaći na GitHub-u ovde.

Višestruke instance na istoj stranici Internal Link

Each instance of the comment widget is isolated. Because of this, FastComments inherently supports more than one instance per page, or multiple instances pointing to the same chat thread.

In the case of the VanillaJS library for example, you simply have to tie the comment widget to different DOM nodes. If you want to simply update the current thread on the page, see Switching Comment Threads Without Reloading The Page;

Sinhronizacija stanja autentifikacije kroz više instanci

Let's go over the example of a custom single-page-application that is a list of frequently asked questions with their own comment thread.

In this case, we have multiple instances of FastComments in the DOM at once.

This is fine, but it poses some challenges for user experience.

Consider this flow:

  1. The user visits the page with a list of questions, each with their own comment widget.
  2. The user enters their username and email and leaves a question on one of the threads.
  3. They see another FAQ item they have a question about.
  4. They go to comment again. Do they have to enter their email and username again?

In this case, FastComments handles syncing the authentication state across widget instances for you. In step four, the user will already be temporarily authenticated since they entered their username and email on the same page.

Uobičajeni slučajevi upotrebe Internal Link

Prikazivanje živih komentara odmah

Widget za komentare je po defaultu aktivan, ali se živi komentari pojavljuju ispod dugmeta „Show N New Comments“ kako bi se sprečilo pomeranje sadržaja stranice.

U nekim slučajevima i dalje je poželjno prikazati nove komentare odmah, bez potrebe da se klikne dugme.

U tom slučaju, treba da omogućite flag showLiveRightAway, za koji možete pronaći dokumentaciju ovde.

Dozvoljavanje anonimnog komentarisanja (bez zahteva za e‑mail)

Po defaultu, FastComments zahteva od korisnika da ostavi e‑mail prilikom komentarisanja.

Ovo se može onemogućiti, uputstva su ovde.

Prilagođeno stilizovanje

Mnogi naši klijenti primenjuju sopstveni stil na widget za komentare. Dokumentaciju možete pronaći ovde.

Prikazivanje istih komentara na više domena

Prikazivanje istih komentara na više sajtova je nešto što FastComments podržava odmah iz kutije. Pogledajte našu dokumentaciju o ovoj temi.

Promena trenutne stranice

FastComments podržava SPA‑ove i složene aplikacije. Promena trenutne stranice je jednostavna i opisana ovde.