Add Comments To a Website

WordPress eklentimizi burada bulabilirsiniz.

Tam kurulum kılavuzu ve eklenti dokümantasyonu burada yer almaktadır.

Bu eklenti canlı yorumlama, SSO ve kodsuz kurulumu destekler. Eklentiyi kurduktan sonra yönetici sayfasındaki kurulum kılavuzunu takip etmeniz yeterlidir. WordPress kurulumunuzu hesabınıza bağlama konusunda size rehberlik edecektir.

WordPress eklentimiz aracılığıyla FastComments ile bırakılan yorumlar, verileriniz üzerinde kontrolü koruyabilmeniz için otomatik olarak WordPress kurulumunuza geri senkronize edilebilir. WordPress veritabanınızın boyutunu sınırlamak için bu kapatılabilir.

Widget'ın VanillaJS versiyonu kurulumu çok kolaydır, herhangi bir derleme sistemi veya sunucu tarafı kod gerektirmez.

Herhangi bir sayfaya aşağıdaki kod parçasını ekleyin:

Basit Kod Parçası

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

Aynı kod parçasını birçok sayfada kullanabilirsiniz; her sayfa için otomatik olarak ayrı bir tartışma dizisi oluşturacaktır.

Birçok uygulamada "HTML Gömme Kodu" seçeneği vardır. Bunu seçin ve yukarıdaki kod parçasını yapıştırın.

Denemek için hesaba bile ihtiyacınız yok! Giriş yapmadıysanız yukarıdaki kod parçasında "tenantId: demo" görebilirsiniz. Bu durumda demo hesabı kullanılacaktır.

Widget'ı yapılandırma hakkında dokümantasyonu burada bulabilirsiniz.

FastComments widget'ının tüm versiyonları çekirdek VanillaJS kütüphanesinin sarmalayıcılarıdır. Bu, özellikleri eklememize ve sorunları tek bir yerde düzeltmemize olanak tanır — değişiklikler otomatik olarak yorum widget'ının diğer varyantlarına yayılır.

Angular kütüphanemizi NPM'de burada bulabilirsiniz.

FastComments Angular yorum widget'ı, VanillaJS olanla aynı tüm özellikleri destekler - canlı yorumlama, SSO vb.

Bir eş bağımlılık olan fastcomments-typescript'e ihtiyacınız olacak. Lütfen bunun TypeScript derlemenize dahil edildiğinden emin olun. Gelecekte, bu eş bağımlılık @types/fastcomments'a taşınacak ve kurulum basitleştirilecektir.

FastComments Angular (NPM ile)

Copy

1

2 npm install fastcomments-typescript --save

3 npm install ngx-fastcomments --save

4

Eş bağımlılık tsconfig.json dosyanıza eklenmelidir, örneğin:

fastcomments-typescript eş bağımlılığı ekleme

Copy

1

2"include": [

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

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

5],

6

Ardından, uygulamanıza FastCommentsModule ekleyin:

Modülü Uygulamanıza Ekleyin

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

Kullanım

Başlamak için demo kiracı için bir yapılandırma nesnesi geçiriyoruz:

Kullanım - Satır İçi Yapılandırma

Copy

1

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

3

Yapılandırma oldukça karmaşık olabileceğinden, bir nesne referansı geçirebiliriz:

Kullanım - Yapılandırma için Nesne Geçirme

Copy

1

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

3

Kullanım - AB

Copy

1

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

3

Widget değişiklik algılamayı kullanır, bu nedenle yapılandırma nesnesinin herhangi bir özelliğini değiştirmek yeniden yüklenmesine neden olur.

Angular bileşeninin desteklediği yapılandırmayı burada bulabilirsiniz.

React kütüphanemizi NPM'de burada bulabilirsiniz.

FastComments React yorum widget'ı, VanillaJS olanla aynı tüm özellikleri destekler - canlı yorumlama, SSO vb.

FastComments React (NPM ile)

Copy

1

2npm install --save fastcomments-react

3

FastComments React (Yarn ile)

Copy

1

2yarn add fastcomments-react

3

React Örneği

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

AB'deyseniz, region parametresini şu şekilde ayarlamanız gerekir:

React Örneği - AB

Copy

1

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

3

React bileşeninin desteklediği yapılandırmayı burada bulabilirsiniz.

Vue kütüphanemizi NPM'de burada bulabilirsiniz.

