FastComments.com

Додавање коментара на веб-сајт

Инсталација

FastComments олакшава додавање коментара на ваш веб-сајт, било да је статичан или динамичан, са светлом или тамном темом, за јавне или интерне странице. Требало би да буде лако инсталирати и прилагодити га било којем типу сајта или веб апликације. Ово вам омогућава коментарисање уживо одмах, у многим случајевима без додатне конфигурације.

WordPress Internal Link

Да бисте додали коментаре на ваш WordPress сајт, наш WordPress додатак можете пронаћи овде.

Комплетан водич за инсталацију и документација о додатку налазе се овде.

Овај додатак подржава коментарисање у реалном времену, SSO и инсталацију без кода. Једноставно следите водич за инсталацију на админ страници после инсталирања додатка. Он ће вас провести кроз повезивање ваше WordPress инсталације са вашим налогом.

Сви коментари остављени преко FastComments помоћу нашег WordPress додатка могу бити аутоматски синхронизовани назад у вашу WordPress инсталацију тако да задржите контролу над својим подацима. Ово се може искључити да бисте ограничили величину ваше WordPress базе података.

VanillaJS / HTML исечак Internal Link

VanillaJS верзија видџета је најједноставнији начин да додате коментаре на ваш сајт, без потребе за системима за изградњу или серверским кодом.

Једноставно додајте следећи кодски исечак на било коју страницу да бисте додали коментаре на ваш сајт:

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

Исти кодски исечак можете користити на више страница; он ће аутоматски креирати засебну тему по страници.

Многе апликације имају опцију "HTML Embed Code". Изаберите ту и налепите горе наведени кодски исечак у њу.

Такође вам није потребан налог да то пробате! Можда ћете видети "tenantId: demo" у горе наведеном исечку ако нисте пријављени. На тај начин ће се користити демо налог.

Документацију о конфигурисању видџета можете пронаћи овде.

Све верзије FastComments видџета су омотачи око основне VanillaJS библиотеке. Ово нам омогућава да додамо функције и исправимо проблеме на једном месту - и промене се аутоматски проширују на остале варијанте коментарског видџета.

Angular Internal Link

За додавање коментара на сајт изграђен са Angular-ом, нашу Angular библиотеку можете пронаћи на NPM овде.

FastComments Angular виџет за коментаре подржава све исте функције као VanillaJS верзија - коментаре у реалном времену, sso и тако даље.

Потребан вам је fastcomments-typescript, који је peer dependency. Молимо вас да уверите да је укључен у вашу TypeScript компилацију. У будућности, ова peer dependency биће премештена у @types/fastcomments што ће поједноставити инсталацију.

FastComments Angular преко NPM
Copy Copy
1
2 npm install fastcomments-typescript --save
3 npm install ngx-fastcomments --save
4

Peer dependency треба додати у вашу tsconfig.json датотеку, на пример:

Додавање fastcomments-typescript peer dependency
Copy Copy
1
2"include": [
3 "src/**/*.ts",
4 "node_modules/fastcomments-typescript/src/index.ts"
5],
6

Затим додајте FastCommentsModule у вашу апликацију:

Додавање модула у вашу апликацију
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

Употреба

Да бисте започели, прослеђујемо конфигурациони објекат за demo tenant:

Употреба - Инлине конфигурација
Copy Copy
1
2<lib-fastcomments [config]="{ tenantId: 'demo' }"></lib-fastcomments>
3

Пошто конфигурација може постати прилично сложена, можемо проследити референцу на објекат:

Употреба - Прослеђивање објекта за конфигурацију
Copy Copy
1
2<lib-fastcomments [config]="fastcommentsConfig"></lib-fastcomments>
3
Употреба - ЕУ
Copy Copy
1
2<lib-fastcomments [config]="{ tenantId: 'demo', region: 'eu' }"></lib-fastcomments>
3

Виџет користи change detection, тако да промена било које особине конфигурационог објекта доводи до његовог поновног учитавања.

Конфигурацију коју Angular компонента подржава можете пронаћи овде.

React Internal Link

За додавање коментара на сајт направљен са React-ом, нашу React библиотеку можете пронаћи на NPM овде.

FastComments React виџет за коментаре подржава све исте функције као VanillaJS верзија - коментаре у реалном времену, sso и тако даље.

