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


For adding comments to a site built with Angular, you can find our Angular library on NPM овде.

The FastComments Angular commenting widget supports all of the same features of the VanillaJS one - live commenting, sso, and so on.

You will need fastcomments-typescript, which is a peer dependency. Please ensure this is included in your TypeScript compilation. In the future, this peer dependency will be moved to @types/fastcomments which will simplify this installation.

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

The peer dependency should be added in your tsconfig.json file, for example:

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

Then, add the FastCommentsModule to your application:

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

Употреба

To get started, we pass a config object for the demo tenant:

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

Since the configuration can get quite complicated, we can pass in an object reference:

Употреба - Проследите објекат за конфигурацију
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

The widget uses change detection, so changing any properties of the configuration object will cause it to be reloaded.

You can find the configuration the Angular component supports овде.


React Internal Link

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

The FastComments React commenting widget supports all of the same features of the VanillaJS one - коментарисање уживо, 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

If you're in the EU, you'll want to set the region parameter like so:

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

You can find the configuration the React component supports here.

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

The fastcomments-vue and fastcomments-vue-next libraries support the same configuration as the VanillaJS commenting widget.

Конфигурацију коју 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

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

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

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

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

Дозвољавање анонимног коментарисања (без захтева за имејл)

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

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

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

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

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

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

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

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