Ayrıca, vue-next kütüphanesi NPM'de burada mevcuttur

Kaynak kodu GitHub'da bulunabilir.

FastComments Vue yorum widget'ı, VanillaJS olanla aynı tüm özellikleri destekler - canlı yorumlama, SSO vb.

Aşağıdaki talimatlar Vue 3 içindir (bir süredir piyasada olduğundan), ancak FastComments fastcomments-vue kütüphanesi aracılığıyla Vue 2'yi de destekler.

FastComments Vue (NPM ile)

Copy

1

2npm install --save fastcomments-vue-next

3

FastComments Vue (Yarn ile)

Copy

1

2yarn add fastcomments-vue-next

3

Vue Örneği

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

AB'deyseniz, region'ı EU olarak ayarlamanız gerekir:

FastComments Vue - AB

Copy

1

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

3

fastcomments-vue ve fastcomments-vue-next kütüphaneleri, VanillaJS yorum widget'ı ile aynı yapılandırmayı destekler.

Vue bileşeninin desteklediği yapılandırmayı burada bulabilirsiniz.

Yorum widget'ına geçirilen tüm yapılandırma için türleri içeren FastComments TypeScript tanımları NPM'de burada bulunabilir.

GitHub'da burada bulabilirsiniz.

Yorum widget'ının her örneği izole edilmiştir. Bu nedenle, FastComments doğası gereği sayfa başına birden fazla örneği veya aynı sohbet dizisini işaret eden birden fazla örneği destekler.

Örneğin VanillaJS kütüphanesi durumunda, yorum widget'ını farklı DOM düğümlerine bağlamanız yeterlidir. Sayfadaki geçerli diziyi güncellemek istiyorsanız, Sayfayı Yeniden Yüklemeden Yorum Dizilerini Değiştirme bölümüne bakın;

Birden Fazla Örnek Arasında Kimlik Doğrulama Durumunu Senkronize Etme

Kendi yorum dizisine sahip sık sorulan sorular listesi olan özel bir tek sayfa uygulaması örneğini inceleyelim.

Bu durumda, DOM'da aynı anda birden fazla FastComments örneğimiz var.

Bu sorun değil, ancak kullanıcı deneyimi için bazı zorluklar ortaya çıkarır.

Bu akışı düşünün:

1. Kullanıcı, her biri kendi yorum widget'ına sahip sorular listesi olan bir sayfayı ziyaret eder.
2. Kullanıcı kullanıcı adını ve e-postasını girer ve dizilerden birine bir soru bırakır.
3. Sorusu olan başka bir SSS öğesi görürler.
4. Tekrar yorum yapmaya giderler. E-postalarını ve kullanıcı adlarını tekrar girmek zorundalar mı?

Bu durumda, FastComments widget örnekleri arasında kimlik doğrulama durumunu sizin için senkronize eder. Dördüncü adımda, aynı sayfada kullanıcı adını ve e-postasını girdikleri için kullanıcı zaten geçici olarak kimlik doğrulaması yapmış olacaktır.

Canlı Yorumları Hemen Gösterme

Yorum widget'ı varsayılan olarak canlıdır, ancak canlı yorumlar sayfa içeriğinin hareket etmesini önlemek için "N Yeni Yorum Göster" düğmesinin altında görünür.

Bazı durumlarda, bir düğmeye tıklamak zorunda kalmadan yeni yorumları hemen göstermek yine de istenir.

Bu durumda, showLiveRightAway bayrağını etkinleştirmek isteyeceksiniz, bunun dokümantasyonunu burada bulabilirsiniz.

Anonim Yorumlara İzin Verme (E-posta Gerektirmeme)

Varsayılan olarak, FastComments kullanıcının yorum yaparken e-posta bırakmasını gerektirir.

Bu devre dışı bırakılabilir, talimatlar burada.

Özel Stil

Müşterilerimizin çoğu yorum widget'ına kendi stillerini uygular. Dokümantasyonu burada bulabilirsiniz.

Birden Fazla Alan Adında Aynı Yorumları Gösterme

Birden fazla sitede aynı yorumları göstermek, FastComments'ın kutudan çıkar çıkmaz desteklediği bir şeydir. Bu konu hakkında dokümantasyonumuza bakın.

Geçerli Sayfayı Değiştirme

FastComments SPA'ları ve karmaşık uygulamaları destekler. Geçerli sayfayı değiştirmek kolaydır ve burada ele alınmaktadır.