FastComments React преко NPM
Copy Copy
1
2npm install --save fastcomments-react
3
FastComments React преко Yarn
Copy Copy
1
2yarn add fastcomments-react
3
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

Ако сте у ЕУ, треба да подесите region параметар на следећи начин:

React пример - ЕУ
Copy Copy
1
2 <FastCommentsCommentWidget tenantId="demo" region="eu" />
3

Конфигурацију коју React компонента подржава можете пронаћи овде.

Vue Internal Link

Да бисте додали коментаре на свој веб сајт направљен помоћу Vue-а, нашу Vue библиотеку можете пронаћи на NPM овде.

Поред тога, vue-next библиотека се налази на NPM овде

Изворни код можете пронаћи на GitHub-у.

FastComments Vue виџет за коментаре подржава све исте функције као VanillaJS верзија - коментаре у реалном времену, sso и тако даље.

Упутства у наставку важе за Vue 3 јер је ту већ неко време, међутим FastComments такође подржава Vue 2 преко fastcomments-vue библиотеке.

FastComments Vue преко NPM-а
Copy Copy
1
2npm install --save fastcomments-vue-next
3
FastComments Vue преко Yarn-а
Copy Copy
1
2yarn add fastcomments-vue-next
3
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

Ако сте у ЕУ, желите да подесите region на EU:

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

Библиотеке fastcomments-vue и fastcomments-vue-next подржавају исту конфигурацију као VanillaJS виџет за коментаре.

Конфигурацију коју Vue компонента подржава можете пронаћи овде.

TypeScript Internal Link

TypeScript дефиниције за FastComments могу се пронаћи на NPM-у овде.

Можете их пронаћи на GitHub-у овде.

Више инстанци на истој страници Internal Link

Свака инстанца widget-а за коментаре је изолована. Због тога FastComments природно подржава више од једне инстанце по страници, или више инстанци које упућују на исту конверзацију.

У случају VanillaJS библиотеке, на пример, једноставно треба да повежете widget за коментаре са различитим DOM чворовима. Ако желите само да ажурирате тренутну конверзацију на страници, погледајте Switching Comment Threads Without Reloading The Page;

Синхронизација стања аутентификације између више инстанци

Прегледајмо пример прилагођене једностраничне апликације која је листа често постављаних питања са својом конверзацијом за коментаре.

У овом случају, имамо више инстанци FastComments у DOM-у истовремено.

То је у реду, али представља неке изазове за корисничко искуство.

Размотрите овај ток:

  1. Корисник посећује страницу са листом питања, свако са сопственим widget-ом за коментаре.
  2. Корисник уноси своје корисничко име и имејл и оставља питање у једној од конверзација.
  3. Видише још један FAQ ставку о којој има питање.
  4. Поново иду да коментаришу. Да ли морају поново унети свој имејл и корисничко име?

У овом случају, FastComments за вас управља синхронизацијом стања аутентификације између инстанци widget-а. У четвртом кораку, корисник ће већ бити привремено аутентификован јер је унео своје корисничко име и имејл на истој страници.

Чести случајеви употребе Internal Link

Приказивање живих коментара одмах

Виџет за коментаре је подразумевано жив, али живи коментари се појављују испод дугмета „Show N New Comments“ како би се спречило померање садржаја странице.

У неким случајевима је и даље пожељно приказати нове коментаре одмах, без потребе за кликом на дугме.

У овом случају, желите да омогућите заставицу showLiveRightAway, за коју можете пронаћи документацију овде.

Омогућавање анонимног коментарисања (без захтева за е‑пошту)

Подразумевано, FastComments захтева од корисника да остави е‑пошту приликом коментарисања.

Ово се може онемогућити, упутства су овде.

Да би се посетиоци такође ослободили избора корисничког имена, FastComments може генерисати једно за сваког посетиоца.

Прилагођени стил

Многи од наших клијената примењују сопствени стил на виџет за коментаре. Документацију можете пронаћи овде.

Приказ истих коментара на више домена

Приказ истих коментара на више сајтова је функција коју FastComments подржава одмах. Погледајте нашу документацију о овој теми.

Промена тренутне странице

FastComments подржава SPA‑ове и сложене апликације. Промена тренутне странице је лака и објашњена овде.