FastComments.com


Kurulum

FastComments, statik veya dinamik, açık temalı veya koyu temalı, herkese açık veya dahili sayfalara kurulmak üzere tasarlanmıştır. Kurulumu kolay olmalı ve herhangi bir siteye veya web tabanlı uygulamaya kolayca uyarlanabilmelidir.


Wordpress Internal Link

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.

VanillaJS / HTML Parçacığı Internal Link

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

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 Internal Link

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 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 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 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 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 Copy
1
2<lib-fastcomments [config]="fastcommentsConfig"></lib-fastcomments>
3
Kullanım - AB
Copy 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 Internal Link

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 Copy
1
2npm install --save fastcomments-react
3
FastComments React (Yarn ile)
Copy Copy
1
2yarn add fastcomments-react
3
React Örneği
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

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

React Örneği - AB
Copy Copy
1
2 <FastCommentsCommentWidget tenantId="demo" region="eu" />
3

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

Vue Internal Link

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 Copy
1
2npm install --save fastcomments-vue-next
3
FastComments Vue (Yarn ile)
Copy Copy
1
2yarn add fastcomments-vue-next
3
Vue Örneği
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

AB'deyseniz, regionEU olarak ayarlamanız gerekir:

FastComments Vue - AB
Copy 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.

TypeScript Internal Link

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.

Aynı Sayfada Birden Fazla Örnek Internal Link

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.

Yaygın Kullanım Senaryoları Internal Link

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.