Можете да намерите нашия WordPress плъгин тук.

Пълно ръководство за инсталация и документация за плъгина са тук.

Този плъгин поддържа коментиране в реално време, SSO и инсталация без код. Просто следвайте ръководството за инсталация в административната страница след инсталиране на плъгина. То ще ви преведе през свързването на вашата WordPress инсталация с вашия акаунт.

Всички коментари, оставени чрез FastComments през нашия WordPress плъгин, могат автоматично да се синхронизират обратно към вашата WordPress инсталация, за да запазите контрол върху данните си. Това може да бъде изключено, за да се ограничи размерът на вашата WordPress база данни.

VanillaJS версията на уиджета е много лесна за инсталиране, не изисква системи за изграждане или сървърен код.

Просто добавете следния код към всяка страница:

Прост код

Copy Run

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 код за вграждане". Изберете я и поставете горния код.

Дори не се нуждаете от акаунт, за да опитате! Може да видите "tenantId: demo" в горния код, ако не сте влезли. В този случай ще се използва демо акаунт.

Можете да намерите документация за конфигуриране на уиджета тук.

Всички версии на FastComments уиджета са обвивки около основната VanillaJS библиотека. Това ни позволява да добавяме функции и да поправяме проблеми на едно място — промените автоматично се разпространяват към другите варианти на уиджета за коментари.

Можете да намерите нашата Angular библиотека в NPM тук.

FastComments Angular уиджетът за коментари поддържа всички същите функции като VanillaJS версията — коментиране в реално време, SSO и т.н.

Ще ви трябва fastcomments-typescript, която е peer зависимост. Моля, уверете се, че е включена в компилацията на TypeScript. В бъдеще тази peer зависимост ще бъде преместена в @types/fastcomments, което ще опрости инсталацията.

FastComments Angular чрез NPM

Copy

1

2 npm install fastcomments-typescript --save

3 npm install ngx-fastcomments --save

4

Peer зависимостта трябва да бъде добавена във вашия tsconfig.json файл, например:

Добавяне на fastcomments-typescript peer зависимост

Copy

1

2"include": [

3 "src/**/*.ts",

4 "node_modules/fastcomments-typescript/src/index.ts"

5],

6

След това добавете FastCommentsModule към вашето приложение:

Добавяне на модула към вашето приложение

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

Използване

За начало подаваме конфигурационен обект за демо тенанта:

Използване - Вградена конфигурация

Copy

1

2<lib-fastcomments [config]="{ tenantId: 'demo' }"></lib-fastcomments>

3

Тъй като конфигурацията може да стане доста сложна, можем да подадем референция към обект:

Използване - Подаване на обект за конфигурация

Copy

1

2<lib-fastcomments [config]="fastcommentsConfig"></lib-fastcomments>

3

Използване - ЕС

Copy

1

2<lib-fastcomments [config]="{ tenantId: 'demo', region: 'eu' }"></lib-fastcomments>

3

Уиджетът използва откриване на промени, така че промяната на всякакви свойства на конфигурационния обект ще доведе до презареждане.

Можете да намерите конфигурацията, която Angular компонентът поддържа тук.

Можете да намерите нашата React библиотека в NPM тук.

FastComments React уиджетът за коментари поддържа всички същите функции като VanillaJS версията — коментиране в реално време, SSO и т.н.

FastComments React чрез NPM

Copy

1

2npm install --save fastcomments-react

3

FastComments React чрез Yarn

Copy

1

2yarn add fastcomments-react

3

React пример

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

1

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

3

Можете да намерите конфигурацията, която React компонентът поддържа тук.

Можете да намерите нашата Vue библиотека в NPM тук.

Също така, vue-next библиотеката е в NPM тук

Изходният код може да бъде намерен в GitHub.

FastComments Vue уиджетът за коментари поддържа всички същите функции като VanillaJS версията — коментиране в реално време, SSO и т.н.

Инструкциите по-долу са за Vue 3, тъй като е на пазара от известно време, но FastComments също поддържа Vue 2 чрез библиотеката fastcomments-vue.

FastComments Vue чрез NPM

Copy

1

2npm install --save fastcomments-vue-next

3

FastComments Vue чрез Yarn

Copy

1

2yarn add fastcomments-vue-next

3

Vue пример

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

1

2<fast-comments v-bind:config="{tenantId: 'demo', region: 'eu'}"/>

3

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

Можете да намерите конфигурацията, която Vue компонентът поддържа тук.

TypeScript дефинициите за FastComments, които включват типове за цялата конфигурация, подавана на уиджета за коментари, могат да бъдат намерени в NPM тук.

Можете да ги намерите в GitHub тук.

Всяка инстанция на уиджета за коментари е изолирана. Поради това FastComments по природа поддържа повече от една инстанция на страница или множество инстанции, сочещи към една и съща чат нишка.

В случая на VanillaJS библиотеката например, просто трябва да свържете уиджета за коментари с различни DOM възли. Ако искате просто да актуализирате текущата нишка на страницата, вижте Превключване на нишки за коментари без презареждане на страницата;

Синхронизиране на състоянието на удостоверяване между множество инстанции

Нека разгледаме примера на персонализирано едностранично приложение, което е списък с често задавани въпроси със собствена нишка за коментари.

В този случай имаме множество инстанции на FastComments в DOM едновременно.

Това е добре, но създава някои предизвикателства за потребителското изживяване.

Разгледайте този поток:

1. Потребителят посещава страницата със списък от въпроси, всеки със собствен уиджет за коментари.
2. Потребителят въвежда потребителското си име и имейл и оставя въпрос в една от нишките.
3. Вижда друг елемент от ЧЗВ, за който има въпрос.
4. Отива да коментира отново. Трябва ли да въведе имейла и потребителското си име отново?

В този случай FastComments се грижи за синхронизирането на състоянието на удостоверяване между инстанциите на уиджета вместо вас. В четвъртата стъпка потребителят вече ще бъде временно удостоверен, тъй като е въвел потребителското си име и имейл на същата страница.

Показване на коментари в реално време веднага

Уиджетът за коментари е в реално време по подразбиране, но коментарите в реално време се появяват под бутон "Покажи N нови коментари", за да се предотврати преместването на съдържанието на страницата.

В някои случаи все пак е желателно да се показват новите коментари веднага, без да се налага да се кликва бутон.

В този случай ще искате да активирате флага showLiveRightAway, документацията за който можете да намерите тук.

Разрешаване на анонимно коментиране (без изискване на имейл)

По подразбиране FastComments изисква потребителят да остави имейл при коментиране.

Това може да бъде деактивирано, инструкциите са тук.

Персонализиран стил

Много от нашите клиенти прилагат собствен стил към уиджета за коментари. Можете да намерите документацията тук.

Показване на едни и същи коментари на множество домейни

Показването на едни и същи коментари на множество сайтове е нещо, което FastComments поддържа веднага. Вижте нашата документация по тази тема.

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

FastComments поддържа SPA и сложни приложения. Промяната на текущата страница е лесна и е разгледана тук.