Özelleştirmeler ve Yapılandırma

Örneğin, yorum widget'ının Tenant ID'si "demo" olarak kullanılabileceğini fark edebilirsiniz:

Demo Tenant ID

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

Bu yalnızca yorum widget'ını denemek ve oynamak içindir. Üretim ortamında Tenant ID'nizi şu şekilde geçirirsiniz:

Defining Your Tenant ID

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": "aKa2Z4Q="

7}];

8</script>

9

Tenant ID'niz hesabınızdaki yorum widget'ına zaten uygulanmış kod örneğinde bulunur.

Tenant ID'nizi ayrıca API kimlik bilgileri sayfasında bulabilir ve API anahtarlarınızı yönetebilirsiniz.

Bundan sonra, FastComments'a giriş yaptıysanız, kod örnekleri gerçek Tenant ID'nizi kullanacaktır (https://fastcomments.com adresinde oturum açmışsanız).

Bir yorum dizisini görüntülerken veya yorum bırakırken, FastComments'in bu yorumların hangi sayfaya, makaleye veya ürüne ait olduğunu bilmesi gerekir.

Bunu yapmak için, "URL ID" adını verdiğimiz bir şey kullanırız. Bu, bir dize veya sayı gibi bir tanımlayıcı ya da bir URL olabilir.

Varsayılan olarak, urlId belirtmezseniz, sayfa URL'si haline gelir. Mevcut sayfa URL'sini alır ve yaygın pazarlama parametrelerini veya takip tanımlayıcılarını temizleriz.

WordPress gibi üçüncü taraf entegrasyonları söz konusu olduğunda, eklentimiz genellikle görüntülenmekte olan mevcut bilgiyi temsil eden tanımlayıcıyı URL ID olarak kullanır, örneğin makale/sayfa kimliği.

Özel Bir URL ID Tanımlama

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 "urlId": "https://example.com/page"

8}];

9</script>

10

Bu dokümanda sıkça referans vereceğimiz şeylerden biri Widget Özelleştirme Arayüzü'dür.

Bu arayüz, kod kullanmadan yorum widget'ında birçok değişiklik yapmak için kullanılabilir.

Bir özelleştirme kuralı oluştururken, genellikle bunun sitemizdeki tüm sayfalara uygulanmasını isteriz. Ancak bazı durumlarda, yorum widget'ını belirli bir sayfada özelleştirmek isteriz; ya özel stil uygulamak ya da belki o belirli sayfa için yorumları anonim yapmak için. Örneğin, bazı sayfalarda canlı yorumların hemen görünmesini, diğerlerinde ise bildirim düğmelerinin altında gizlenmesini de sağlayabilirsiniz.

Tüm bunlar, bu sayfadaki URL ID giriş alanı aracılığıyla mümkündür ve şu şekilde görünür:

Widget Özelleştirme Sayfasında URL ID Girişi

Bu alandaki değer, yorum widget'ına geçirilen urlId parametresiyle eşleşmelidir. Özelleştirme kuralınızın urlId'den bağımsız olmasını istiyorsanız, bu alanı boş bırakın veya * girin.

2023 itibarıyla, widget özelleştirmedeki URL ID alanı artık desenleri de kabul ediyor! Örneğin, blogunuza özgü stil eklemek için */blog/* ve mağazanıza özgü stil için */store/* kullanabilirsiniz, tüm bunları aynı alan adıyla yaparken.

Dikkat Edilmesi Gerekenler

1. Sayfanızda hash parametreleri varsa (örneğin example.com#page-1) - bu, varsayılan olarak URL ID'nin bir parçası haline gelir.
2. Geçişler sırasında, örneğin WordPress'ten Gatsby'ye, ilk geçişten sonra URL ID yorum değerlerini taşımanız gerekebilir. Bunun için bize ulaşın.

FastComments özelleştirilebilecek şekilde tasarlanmıştır. Yorum widget'ı güvenlik nedenleriyle bir iframe içinde çalışır, bu yüzden özel stil uygulamak için iki yaklaşımdan birini izlemelisiniz.

İlk ve en kolay yaklaşım, bizim tercih ettiğimiz, widget özelleştirme sayfasını kullanmaktır.

Widget özelleştirme sayfasında, "Show Advanced Options" (Gelişmiş Seçenekleri Göster) bölümüne bakın; altında "Custom CSS" (Özel CSS) olarak etiketlenmiş bir alan bulunur:

Özel CSS Giriş Alanı

Bu yaklaşımın bazı avantajları vardır:

1. Girilen CSS, kullanıcıya gönderilmeden önce küçültülür ve biçimlendirme düzenleme UI'sinde tutarlı kalır.
2. Widget özelleştirme UI'sinin tüm avantajlarını elde edersiniz; örneğin yorum widget'ını farklı siteler için kolayca özelleştirebilirsiniz.
3. Yorum widget'ında değişiklik yaptığımızda, özel stiliniz sürüm sürecimizin bir parçası olarak test edilir.

İkinci yaklaşım, widget yapılandırmasında customCSS parametresini aşağıdaki gibi belirtmektir:

Özel CSS Geçirme

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 "customCSS": "button { background: red; }"

8}];

9</script>

10

Ancak, bunun sınırlamaları vardır:

1. Başlıkların boyutu nedeniyle, sunucularımız isteği reddedene kadar geçirilebilecek özel CSS miktarı için bir sınırlama vardır.
2. Özel CSS'i altyapınızda ve derleme sisteminizde yönetmelisiniz. Bu, bir dezavantajdan ziyade bir avantaj da olabilir.
3. Bu kullanım durumunda özel CSS'in ağ üzerinden iki kez gönderilmesi ek bir yük oluşturur; önce sunucularımıza, ardından iframe içeriğine gönderilir. Ancak çoğu yük boyutu için bu fark edilmez.
4. Yaygın bir optimizasyon, CSS'i küçülterek ağ üzerindeki boyutunu azaltmaktır; ancak bu yaklaşımda bunu kendiniz yönetmelisiniz.
5. Özel CSS'iniz, değişiklik yaptığımızda test edilmez.

Harici CSS Dosyaları

@import kullanarak widget'ın harici bir dosya almasını sağlayabilirsiniz!

@import'u bir özelleştirme kuralına koymanız önerilir. Böylece, yorum widget'ında bir değişiklik yapmamız gerektiğinde otomasyon araçlarımızı kullanarak ayarlarınızı doğrulayabiliriz. Örneğin, Widget Özelleştirme UI'sinde bir özelleştirme kuralı oluşturur, Advanced (Gelişmiş) sekmesine tıklarsınız ve Custom CSS (Özel CSS) alanına girersiniz:

@import url(https://example.com/styles.css);

Kod İçinde - Önerilmez

customCSS özelliği aracılığıyla da harici bir CSS dosyası yükleyebilirsiniz:

Harici CSS Dosyası

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 "customCSS": "@import url(https://example.com/styles.css);"

8}];

9</script>

10

Ancak, bunu yaparsanız CSS'inizin bizim tarafımızdan test edilemeyeceğini unutmayın.

Kullanıcı Profili Modal Stili

Kullanıcı profili modalları da özel CSS ile stil verilebilir. Ancak, özel stilin kullanıcı profillerine uygulanmasını sağlamak için tüm CSS seçicileri .user-profile ile ön eklenmelidir. Bu ön ek olmadan, kullanıcı profili modalları için özel stil yoksayılır.

For example:

Kullanıcı Profili CSS

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 "customCSS": ".user-profile .profile-name { color: blue; }"

8}];

9</script>

10

Geriye Dönük Uyumluluk

FastComments'ta, müşterilerimizin yorum widget'ını özelleştirdiğini biliyoruz. Bu tasarım gereği; ürünümüzün sizin ürününüzde tasarım tutarsızlıklarına yol açmasını istemeyiz.

Bu, ürünümüzün önemli bir parçası olduğundan, her sürümde müşteri bazında yorum widget'ındaki değişiklikleri incelememizi sağlayan bir derleme hattına sahibiz.

Küçük sorunlar bulursak, sürümün sorunsuz ilerlemesini sağlamak için hesabınızı güncelleriz. Büyük kırıcı değişiklikler görürsek, sürümü durdurmamıza olanak tanır.

Pro veya Enterprise hesabına sahip müşteriler için white labeling'e izin verilmektedir. Sadece bize ulaşın ve size memnuniyetle yardımcı oluruz.

Yalnızca yorum widget'ından logomuzu kaldırmak istiyorsanız, bu özellik Flex ve Pro planlarında otomatik olarak etkinleştirilir.

Bu planlar ayrıca platformumuzdan gönderilen e-postalar için de aynı işlevselliği sağlar.

İlk sayfa yüklemesinden sonra koyu modun açılıp kapatılmasına izin veren sitelerde, bu biraz daha fazla işlem gerektirir.

Öncelikle, Yorum widget kütüphanesinin (React, Vue) mevcut tüm sürümleri, koyu modun açılıp kapatılmasına örnekler içerir.

VanillaJS widget için biraz daha fazla çalışmamız gerekecek. Öncelikle, FastCommentsUI "destroy" ve "update" işlevlerine sahip bir nesne döndürür.

Yorum widget yapılandırmasını güncellemek istediğimiz her seferinde update işlevini basitçe çağırabiliriz, şöyle. İşte VanillaJS widget ile koyu modu açıp kapatmanın tam çalışır bir örneği.

Koyu Modu Açıp Kapatma Tam Örneği

Copy Run

1

2<script src="https://fastcomments.com/js/embed-v2.min.js"></script>

3<button id="toggle-dark-mode">Toggle Dark Mode</button>

4<div id="fastcomments-widget"></div>

5<script>

6 (function() {

7 const button = document.getElementById('toggle-dark-mode');

8 const config = {

9 tenantId: 'demo',

10 hasDarkBackground: false

11 };

12 const instance = window.FastCommentsUI(document.getElementById('fastcomments-widget'), config);

13 button.addEventListener('click', function() {

14 config.hasDarkBackground = !config.hasDarkBackground;

15 if (config.hasDarkBackground) {

16 document.body.classList.add('dark');

17 } else {

18 document.body.classList.remove('dark');

19 }

20 instance.update(config);

21 });

22 })();

23</script>

24<style>

25 body.dark {

26 background: #000;

27 color: #fff;

28 }

29</style>

30

FastComments ile yorum widget'ındaki tüm metin özelleştirilebilir.

Gönder düğmesi gibi tek bir metni ya da tüm yorum widget'ındaki tüm metni geçersiz kılabilirsiniz.

Varsayılan olarak, yorum widget'ındaki metin kullanıcının yerel ayarına göre çevrilir. Ancak, kullanıcı tabanımızın aynı yerel/ dili kullandığından eminsek metni geçersiz kılabiliriz, örneğin:

Özel Metin

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 "translations": {

8 "SUBMIT_REPLY": "Reply"

9 }

10}];

11</script>

12

Tüm özelleştirilebilir çeviriler burada "gelişmiş seçenekler" sekmesinin altında bulunabilir.

Ancak, widget özelleştirme arayüzü üzerinden daha kolay bir yol vardır. Orada, yorum widget'ında EN_US yerel ayarında gösterilen metni bulup bir değiştirme belirtebiliriz.

Özel Metin

Tüm çeviri geçersiz kılmaları şu anda tüm yerel ayarları etkiler.

Bu, widget'ın kendi metnini kapsar. Ziyaretçilerinizin yazdığı yorumları çevirmek için, Yorum Çevirisi bölümüne bakın.

Bir kullanıcı FastComments ile ilk kez yorum yaptığında avatarını https://gravatar.com/ adresinden almaya çalışacağız.

Ancak, bir avatar bulamazsak ya da kullanıcı hesabında hiç avatar ayarlamazsa, statik bir varsayılan avatar resmi gösteririz.

Kendi statik avatar resminizi belirtmek için defaultAvatarSrc ayarını kullanabilirsiniz.

Varsayılan Avatarı Geçersiz Kıl

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 "defaultAvatarSrc": "https://example.com/some-image.png"

8}];

9</script>

10

Bu aynı zamanda kod olmadan da yapılabilir. Widget özelleştirme sayfasında, "Varsayılan Avatar" bölümüne bakın.

Varsayılan Avatarı Özelleştirme

SSO gibi belirli bir kullanıcı için avatar tanımlamanın ayrı bir bölümde ele alındığını unutmayın.

Avatarlar, kullanıcılar kendi avatarlarını tanımlamış olsa bile, yorum widget'ından tamamen kaldırılabilir.

Avatarları Gizleme

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 "hideAvatars": true

8}];

9</script>

10

Bu, kod yazmadan, widget özelleştirme sayfasında özelleştirilebilir:

Avatarları Gizleme

Daha büyük özelleştirilmiş stil projeleri için, sıfırdan başlamak ve varsayılan stili hiç kullanmamak isteyebilirsiniz.

Tüm varsayılan stil, noStyles parametresini true olarak ayarlayarak aşağıdaki gibi kaldırılabilir:

Tüm Varsayılan Stilleri Devre Dışı Bırakma

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 "noStyles": true

8}];

9</script>

10

Bu, kod yazmadan, widget özelleştirme sayfasında Gelişmiş Seçenekler altında özelleştirilebilir:

Tüm Varsayılan Stilleri Devre Dışı Bırakma

Varsayılan olarak, üst düzey yorumların yanıtları gösterilir.

Bu, kullanıcının üst düzey yorumlarda yanıtları görmek için "Show Replies" tıklaması gerekir.

Üst Düzey Yorumlarda Yanıtları Daralt

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 "collapseReplies": true

8}];

9</script>

10

Bu, kod yazmadan, widget özelleştirme sayfasında özelleştirilebilir:

Yanıtları Daralt

Bu ayar, başlangıçta yüklenen üst düzey yorum sayısını etkilemez. Eğer bir üst düzey yorumunuz ve 29 alt yorumu varsa, bu ayar açıkken şunları görürsünüz:

• Üst düzey yorumu gör.
• Bu yorumun altında Show Replies (29) gör.

Bu seçenekle birlikte tüm üst düzey yorumları göstermek isterseniz, starting page to -1 ayarını yapın.

Varsayılan olarak, FastComments'taki biçimlendirme işlevleri, metninizin etrafına <b></b> gibi görünür bağlantı etiketleri ekleyerek yapılır. Araç çubuğuna tıklamak
veya kısayolları kullanmak bunu sizin için yapar. Ancak, bazı topluluklar bağlantı etiketleri olmadan biçimlendirme kullanmak isteyebilir. Bu,
WYSIWYG (gördüğünüz şey elde ettiğiniz şey) editörünün etkinleştirilmesi olarak adlandırılır. Bu editör, varsayılan olanla tamamen aynı görünür, ancak ekstra kod yükler
kullanıcıların metni kalın, altı çizili vb. yapmasını, görünür bağlantı etiketleri olmadan sağlar.

WYSIWYG Düzenlemeyi Etkinleştirme

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 "enableWYSIWYG": true

8}];

9</script>

10

Bu, kod olmadan da yapılabilir. Widget özelleştirme sayfasında, "Enable Advanced Formatting" seçeneğine bakın.

WYSIWYG'i Etkinleştir

Varsayılan olarak, FastComments bir yorum yazarken metni süslemek ve resim yüklemek için kısayollar sağlayan bir araç çubuğu gösterir.

Bu araç çubuğu kod içinde veya Özelleştirme UI'sı ile devre dışı bırakılabilir.

Araç Çubuğunu Devre Dışı Bırakma

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 "disableToolbar": true

8}];

9</script>

10

Bu aynı zamanda kod olmadan da yapılabilir. Widget özelleştirme sayfasında, "Disable The Reply Toolbar" seçeneğine bakın.

Araç Çubuğunu Devre Dışı Bırakma

Varsayılan olarak, FastComments kullanıcıların diğer kullanıcıları engellemesine izin verir. Bir kullanıcıyı engellemek, yorumlarının gizlenmesine, kullanıcılar arasındaki bildirimlerin engellenmesine ve benzeri durumlara yol açar.

Bu işlevi devre dışı bırakmak istenebilir. Aşağıdaki gibi yapılabilir:

Engellemeyi Devre Dışı Bırak

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 "disableBlocking": true

8}];

9</script>

10

Bu aynı zamanda kod kullanmadan, sunucu tarafı doğrulamasını da etkinleştiren, Widget Özelleştirme UI'si aracılığıyla yapılabilir:

Engellemeyi Devre Dışı Bırak

Varsayılan olarak, yerelleştirilmiş göreli tarihler kullanılır. Örneğin, yeni bırakılmış bir yorumun yanında "11 dakika önce" görebilirsiniz.

Mutlak tarihleri kullanmak gerekli veya istenebilir; bu durumda bu parametreyi true olarak ayarlarsınız.

Mutlak Tarihleri Kullan

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 "absoluteDates": true

8}];

9</script>

10

Bu, kod olmadan, widget özelleştirme sayfasında Gelişmiş Seçenekler altında özelleştirilebilir:

Mutlak Tarihleri Kullan

Varsayılan olarak, yerelleştirilmiş göreceli tarihler kullanılır. Örneğin, yeni bırakılmış bir yorumun yanında "11 dakika önce" görebilirsiniz.

Bu göreceli tarih formatını korumak gerekli veya istenebilir, ancak aynı zamanda tam tarihi de yanına göstermek isteyebilirsiniz; bu durumda bu parametreyi true olarak ayarlarsınız.

Use Both Absolute and Relative Dates

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 "absoluteAndRelativeDates": true

8}];

9</script>

10

Bu, kod yazmadan, widget özelleştirme sayfasında Gelişmiş Seçenekler altında özelleştirilebilir. Bu seçeneği UI'da görebilmek için önce Mutlak Tarihleri etkinleştirmeniz gerekir.

Use Both Absolute and Relative Dates

Bazı metinler, bir başlık veya mesaj gibi, yorum sayısının altında ancak oturum durumu metninin üstünde görüntülenebilir.

Buna başlık diyoruz ve varsayılan olarak gizlidir.

Başlık HTML'si Belirtiliyor

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 "headerHTML": "<h1>Leave a Comment!</h1>"

8}];

9</script>

10

Bu, kod yazmadan, widget özelleştirme sayfasında, Gelişmiş Seçenekler altında özelleştirilebilir:

Başlık HTML'si Belirtiliyor

Varsayılan olarak, FastComments bağlantıları şu şekilde render eder: https://exmaple.com - burada bağlantı URL'si tıklanabilir bir HTML bağlantı etiketi haline gelir.

Bazı siteler bunu devre dışı bırakmak isteyebilir, örneğin dolandırıcıları caydırmak için. Bunu Comment HTML Rendering Option seçeneğini Links as Text olarak ayarlayarak sağlıyoruz.

Bu, kod yazmadan, widget özelleştirme sayfasında, tüm bir alan adı veya sayfa için özelleştirilebilir:

Bağlantıları Metin Olarak Render Et

Varsayılan olarak, FastComments yorum giriş kutusunu ve yorum dizisini aynı anda render eder. Dikey alan tasarrufu sağlamak için, widget ile etkileşime girilene kadar diğer gerekli alanları da gizler.

Ancak, yorum widget'ı bir düğmenin arkasında gizlenebilir, örneğin:

Yorumları Göstermek İçin Tıklayın

Düğme, yorumların şu anda gösterilip gösterilmediğine bağlı olarak farklı çevrilmiş metinler kullanır. Yorumlar gizli ise translations.SHOW_COMMENTS_BUTTON_TEXT kullanılır. Yorumlar gösteriliyorsa translations.HIDE_COMMENTS_BUTTON_TEXT kullanılır. Çeviriler, yerelleştirilmiş sayıyla değiştirilecek [count] metnini içerebilir.

Yorumları Göster veya Gizle

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 "useShowCommentsToggle": true

8}];

9</script>

10

Bu, hideCommentsUnderCountTextFormat yapılandırmasını değiştirmek için tasarlanmıştır.

Sayı, yorum dizisiyle birlikte canlı olarak güncellenir. Yorum yoksa düğme gösterilmez.

Bu, bir özelleştirme kuralı oluşturarak ve "Yorumları Göster" seçeneğini etkinleştirerek kod olmadan etkinleştirilebilir:

Yorumları Göster'i Etkinleştir

Yorum widget'ının üst kısmında gösterilen yorum sayısı özelleştirilebilir.

Bu, herhangi bir dizeyle değiştirilebilir ve [count] değeri, kullanıcı için yerelleştirilmiş sayım değeriyle değiştirilecektir.

Yorum Sayısı Metnini Özelleştirme

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 "commentCountFormat": "There are [count] comments."

8}];

9</script>

10

Bu, kod yazmadan, widget özelleştirme sayfasında özelleştirilebilir:

Yorum Sayısı Metnini Özelleştirme

Kullanıcılar #someexampletag biçiminde hashtag girdiğinde, FastComments otomatik olarak o HashTag'i oluşturur ve yorumlarında vurgular.

Bazı durumlarda bu özelliği devre dışı bırakmak veya API aracılığıyla hangi hashtag'lerin kullanılabileceğini kontrol etmek istenebilir.

Bunu yapmak için, Widget Özelleştirme UI'si üzerinden Disable Automatic #hashtag Creation seçeneğini etkinleştirmeniz yeterlidir.

Otomatik HashTag Oluşturmayı Devre Dışı Bırakma

Varsayılan olarak, FastComments yorum alanının sağ üst köşesinde bir bildirim zili gösterir.

Bu zil kırmızıya döner ve kullanıcının sahip olduğu bildirim sayısını gösterir. Örnek bildirimler şunlardır:

• Kullanıcı size yanıt verdi.
• Kullanıcı, yorum yaptığınız bir dizide yanıt verdi.
• Kullanıcı yorumunuzu beğendi.
• Kullanıcı, abone olduğunuz bir sayfaya yanıt verdi.

Bildirim zili aynı zamanda bir bütün sayfaya abone olma mekanizması da sağlar.

Bununla birlikte, bildirim zilini tamamen devre dışı bırakabiliriz:

Bildirim Zilini Devre Dışı Bırak

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 "disableNotificationBell": true

8}];

9</script>

10

Bu aynı zamanda kod olmadan da yapılabilir. Widget özelleştirme sayfasında, "Bildirim Zilini Devre Dışı Bırak" bölümüne bakın.

Bildirim Zilini Devre Dışı Bırak

Varsayılan olarak, FastComments bir kullanıcının avatarına tıkladığınızda kullanıcının profilini gösterir.

Ancak, bu işlevi devre dışı bırakabiliriz:

Profilleri Devre Dışı Bırak

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 "disableProfiles": true

8}];

9</script>

10

Bu aynı zamanda kod olmadan da yapılabilir. Widget özelleştirme sayfasında, "Profilleri Devre Dışı Bırak" bölümüne bakın.

Profilleri Devre Dışı Bırak

Varsayılan olarak, FastComments kullanıcı profillerinde bir "Profil Yorumları" sekmesi gösterir ve ziyaretçilerin birinin profiline yorum bırakmasına izin verir.

Ancak, bu sekmeyi devre dışı bırakabiliriz:

Profil Yorumlarını Devre Dışı Bırak

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 "disableProfileComments": true

8}];

9</script>

10

Bu aynı zamanda kod olmadan da yapılabilir. Widget özelleştirme sayfasında, "Profil Yorumlarını Devre Dışı Bırak" bölümüne bakın.

Profil Yorumlarını Devre Dışı Bırak

Varsayılan olarak, FastComments kullanıcı profillerinde bir "Direct Messages" sekmesi gösterir ve ziyaretçilerin bir kullanıcıya doğrudan mesaj göndermesine izin verir.

Ancak, bu sekmeyi devre dışı bırakabiliriz:

Disable Profile Direct Messages

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 "disableProfileDirectMessages": true

8}];

9</script>

10

Bu aynı zamanda kod olmadan da yapılabilir. Widget özelleştirme sayfasında, "Disable Direct Messages" bölümüne bakın.

Disable Profile Direct Messages

Varsayılan olarak, FastComments yorum yaptıktan sonra bir başarı mesajı gösterir. Bu aşağıdaki şekilde devre dışı bırakılabilir:

Başarı Mesajını Devre Dışı Bırak

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 "disableSuccessMessage": true

8}];

9</script>

10

Bu aynı zamanda kod olmadan da yapılabilir. Widget özelleştirme sayfasında:

Başarı Mesajını Devre Dışı Bırak

Varsayılan olarak, FastComments yorum widget'ı pg bir gif rating ayarlar.

Mevcut seçenekler g, pg, pg-13 ve r'dir.

Bu, kod içinde veya UI üzerinden ayarlanabilir. Koddaki örnek aşağıdaki gibidir:

Gif Değerlendirmesini Ayarla

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 "gifRating": "pg-13"

8}];

9</script>

10

UI'da, Disable Image Uploads? işaretli olmadığı sürece, bunu Gif Picker Rating altında bulabilirsiniz.

Gif Değerlendirmesini Ayarlama

Varsayılan olarak, FastComments yorum widget'ı görüntü içeriği denetimini off konumunda tutar.

Mevcut seçenekler off, low, medium ve high'dır.

Widget özelleştirme arayüzünde, Disable Image Uploads? işaretli olmadığı sürece bunu Image Content Moderation Level altında bulacaksınız.

Görüntü İçeriği Denetimi Seviyesini Ayarlama

Varsayılan olarak, FastComments oy verme seçeneklerini yukarı ve aşağı oklar olarak gösterir ve kullanıcıların bir yorumu yukarı ya da aşağı oy vermesine izin verir.

Ancak, oy araç çubuğunun stilini değiştirmek mümkündür. Mevcut seçenekler varsayılan Yukarı/Aşağı düğmeleri veya Kalp stilinde bir oy verme mekanizmasıdır.

voteStyle bayrağını şu şekilde kullanıyoruz:

Kalp Düğmesini Etkinleştir

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 "voteStyle": 1

8}];

9</script>

10

Bunu kod olmadan yapmanızı şiddetle öneririz, çünkü bu aynı zamanda sunucu tarafı doğrulamaları da etkinleştirir. Widget özelleştirme sayfasında, "Oy Stili" bölümüne bakın.

Oy Verme Stilini Değiştir

Oy verme aynı zamanda devre dışı bırakılabilir, stil seçeneklerinin üzerindeki Disable Voting bölümüne bakın.

Varsayılan olarak, FastComments kullanıcıların yorumlarını silmelerine izin verir.

Ancak, bunu önlemek mümkündür.

Widget özelleştirme sayfasında, "Silme İşlemini Devre Dışı Bırak" seçeneğine bakın.

Yorum Silmeyi Devre Dışı Bırak

• Bu sadece normal Yorumcuları etkiler ve moderatorleri ya da yöneticileri etkilemez; onlar hâlâ silebilir.
• Bu ayrıca contextUserId geçirildiğinde API entegrasyonlarını da etkiler.

Varsayılan olarak, FastComments kullanıcıların yorumlarını düzenlemelerine izin verir.

Ancak, bunu önlemek mümkündür.

Widget özelleştirme sayfasında, "Disable Editing" seçeneğine bakın.

Yorum Düzenlemeyi Devre Dışı Bırak

• Bu sadece normal Yorumcuları etkiler ve moderatörleri ya da yöneticileri etkilemez; onlar hâlâ düzenleyebilir.
• Bu ayrıca contextUserId geçirildiğinde API entegrasyonlarını da etkiler.

Varsayılan olarak, FastComments sayfa boyutu 30'dur. Bu, dizilerdeki yanıtları da içerir.

Sayfa boyutu, 10 ile 200 arasında değişen boyutlarda, Widget Configuration UI içinde özelleştirilebilir.

Sayfa boyutunu değiştirmenin, hesabınızdaki tüm yorum dizilerini yeniden hesaplamasını gerektirdiğini unutmayın. Bu birkaç dakika sürebilir.

Sayfalar sunucu tarafında hesaplandığı için bu, istemci tarafı widget'ında yapılandırılamaz.

Aşağıda örnek yapılandırma gösterilmiştir:

Özel Sayfa Boyutları

Sayfa boyutları, farklı özelleştirme kuralları oluşturarak global olarak, alan adına göre veya sayfaya göre özelleştirilebilir.

Bu, platformumuz üzerinden yorumları göstermek için kullandığınız tüm istemcileri, entegrasyonları ve çerçeveleri etkileyecektir.

Varsayılan olarak, FastComments kullanıcının adını, kullanıcının girdiği şekilde veya SSO aracılığıyla bize iletildiği şekilde gösterir.

Ancak, kullanıcının adını maskelemek veya farklı bir şekilde göstermek istenebilir. Örneğin, kullanıcının adı Allen Rex ise, belki de yalnızca "Allen R." göstermek istersiniz.

Bu, Widget Özelleştirme arayüzünde kod yazmadan, Commenter Name Format adlı ayar altından yapılabilir:

Ad Formatını Değiştir

Kullanılabilir formatlar şunlardır:

• Capitalize (örnek kullanıcıyı Example User olarak gösterir)
• Last Initial (Example User kullanıcısını Example U. olarak gösterir)
• All Initials (Example User kullanıcısını E. U. olarak gösterir)
• "Anonymous" göster

Bu değişikliğin etkisi anlıktır. Kullanıcılar, yorum alanının üstünde kendi tam kullanıcı adlarını görmeye devam eder, ancak yorumları değiştirilmiş kullanıcı adını gösterir.

Kullanıcı adları, kullanıcıları korumak için sunucu tarafında maskelenir.

Varsayılan olarak FastComments görsel yüklemelerine izin verir. Bu, noImageUploads bayrağını true olarak ayarlayarak devre dışı bırakılabilir.

Görsel Yüklemeleri Devre Dışı Bırakma

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 "noImageUploads": true

8}];

9</script>

10

Bu, kod yazmadan, widget özelleştirme sayfasında özelleştirilebilir:

Görsel Yüklemeleri Devre Dışı Bırakma

Varsayılan olarak FastComments yorumlarda iframe'lere izin vermez. Medya gömmelerini etkinleştirdiğinizde, yorumcular YouTube, Vimeo, SoundCloud ve Spotify gibi güvenilir sağlayıcılardan gömme kodunu ( <iframe> snippet'ini) yapıştırabilir ve bu yorum içinde satır içi olarak görüntülenir.

Güvenlik nedeniyle, bu bir istemci tarafı widget yapılandırma bayrağı değildir. Bu, her yorum kaydedildiğinde doğrulanan bir sunucu tarafı ayardır, bu yüzden sayfadan açılıp kapatılamaz. Yalnızca yerleşik güvenilir sağlayıcılar listesine işaret eden iframe'lere izin verilir. Diğer tüm iframe'ler kaldırılır.

Bu, kod yazmadan, widget özelleştirme sayfasında yapılır:

Medya Gömme İzin Ver

Kendi Sağlayıcılarınızı Eklemek

Yerleşik güvenilir listede bulunmayan bir sağlayıcıdan gömmelere izin vermek istiyorsanız, aynı sayfadaki "Additional Embed Domains" alanına sağlayıcının ana bilgisayar adını ekleyin. Bu ana bilgisayar adları yerleşik sağlayıcıların yanı sıra da izin verilir. Eşleşme tamdır, bu yüzden tam ana bilgisayar adını (örneğin, player.example.com) ekleyin. Listede yer almayan her şey engellenir.

Hem düz yorum kutusu hem de WYSIWYG editörü gömme yapıştırmayı destekler. WYSIWYG editöründe gömme, kaldırılabilir bir blok olarak eklenir.

Varsayılan olarak, yorum widget'ında bir arama kutusu gösterilmez.

Ancak, enableSearch bayrağını true olarak ayarlayarak bunu açabiliriz:

Aramayı Etkinleştirme

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 "enableSearch": true

8}];

9</script>

10

Bu aynı zamanda kod olmadan da yapılabilir. Widget özelleştirme sayfasında, "Arama Kutusunu Etkinleştir" seçeneğine bakın.

Arama Kutusunu Etkinleştir

enableSpoilers bayrağını true olarak ayarlayarak spoiler desteğini etkinleştirebiliriz:

Spoiler'ları Etkinleştirme

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 "enableSpoilers": true

8}];

9</script>

10

Bu, kod yazmadan da yapılabilir. Widget özelleştirme sayfasında, "Enable Spoilers" seçeneğine bakın.

Spoiler'ları Etkinleştir

Metin vurgulandığında ve artık görünen SPOILER düğmesine tıklandığında, metin kullanıcı üzerine gelene kadar maskelenir. Karanlık mod için aynı şeyi yaparız, ancak karanlık moda daha iyi uyan farklı renklerle.

Bu aynı zamanda WYSIWYG editörüyle de uyumludur.

Varsayılan olarak, FastComments her yorumun kim tarafından görüntülendiğini izlemiyor ve bununla ilgili istatistikler sağlamıyor.

Ancak bu özelliği etkinleştirebiliriz ve sistem, her kullanıcı bir yoruma kaydırdıkça izlemeye başlayacaktır.

Bu gerçekleştiğinde, her yorumda gösterilen göz simgesinin yanındaki sayı artar. Sayı, canlı olarak güncellenir ve kullanıcının yerel ayarına göre kısaltılır.

Bunu, enableViewCounts bayrağını true olarak ayarlayarak etkinleştirebiliriz:

Yorum Görüntüleme Sayılarını Etkinleştirme

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 "enableViewCounts": true

8}];

9</script>

10

Bu, kod kullanmadan, widget özelleştirme sayfasında özelleştirilebilir:

Yorum Görüntüleme Sayılarını Etkinleştirme

Yorumu görüntüleyen kullanıcı kimliğini* bir hafta boyunca izliyoruz, böylece aynı hafta içinde yorumu tekrar görüntülerseniz sayı artmaz. Hafta geçtikten sonra yorumu tekrar görüntülerseniz, sayı tekrar artar.

• *Not: anonim oturum kimliği veya kullanıcının IP'si hashlenmiş bir değer olabilir.

Varsayılan olarak, canlı yorumlama etkinleştirilir. Bu, herhangi bir yorum eklenir, silinir, düzenlenir veya sabitlenirse, değişikliklerin aynı anda yorum dizisini izleyen tüm kullanıcılar tarafından görülmesi anlamına gelir.

Ancak, varsayılan olarak bu yeni yorumlar, “Show 2 New Comments” benzeri bir metne sahip dinamik olarak gösterilen bir düğmenin altında görünür.

Yeni yorumlar doğrudan sayfaya yanıt ise, düğme yorum dizisinin en üstünde gösterilir. Belirli bir yoruma yanıt ise, düğme o yorumun altında gösterilir.

Bu, sayfa boyutunun kullanıcıda sürekli değişmesini önlemek içindir; kaydırma çubuğunu yakalamaya çalışırken hayal kırıklığına yol açabilir.

Canlı teklif verme veya çevrimiçi etkinlikler gibi bazı kullanım senaryolarında bu istenen davranış değildir – yorum widget'ının yeni yorumların “hemen gösterildiği” bir “sohbet” kutusu gibi olmasını isteyebilirsiniz.

Bu nedenle, bu özelliği etkinleştiren bayrağın adı: showLiveRightAway.

Aşağıdaki gibi açabilirsiniz:

Canlı Yorumları Hemen Göster

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 "showLiveRightAway": true

8}];

9</script>

10

Bu, widget özelleştirme sayfasında kod olmadan özelleştirilebilir:

Canlı Yorumları Hemen Göster

Varsayılan olarak, FastComments canlı yorumlamayı etkinleştirir.

Bu, yorum dizisinin her izleyicisinin aynı içeriği görmesi gerektiği anlamına gelir.

Örneğin, bir yorum eklendiğinde, o yorum gösterilmelidir. Bir yorum düzenlenir veya kaldırılırsa, bu yorumlar dizinin tüm izleyicileri için de düzenlenir veya kaldırılır. Oylar ve tüm moderasyon eylemleri de aynı şekilde.

Ancak, bunu devre dışı bırakabiliriz:

Disable Live Commenting

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 "disableLiveCommenting": true

8}];

9</script>

10

Bu, kod olmadan da yapılabilir. Widget özelleştirme sayfasında, "Disable Live Commenting" bölümüne bakın.

Canlı Yorumlamayı Devre Dışı Bırak

Varsayılan olarak, FastComments yorumları "En İlgili" sıralama yönüne göre sıralar.

"En İlgili" sıralama, yorumun bırakıldığı zamanı ve oy sayısını sıralama için dikkate alır.

Kullanıcı, yorum widget'ı arayüzünde sıralama yönünü En Eski ya da En Yeni İlk olarak değiştirebilir.

Bununla birlikte, varsayılanı üçünden herhangi birine değiştirebiliriz. Örneğin, en eski yorumları önce göstermek isterseniz:

Changing The Default Sort To Oldest First

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 "defaultSortDirection": "OF"

8}];

9</script>

10

defaultSortDirection değerini "OF" olarak ayarlayarak yönü "OF" olarak belirleriz.

En yeni önce sıralama yönü için aşağıdakini yaparız:

Changing The Default Sort To Newest First

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 "defaultSortDirection": "NF"

8}];

9</script>

10

defaultSortDirection için geçerli değerler şunlardır:

• MR: "En Yeni"
• NF: "En Yeni İlk"
• OF: "En Eski İlk"

Bu, kod olmadan da yapılabilir. Widget özelleştirme sayfasında "Varsayılan Sıralama Yönü" bölümüne bakın.

Varsayılan Sıralama Yönünü Değiştirme

Not: Her sıralama yönü için her sayfadaki yorumlar önceden hesaplanır, bu yüzden tüm sıralama yönleri aynı performansa sahiptir.

Varsayılan olarak yorum giriş alanı yorum dizisinin önünde bulunur. Ancak bu yapılandırma parametresini true olarak ayarlayarak alanı sonra taşıyabiliriz.

Moving The Reply Box to The Bottom

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 "inputAfterComments": true

8}];

9</script>

10

Bu, kod yazmadan, widget özelleştirme sayfasında özelleştirilebilir:

Yanıt Kutusunu En Alta Taşıma

Yorum giriş alanına girilebilecek maksimum karakter sayısı maxCommentCharacterLength parametresiyle sınırlanabilir.

Varsayılan değer 2000'dir.

Görüntü URL'leri gibi şeyler uzunluk belirlemesinde dahil edilmez.

Yorum Uzunluğunu Sınırla

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 "maxCommentCharacterLength": 500

8}];

9</script>

10

Bu, kod yazmadan, widget özelleştirme sayfasında özelleştirilebilir:

Yorum Uzunluğunu Sınırla

Varsayılan olarak, FastComments kullanıcının istediği kadar satır içeren bir yorum girmesine izin verir, varsayılan karakter sınırına kadar.

Ancak, kullanıcının yalnızca tek bir satır metin girmesini sınırlamak isteyebilirsiniz. Örnek kullanım durumları arasında çevrimiçi teklif verme veya FastComments'un kullanılabileceği canlı sohbet bulunur.

useSingleLineCommentInput bayrağını aşağıdaki gibi etkinleştiririz:

Tek Satır Yorum Girişi Etkinleştir

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 "useSingleLineCommentInput": true

8}];

9</script>

10

Bu, kod olmadan da yapılabilir. Widget özelleştirme sayfasında, "Tek Satır Yorum Girişi Etkinleştir" bölümüne bakın.

Tek Satır Yorum Girişi Etkinleştir

Not edin, her sayfadaki yorumlar her sıralama yönü için önceden hesaplanır, bu yüzden tüm sıralama yönleri aynı performansa sahiptir.

Varsayılan olarak, her kullanıcı aynı dakikada en fazla 5 yorum gönderebilir.

Bu, kullanıcı kimliği, anonim kullanıcı kimliği ve IP adresi (hashlenmiş) ile izlenir.

Bu, kod yazmadan, widget özelleştirme sayfasında özelleştirilebilir:

Kullanıcı Başına Yorum Hacmini Sınırlama

Yorum oluşturma API'sini kullanıyorsanız, oran sınırlamasının kullanıcı başına uygulanması ve hesabınıza genel olarak uygulanmaması için istekte kullanıcının orijinal ip adresini arka uca göndermek isteyebilirsiniz.

FastComments, ilk kez yorum yapan kullanıcıların yorum göndermeden önce Hizmet Şartlarınızı kabul etmesini zorunlu kılmanıza olanak tanır.

Etkinleştirildiğinde:

• Anonim kullanıcılar her yorum yaptıklarında bir TOS onay kutusu görecek
• Kimliği doğrulanmış kullanıcılar onay kutusunu yalnızca ilk yorumlarında veya TOS'unuzu güncellediğinizde görecek

Yapılandırma

Widget özelleştirme sayfasına gidin ve "Hizmet Şartları kabulünü zorunlu kıl" onay kutusunu etkinleştirin. Etkinleştirildiğinde aşağıdaki seçenekleri göreceksiniz:

Hizmet Şartları Seçenekleri

• TOS Metin Modu: Varsayılan olarak, onay kutusu her iki belgeye bağlantı içeren "Hizmet Şartları ve Gizlilik Politikası'nı kabul ediyorum" metnini görüntüler. Her dil için kendi metninizi sağlamak üzere "Yerel ayara göre metni özelleştir" seçeneğini seçin.
• TOS Son Güncellenme Tarihi: Hizmet Şartlarınızı güncellediğinizde bu tarihi ayarlayın. Bu tarihten önce kabul etmiş kullanıcıların yeniden kabul etmesi gerekecek.

Nasıl Çalışır

• TOS kabul zaman damgası kullanıcı başına ve yorum başına saklanır
• Bir kullanıcı TOS'u kabul ettiğinde, tarih kullanıcı profilinde (kiracı başına) kaydedilir
• Kullanıcının kabul tarihinden sonra bir "Son Güncellenme" tarihi ayarlarsanız, yeniden kabul etmeleri gerekecek
• Takip edilemeyen anonim kullanıcılar için, onay kutusu her yorum gönderiminde görünür

Anketler, yorumcuların bir yoruma 2 ila 10 seçenekli bir soru eklemesine izin verir. Sayfadaki herkes yerinde oy verir ve sonuçların anlık olarak güncellenmesini görür.

Anketler varsayılan olarak kapalıdır. Yorum araç çubuğuna bir anket düğmesi eklemek için widget özelleştirme ayarlarında Enable Polls seçeneğini işaretleyin. Ardından iki ayar daha görünür:

• Who Can Create Polls: Yalnızca Yöneticiler/Moderatörler (varsayılan), veya Herkes.
• Allow Anonymous Poll Votes: işaretlenmediğinde (varsayılan), yalnızca oturum açmış kullanıcılar oy verebilir.

Anketleri Etkinleştir

Oluşturma, oy verme, gizlilik ve anket bildirimlerinin nasıl çalıştığını görmek için Anketler rehberi sayfasına bakın.

FastComments Güvenli SSO, SSO'yu uygulamak için mekanizma olarak HMAC-SHA256 şifrelemesini kullanır. Önce genel mimariyi ele alacağız, ardından örnekler ve ayrıntılı adımlar sunacağız.

Benzer SSO mekanizmalarına sahip diğer sağlayıcılardan geçiş yapmaya ve aralarındaki farklara dair bazı belgeler de mevcuttur.

Akış şu şekildedir:

Güvenli SSO Akışı

Güvenli SSO tam yığın (full-stack) geliştirme gerektirdiğinden, Java/Spring, NodeJS/Express ve saf PHP için eksiksiz çalışan kod örnekleri şu anda GitHub'da bulunmaktadır.

NodeJS örneğinde ExpressJS ve Java örneğinde Spring kullanmamıza rağmen, FastComments SSO'yu uygulamak için bu çalışma ortamlarında herhangi bir framework/kütüphane gerekmez - yerel crypto paketleri yeterlidir.

FastComments SSO ile yeni API endpoint'leri yazmanız gerekmez. Sadece kullanıcının bilgilerini gizli anahtarınızla şifreleyin ve payload'ı yorum widget'ına iletin.

API Gizli Anahtarınızı Alın

API Gizli Anahtarınızı bu sayfadan alabilirsiniz. Bu sayfaya Hesabım bölümüne gidip API/SSO kutucuğuna ve ardından "Get API Secret Key" seçeneğine tıklayarak da ulaşabilirsiniz.

Yorum Widget'ı Parametreleri

Yorum widget'ının üst düzey API belgelerine buradan ulaşabilirsiniz.

Bu parametrelerin ne anlama geldiğine daha yakından bakalım.

Yorum widget'ı bir yapılandırma nesnesi alır - FastComments kullanırken müşteri kimliğinizi (tenantId olarak adlandırılır) iletmek için bunu zaten iletiyorsunuzdur.

SSO'yu etkinleştirmek için, aşağıdaki parametreleri içermesi gereken yeni bir "sso" nesnesi iletin. Değerler sunucu tarafında oluşturulmalıdır.

• userDataJSONBase64: JSON formatındaki kullanıcı verisi, ardından Base64 ile kodlanır.
• verificationHash: UNIX_TIME_MILLIS + userDataJSONBase64 üzerinden oluşturulan HMAC-SHA256 hash'i.
• timestamp: Epoch zaman damgası, milisaniye cinsinden. Gelecekte veya iki günden daha eski bir tarihte olmamalıdır.
• loginURL: Yorum widget'ının kullanıcıyı oturum açmaya yönlendirmek için gösterebileceği bir URL.
• logoutURL: Yorum widget'ının kullanıcıyı oturumu kapatmaya yönlendirmek için gösterebileceği bir URL.
• loginCallback: Oturum açma URL'si yerine sağlandığında, oturum açma düğmesine tıklandığında yorum widget'ının çağıracağı bir fonksiyon.
• logoutCallback: Oturum kapatma URL'si yerine sağlandığında, oturum kapatma düğmesine tıklandığında yorum widget'ının çağıracağı bir fonksiyon.

Güvenli SSO İstemci Kodu

Copy

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 "sso": {

8 "userDataJSONBase64": "...",

9 "verificationHash": "...",

10 "timestamp": 1794130022773.0,

11 "loginURL": "https://example.com/login",

12 "logoutURL": "https://example.com/logout",

13 "loginCallback": null,

14 "logoutCallback": null

15 }

16}];

17</script>

18

Kullanıcı Nesnesi

Kullanıcı nesnesi şu şemayı içerir:

Kullanıcı Nesnesi

Copy

1

2interface SSOUser {

3 /** Zorunlu. En fazla 1k karakter. **/

4 id: string;

5 /** Zorunlu. En fazla 1k karakter. Not: Benzersiz olmalıdır. **/

6 email: string;

7 /** Zorunlu. En fazla 1k karakter. Not: Kullanıcı adı bir e-posta olamaz. Benzersiz olmak zorunda değildir. **/

8 username: string;

9 /** İsteğe bağlı. URL'ler için en fazla 3k karakter. Varsayılan, e-postaya göre gravatar'dan alınır. 64 kodlu görselleri destekler; bu durumda sınır 50k karakterdir. **/

10 avatar?: string;

11 /** İsteğe bağlı. Varsayılan false. **/

12 optedInNotifications?: boolean;

13 /** İsteğe bağlı. Varsayılan false. **/

14 optedInSubscriptionNotifications?: boolean;

15 /** İsteğe bağlı. En fazla 100 karakter. Bu etiket, kullanıcının adının yanında gösterilecektir. Uygun olduğunda varsayılan Administrator/Moderator'dur. **/

16 displayLabel?: string;

17 /** İsteğe bağlı. En fazla 500 karakter. Bu, kullanıcı adı yerine gösterilecektir. **/

18 displayName?: string;

19 /** İsteğe bağlı. En fazla 2k karakter. Kullanıcının adı buna bağlanacaktır. **/

20 websiteUrl?: string;

21 /** İsteğe bağlı. Kullanıcı başına en fazla 100 grup. Bir grup kimliği 50 karakterden uzun olamaz. **/

22 groupIds?: string[];

23 /** İsteğe bağlı. Kullanıcıyı yönetici olarak işaretler. **/

24 isAdmin?: boolean;

25 /** İsteğe bağlı. Kullanıcıyı moderatör olarak işaretler. **/

26 isModerator?: boolean;

27 /** İsteğe bağlı, varsayılan true. Kullanıcının profilindeki "activity" sekmesini etkinleştirmek için false olarak ayarlayın. **/

28 isProfileActivityPrivate?: boolean;

29 /** İsteğe bağlı, varsayılan false. Profil yorumlarını devre dışı bırakmak için true olarak ayarlayın. **/

30 isProfileCommentsPrivate?: boolean;

31 /** İsteğe bağlı, varsayılan false. Bu kullanıcıya doğrudan mesaj göndermeyi devre dışı bırakmak için true olarak ayarlayın. **/

32 isProfileDMDisabled?: boolean;

33 /** Kullanıcı rozetleri için isteğe bağlı yapılandırma. **/

34 badgeConfig?: {

35 /** Atanacak global rozet kimlikleri dizisi. 30 rozetle sınırlıdır. Sıra korunur. **/

36 badgeIds: string[];

37 /** Geçerli sayfaya (urlId) özel rozet kimlikleri dizisi. Yalnızca atanan sayfada görüntülenir. **/

38 pageBadgeIds?: string[];

39 /** true ise, mevcut görüntülenen rozetlerin yerini alır. Global ve sayfa kapsamlı olanlar bağımsız olarak geçersiz kılınır. **/

40 override?: boolean;

41 /** true ise, rozet görüntüleme özelliklerini kiracı yapılandırmasından günceller. **/

42 update?: boolean;

43 };

44}

45

Moderatörler ve Yöneticiler

Yöneticiler ve moderatörler için, SSOUser nesnesinde sırasıyla isAdmin veya isModerator bayraklarını iletin.

Bildirimler

Bildirimleri etkinleştirmek veya devre dışı bırakmak için optedInNotifications değerini sırasıyla true veya false olarak ayarlayın. Kullanıcı bu değeri SSO payload'ında içeren sayfayı ilk kez yüklediğinde, bildirim ayarları güncellenecektir.

Ayrıca, kullanıcıların abone oldukları sayfalardaki etkinlikler için bildirim e-postaları almasını istiyorsanız (yalnızca uygulama içi bildirimler yerine), optedInSubscriptionNotifications değerini true olarak ayarlayın.

VIP Kullanıcılar ve Özel Etiketler

İsteğe bağlı "displayLabel" alanını kullanarak kullanıcının adının yanında özel bir etiket görüntüleyebilirsiniz.

Kimliği Doğrulanmamış Kullanıcılar

Kimliği doğrulanmamış bir kullanıcıyı temsil etmek için, userDataJSONBase64, verificationHash veya timestamp alanlarını doldurmayın. Bir loginURL sağlayın.

Bu kullanıcılar yorum yapamaz; bunun yerine bir oturum açma mesajı (yapılandırmaya bağlı olarak mesaj, bağlantı veya düğme) sunulur.

Kullanıcı Verilerini Serileştirme ve Hashleme İçin Doğrudan Örnekler

Örnek olarak daha fazla ayrıntı burada (js), burada (java) ve burada (php) bulunmaktadır.

Herhangi bir entegrasyonun karmaşık ve zahmetli bir süreç olabileceğini biliyoruz. Temsilcinize ulaşmaktan veya destek sayfasını kullanmaktan çekinmeyin.

Simple SSO ile, yorum widget'ına kullanıcı hakkında bilgi sağlayabiliriz, böylece kullanıcı yorum yapmak için kullanıcı adı veya e-posta girmek zorunda kalmaz.

Simple SSO'yu aşağıdaki gibi yapılandırabiliriz:

Simple SSO

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 "simpleSSO": {

8 "username": "Bob",

9 "email": "bob@example.com",

10 "avatar": "https://example.com/bob.png",

11 "websiteUrl": "https://example.com/profiles/bob",

12 "displayName": "Bob's Name",

13 "displayLabel": "VIP User",

14 "loginURL": "https://example.com/login",

15 "logoutURL": "https://example.com/logout",

16 "badgeConfig": {

17 "badgeIds": [

18 "badge-id-1",

19 "badge-id-2"

20 ],

21 "pageBadgeIds": [

22 "badge-id-3"

23 ],

24 "override": false

25 }

26 }

27}];

28</script>

29

Kullanıcı oturum açmış olacak ve sahne arkasında bir SSO Kullanıcısı oluşturulacak. Kullanıcı, API'den alındıysa createdFromSimpleSSO özelliği true olarak ayarlanmış olacaktır.

Notlar:

• E-posta, Simple SSO için benzersiz tanımlayıcıdır.
• Simple SSO ile e-posta sağlamak zorunlu değildir, ancak varsayılan olarak yorumları "Doğrulanmamış" olarak gösterilir. E-posta sağlanmazsa, kullanıcı tam olarak kimlik doğrulaması yapılamaz.
• YENİ Ocak 2022'den beri: Kullanıcı adlarının fastcomments.com genelinde benzersiz olması gerekmez
• Simple SSO, bir e-posta sağlanmışsa ve kullanıcı başlangıçta Secure SSO'dan oluşturulmamışsa, SSO kullanıcılarını otomatik olarak oluşturabilir ve güncelleyebilir. Simple SSO yükü, Secure SSO veya API tarafından oluşturulan bir kullanıcıyı adlandırıyorsa, o kullanıcı dokunulmaz kalır ve ziyaretçi ayrı bir kullanıcı alır.
• Kullanıcı için rozetleri badgeConfig özelliğiyle belirtebilirsiniz. badgeIds dizisi, kullanıcıyla ilişkilendirilecek global rozetlerin kimliklerini içerir. pageBadgeIds dizisi, mevcut sayfaya (urlId) özgü rozet kimliklerini içerir — bu rozetler yalnızca atandıkları sayfada gösterilir. override true olarak ayarlanırsa, mevcut gösterilen rozetleri (global ve sayfa kapsamlı olanlar bağımsız olarak geçersiz kılınır) değiştirir; false ise mevcut rozetlere ekler.

Simple SSO Ayarları

Simple SSO her zaman kullanılabilir. İki ayar, FastComments'un ona ne kadar güveneceğini kontrol eder. Bunları özelleştirme kuralı içinde SSO aratarak bulabilirsiniz. Her ikisi de varsayılan olarak kapalıdır ve "Yorumları Görmek İçin SSO Gereksin" açık olsun ya da olmasın uygulanır.

Bu ayarlar eklendiğinde zaten Simple SSO kullanan hesaplarda her iki ayar da açık olarak ayarlandı, bu yüzden onlar için bir değişiklik olmadı.

Yalnızca bir sayfaya en iyi uyan özelleştirme kuralı uygulanır, bu yüzden birden fazla kuralınız varsa, bunları her birine ayarlayın. Diğer kurallarınızdan herhangi biri bu ayarları açık tutuyorsa, yeni bir kural da bunlarla başlar.

Simple SSO ile Yorumları Otomatik Doğrulama

Bu açık olduğunda, Simple SSO kullanıcılarından gelen yorumlar hemen doğrulanır.

Bu kapalı olduğunda, Simple SSO kullanıcılarından gelen yorumlar, kullanıcı Simple SSO yükündeki adrese gönderdiğimiz bir bağlantıya tıklayana kadar "Doğrulanmamış" olarak gösterilir. Yalnızca doğrulanmış yorumları otomatik onaylıyorsanız, bu yorumlar da o bağlantıyı bekler. Yükte e-posta yoksa, yorum doğrulanmamış olarak kalır.

Bu ayar yalnızca yorumları etkiler. Simple SSO kullanıcılarından gelen oylar her zaman hemen sayılır.

Simple SSO Yöneticilerine İzin Ver

Bu açık olduğunda, bir Simple SSO kullanıcısı hesabınızın yöneticisi veya moderatörü olabilir:

• Yönetici veya moderatör izinlerine sahip bir Simple SSO kullanıcısı bu izinleri korur.
• Yöneticilerinizden veya moderatörlerinizden birinin aynı e-posta adresine sahip bir Simple SSO kullanıcısı, onların izinlerini alır.

Bu kapalı olduğunda, Simple SSO bu izinleri vermez. Bu izinlere sahip bir kullanıcıyı adlandıran Simple SSO yükü, izinleri olmayan ayrı bir kullanıcı oluşturur ve orijinal kullanıcı dokunulmaz kalır.

Simple SSO yükleri imzalanmamıştır, bu yüzden bu açık olduğunda, bir yöneticinin e-posta adresini veya kullanıcı kimliğini bilen herkes onun gibi davranabilir. Bu siteniz için önemliyse, bu ayarı kapalı tutun ve yöneticileriniz için Secure SSO kullanın.

Secure SSO veya API tarafından oluşturulan kullanıcılar, Simple SSO tarafından erişilemez; bu ayar açık olsun ya da olmasın.

FastComments SSO (ayrıntılar burada), kullanıcılarınızın başka bir platforma giriş yapmak zorunda kalmadan yorum yapabilmesini sağlar.

Ancak bu tek başına yorum dizilerinizi güvence altına almaz, çünkü varsayılan olarak yorum verileri herkese açık bilgilerdir - sayfayı görüntüleyebilen herkes yorumları görebilir.

Bir ayarı değiştirerek, yorumların yalnızca bir yönetici veya geçerli bir SSO kullanıcısı tarafından alınabilmesi dışında getirilmesini kısıtlayabiliriz.

Kod Yazmadan Kurulum

SSO kurulduğunda, bir özelleştirme kuralı oluşturarak yorum dizilerimizi görüntülemeyi ve etkileşimde bulunmayı engelleyebiliriz.

Bunu yaparken SSO araması yapın ve bu seçeneği bulacaksınız:

Yorumları Görüntülemek İçin SSO Gerekli

Etkinleştirin ve özelleştirme kuralını kaydedin.

Yalnızca Belirli Bir Alan Adını veya Sayfayı Koruma

Yalnızca belirli bir Alan Adını veya Sayfayı korumak için, özelleştirme kuralını buna göre yapılandıracağız.

Özelleştirme arayüzünün üst kısmında, Alan Adı (Domain) ve URL Kimliği (URL ID) olmak üzere iki giriş alanı bulacağız.

Yalnızca belirli bir alan adını korumak için, ilgili alan adını "domain" alanına girin.

Belirli bir sayfayı korumak için, "URL ID" alanına bir sayfa URL'si girin. FastComments ile özel bir entegrasyonunuz varsa, URL yerine bir tür kimlik girebilirsiniz.

Güvenlik Düzeyleri

SSO zorunlu kılarken, Basit SSO mu yoksa Güvenli SSO mu gerektirdiğinize karar vermek isteyeceksiniz. Basit SSO gerektiriyorsanız ikisine de izin verilir, ancak Güvenli SSO gerektiriyorsanız içeriğin görüntülenebilmesi için API anahtarınızla hash'lenmiş bir Güvenli SSO payload'ı ile alınması gerekir.

Güvenlik düzeyi seçeneği, "Yorumları Görüntülemek İçin SSO Gerekli" seçeneğini seçtiğinizde görünür ve yalnızca bu seçenek açıkken geçerlidir.

Yorumları Basit SSO ile Otomatik Doğrula ve Basit SSO Yöneticilerine İzin Ver ayarları ayrıdır ve bu seçeneğin açık olup olmamasından bağımsız olarak uygulanır.

Okumanın Ötesinde Koruma

Bu seçeneği etkinleştirmek, kullanıcı SSO ile giriş yapmadığı sürece sayfanın veya alan adının yorum yapılmaktan korunmasını sağlar.

Dikkat Edilmesi Gerekenler

SSO entegrasyonunuzdan önce yorum oluşturan kullanıcılar, SSO entegrasyonunuz üzerinden giriş yapmadıkları sürece yorumlarını göremezler.

Varsayılan olarak, FastComments yorum yapmak için bir e-posta gerektirir. Geçerli bir e-posta olması gerekmez, ancak kullanıcı kendisine gönderilen bağlantıya tıklayana kadar, yorumu "Doğrulanmamış Yorum" etiketi gösterir.

Ancak, e-posta gereksinimini kaldırabiliriz. E-posta giriş alanı hâlâ görünecek, ancak artık zorunlu olmayacak.

Bu, widget özelleştirme UI'si aracılığıyla yapılandırılabilir:

Anonim Yorumları Etkinleştirme

Bir kullanıcı adı hâlâ gereklidir. Bu adımı da kaldırmak için, herkesin paylaştığı bir varsayılan kullanıcı adı ayarlayabilir ya da FastComments her ziyaretçi için benzersiz bir kullanıcı adı oluşturabilir for each visitor.

FastComments, istenen bir gün sayısından sonra doğrulanmamış yorumları kaldıracak şekilde yapılandırılabilir. Bu, spam ile mücadeleye yardımcı olur.

Varsayılan olarak, yapmaz.

Bu, Moderasyon Ayarları sayfası üzerinden yapılandırılabilir veya devre dışı bırakılabilir.

Moderasyon Ayarları

Kullanıcılar yorum yaptığında ve oturum açmamışlarsa, e-posta adreslerini girmeleri istenir.

Bu, o kullanıcı için bir "doğrulanmamış oturum" oluşturur ve bu oturumu e-posta yoluyla doğrulamalarını isteriz.

Bazı siteler veya uygulamalar için, yorum yaparken veya oy verirken kullanıcıdan e-posta adresini istememek istenebilir.

Anonim yorum yapmayı etkinleştirmek, e-posta giriş alanını isteğe bağlı hale getirir. Ancak, bunu tamamen devre dışı bırakabiliriz. Önce anonim yorum yapmayı etkinleştirin, ardından e-posta giriş alanlarını devre dışı bırakma seçeneği görünecektir.

E-posta Giriş Alanlarını Devre Dışı Bırak

Bu açıkken, e-posta alanları tüm yorum ürünlerimizde hiç görünmeyecektir.

Bu yapılandırmayla, kullanıcı bir hesap oluşturup https://fastcomments.com adresinde oturum açmadığı sürece tüm yorumların doğrulanmamış olacağını unutmayın.

Doğrulanmamış etiketini devre dışı bırakmayı düşünebilirsiniz.

Varsayılan olarak, FastComments, doğrulanmamış bir tarayıcı oturumuna sahip bir kullanıcı için bırakılan yorumlarda "Doğrulanmamış Yorum" etiketini gösterir. Doğrulanmamış yorumlama hakkında daha fazla bilgiyi burada okuyabilirsiniz.

Disable The Unverified Label

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 "disableUnverifiedLabel": true

8}];

9</script>

10

Ayrıca, bu özellik kod yazmadan, Özelleştirme UI'sinde kullanılabilir:

Doğrulanmamış Etiketi Devre Dışı Bırak

Kullanıcılar bir yoruma oy vermeye çalıştıklarında ve oturum açmamışlarsa, kullanıcı adlarını ve e-posta adreslerini girmeleri istenir.

Bu gereksinimi kaldırabilir, böylece herkes bir yoruma oy verirken hiçbir bilgi bırakmadan oy verebilir.

Anonim Oyları İzin Ver

Kullanıcılar yorum yaptığında veya oy verdiğinde, oturum açmamışlarsa e-posta adreslerini ve kullanıcı adlarını girmeleri istenir.

Anonim yorum durumunda, yorum yaparken sürtünmeyi azaltmak için varsayılan bir kullanıcı adı tanımlamak bazen istenebilir. Bu, Özelleştirme arayüzünden yapılabilir. Öncelikle Anonim Yorum etkinleştirilmelidir.

Varsayılan Kullanıcı Adını Ayarlama

Varsayılan Kullanıcı Adının Paylaşılması

Varsayılan kullanıcı adı, bir kimlik değil, paylaşılan bir görünen addır. Varsayılanı koruyan ve e-posta adresini giren bir ziyaretçi, varsayılanı herkese açık adı olarak gösterilen kendi hesabını alır. Sınırsız sayıda ziyaretçi aynı varsayılanı koruyabilir, bu nedenle "Anonymous" (Anonim) hiçbir zaman zaten alınmış olarak bildirilmez.

Ziyaretçinin kendisinin yazdığı kullanıcı adları ise yine benzersiz olmak zorundadır.

Her ziyaretçinin bir ad düşünmek zorunda kalmadan farklı bir ad almasını tercih ederseniz, bkz. Kullanıcı Adlarını Otomatik Oluşturma.

Kullanıcılar yorum yaptığında veya oy verdiğinde ve oturum açmamış olduklarında, e-posta adreslerini ve kullanıcı adlarını girmeleri istenir.

Bazı siteler için, ziyaretçiden benzersiz bir kullanıcı adı uydurmasını istemek, özellikle mobilde bir engel oluşturabilir. FastComments, her yeni ziyaretçi için nötr bir kullanıcı adı oluşturabilir ve bunu kullanıcı adı alanına önceden doldurabilir; örneğin BraveOtter4172 gibi.

Ziyaretçi bu adı olduğu gibi bırakabilir veya kendi seçtiği bir adla değiştirebilir.

Bu özellik, Customization UI üzerinden Generate Usernames Automatically adlı ayar altından etkinleştirilebilir:

Generate Usernames Automatically

Nasıl Davranır

• Oluşturulan her ad benzersizdir. Mevcut hesaplarla kontrol edilir ve o ziyaretçinin tarayıcı oturumu için ayrılır; böylece iki ziyaretçiye aynı ad önerilmez.
• Ad yalnızca henüz bir adı olmayan ziyaretçiler için oluşturulur. Oturum açmış kullanıcılar, SSO kullanıcıları ve daha önce yorum yapmış ziyaretçiler mevcut adlarını korur.
• Anonim yorumlama açıkken veya kapalıyken çalışır. Anonim yorumlama kapalıyken, ziyaretçi yine de e-postasını girer, ancak artık bir kullanıcı adı düşünmek zorunda kalmaz.
• Daha önce kullandığı bir e-postayı giren geri dönen ziyaretçi, mevcut hesabıyla eşleştirilir ve o hesaptaki adı korur.
• Ayrıca bir Default Username ayarlanmışsa, oluşturulan ad öncelik alır.

Varsayılan olarak, FastComments yorum widget'ını kullanıcının sistem ve tarayıcı tarafından belirlenen yerel ayarda render eder.

Bir kullanıcı yorum yaptığında veya oturum açtığında, son kullandığı yerel ayarı günceller ve bunu e-posta gönderiminde de kullanırız.

Bu, yorum widget'ının kullanıcı için nasıl çevrileceğini etkiler. Yerel ayar, kullanıcının dili ve bölgesinden oluşur, bu yüzden yerel ayarı yapılandırmak genellikle kullanıcıya gösterilen metnin dilini değiştirir.

Arayüz Üzerinden

Bu, widget özelleştirme UI'sı kullanılarak tanımlanabilir. "Locale / Language" seçeneğine bakın:

Dil / Yerel Ayarı Değiştirme

Kod ile

Bu, istenen bir yerel ayar ile geçersiz kılınabilir.

Kullanıcının Dilini Manuel Olarak Tanımlama

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 "locale": "ru_ru"

8}];

9</script>

10

Desteklenen Diller ve Yerel Ayar Kodları

Desteklenen dillerin tam listesini ve ilgili yerel ayar kodlarını burada bulabilirsiniz.

SSO Notu

SSO kullanıyorsanız, kullanıcının yerel ayarını kullanıcı nesnesine geçirmek isteyebilirsiniz, böylece e-postalar ve diğer öğeler onlar için doğru şekilde yerelleştirilir.

Varsayılan olarak, FastComments yorumlarda kullanılan dilleri sınırlamaz.

Bir topluluğun kullandığı dilleri sınırlamak isteyebilirsiniz.

Bu, kod yazmadan, widget özelleştirme sayfasında yapılandırılabilir:

İzin Verilen Diller

Sistem, yorumlarını ayrıştırarak dilini belirler ve ardından izin verilen listelerle eşleştirir.

Yorum, izin verilen bir dilde yazılmamışsa, yerelleştirilmiş bir hata mesajı gösterilir.

Varsayılan olarak, FastComments widget'ın kendi arayüzünü (düğmeler, etiketler, hata mesajları) izleyicinin diline çevirir, ancak yorumlar tam olarak yazıldıkları şekilde gösterilir.

Yorum Çevirisi, yorumların kendisinin çevirisini ekler, böylece birden fazla dilde yazan bir topluluk her yorumu kendi dilinde okuyabilir.

İki mod vardır:

• Automatic: widget'ın dilinden farklı bir dilde yazılmış yorumlar çevrilmiş olarak gösterilir. Yorumun altında "İspanyolca'dan Çevrildi" satırı belirir ve Show original bağlantısı çeviri ile orijinal metin arasında geçiş yapar.
• Manual: her yorum bir Translate bağlantısı alır. Buna tıklamak, o yorumu izleyicinin diline çevirir ve ardından aynı Show original geçişi bulunur. Yorumlar zaten izleyicinin dilindeyse bunun yerine bunu belirtir.

Hedef dil, widget'ın dilidir: aynı özelleştirme kuralında ayarlanmışsa Locale / Language ayarı, aksi takdirde ziyaretçinin tarayıcı dili. Ziyaretçiden hiçbir şey istenmez, hesap, uzantı veya ekstra yazılım gerekmez ve gömülü widget'ta ve bağımsız yorum sayfalarında aynı şekilde çalışır.

Bu, özelleştirme kuralı başına etkinleştirilir, böylece tüm sitenize, bir domaine veya tek bir sayfaya uygulanabilir. Varsayılan olarak kapalıdır.

Yorum Çevirisi

Çeviri, sunucu tarafı bir ayardır. Widget'ın JavaScript yapılandırmasında commentTranslation geçmek bunu etkinleştirmez; kural bunu yapar.

Her yorum, hedef dil başına en fazla bir kez çevrilir ve sonuç yorumla birlikte depolanır, böylece binlerce İspanyolca konuşanı tarafından okunan bir yorum bir kez çevrilir. Yazar veya bir moderatör yorumu düzenlerse, depolanan çeviri atılır ve yorum bir sonraki görüntülemede tekrar çevrilir. Çevrilen metin, orijinal yorumla aynı temizlik ve bağlantı kurallarına tabi tutulur. Çok uzun olan veya dili tespit edilemeyen yorumlar çevrilmemiş olarak gösterilir.

Kullanım, AI Agents ile aynı oran üzerinden LLM tokenları olarak faturalandırılır ve fatura detaylarınızda aynı yerde görünür.

Yorum yapma, readonly bayrağı true olarak ayarlandığında yeni yorumların veya oyların bırakılmasını engelleyecek şekilde kilitlenebilir.

Yorumlar ayrıca düzenlenemez veya silinemez.

Yorum Dizisini Salt Okunur Hale Getirme

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 "readonly": true

8}];

9</script>

10

Bu, kod olmadan, widget özelleştirme sayfasında, tüm bir alan adı veya sayfa için özelleştirilebilir:

Yorum Dizisini Salt Okunur Hale Getirme

Güncelleme!

Kasım 2022 itibarıyla, diziler yöneticiler ve moderatörler tarafından yanıt alanının üzerindeki üç nokta menüsü aracılığıyla canlı olarak kilitlenebilir veya kilidi açılabilir.

Bu, yeni yorumları engellerken hâlâ oy vermeye izin verir ve istenirse kullanıcıların yorumlarını silmesine izin verir; readonly bu şeylere izin vermez.

Bu, Page API'sindeki isClosed alanına karşılık gelir.

Varsayılan olarak, FastComments herhangi bir harici siteye bağlanmaya izin verir.

Bu, istenen bir site veya alan adı listesiyle sınırlanabilir. Tanımlı listede olmayan bir siteye veya alan adına bağlantı göndermeye çalışmak, kullanıcıya bir hata gösterilmesine neden olur.

Bu doğrulama yalnızca Yorum Widget'ı ve API için geçerlidir. İçe aktarmalar etkilenmez.

Bu, kod yazmadan, widget özelleştirme sayfasında yapılır:

Dış Bağlantı Alan Adlarını Kısıtla

Varsayılan olarak, FastComments yalnızca kullanıcıdan yorumunu, kullanıcı adını ve e-posta adresini ister.

Ancak, bazı durumlarda kullanıcının kendi bloguna veya web sitesine bir bağlantı bırakmasını isteyebilirsiniz.

Kullanıcının web sitesi URL'sini bırakması için ekstra bir giriş alanı göstermeyi, enableCommenterLinks bayrağını true olarak ayarlayarak etkinleştirebiliriz:

Yorumcu Bağlantılarını Etkinleştirme

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 "enableCommenterLinks": true

8}];

9</script>

10

Bu URL sağlandığında, kullanıcının hesabı güncellenecek ve geçmiş ve gelecekteki tüm yorumlarda kullanıcı adları bu URL'ye bağlanacaktır.

Bu, kod yazmadan, widget özelleştirme sayfasında özelleştirilebilir:

Yorumcu Bağlantılarını Etkinleştirme

Bir liste, Moderasyon Grupları sayfasından oluşturulan kimlikler.

Belirtilirse, belirtilen yapılandırma kullanılarak bırakılan yorumlar aynı moderationGroupIds kümesini içerir.

Bir Moderator bir veya daha fazla Moderasyon Grupları tanımlıysa, yalnızca grup(ler)iyle ilişkili Moderate Comments sayfasındaki yorumları görür.

Moderasyon Gruplarını Belirle

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 "moderationGroupIds": [

8 "mxZAhjzdb",

9 "FT19nXbqA"

10 ]

11}];

12</script>

13

Kimlik doğrulama için, FastComments tarayıcınızda üçüncü taraf çerezlerin etkin olmasına bağlıdır. Çerezler olmadan, kullanıcıların yorum yapmak için her zaman e-posta adreslerini bırakmaları gerekir (e-posta giriş alanı gizli değilse) ve yorumları varsayılan olarak doğrulanmamış olarak gösterilir.

Bunu aşmak için üçüncü taraf çerez atlatmasını etkinleştirebilirsiniz.

Bu ayar etkinleştirildiğinde, kullanıcının oturum açtığını belirten bir mesaj gösteren küçük bir açılır pencere oluşur. Bu açılır pencere, kullanıcı yorum widget'ı ile etkileşime girdiğinde gösterilir; örneğin, bir yorum bıraktıklarında.

Bunu kodda enableThirdPartyCookieBypass bayrağını true olarak ayarlayarak yapabiliriz:

Üçüncü Taraf Çerez Atlatmasını Etkinleştirme

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 "enableThirdPartyCookieBypass": true

8}];

9</script>

10

Bunu ayrıca Widget Özelleştirme UI'si üzerinden, Enable Third-Party Cookie Popup altında ayarlayabiliriz:

Üçüncü Taraf Çerez Atlatmasını Etkinleştirme

Varsayılan olarak, kullanıcılar kendi yorumlarını silebilir. Ayrıca, yorumlarını silmek otomatik olarak konudaki tüm alt ve geçici yorumları da siler. Bu davranış da canlıdır.

Bunu aşağıdaki yollarla kısıtlayabilirsiniz:

• Bunun yerine, silinen yorumu anonimleştirin (ad ve metni [deleted] ya da özel bir değer olarak ayarlayın).
• Yanıtlar olduğunda yorumların silinmesine izin vermeyin. Özelleştirilebilir bir hata mesajı gösterilir.
• Bir yorumun yanıtları olduğunda silmeyi yalnızca yöneticilere ve moderatörlere sınırlayın.

Bu, Widget Özelleştirme UI'sindeki Comment Thread Deletion bölümü aracılığıyla yapılandırılabilir.

Yanıtlar için Silme Davranışını Özelleştir

Varsayılan olarak, FastComments kullanıcı rozetlerini yalnızca yorum dizisindeki yorumlarında gösterir.

Ancak, bu özelliği widget özelleştirme sayfasında etkinleştirerek kullanıcı rozetlerini yorum formunun üzerindeki isimlerinin yanına gösterebiliriz:

Üst Çubukta Rozetleri Göster Seçeneği

Bu, kullanıcının rozetlerini adının yanında üst çubuk alanında gösterir ve yorum yazarken başarılarını ve durumunu daha belirgin hâle getirir.

Bu özelliğin çalışması için widget özelleştirme arayüzünde etkinleştirilmiş olması gerektiğini unutmayın. Sunucu seviyesinde açık olsa bile, kod yapılandırmanızda showBadgesInTopBar bayrağını false olarak ayarlayarak isteğe bağlı olarak devre dışı bırakabilirsiniz:

Disable Show Badges in Top Bar

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 "showBadgesInTopBar": false

8}];

9</script>

10

Varsayılan olarak, FastComments sayfada bir kullanıcı listesi göstermez.

Yorum widget'ının yanında, sayfayı şu anda görüntüleyen kişilerin bir listesini render edebilirsiniz. Liste, kullanıcılar katıldıkça ve ayrıldıkça canlı olarak güncellenir ve adlarını, avatarlarını ve çevrimiçi göstergesini gösterir.

Üç düzen seçeneği vardır:

• 1 - Üst: Yorumların üzerinde render edilen, üst üste binen avatarların yatay bir satırı.
• 2 - Sol: Widget'ın solunda render edilen, isimler ve çevrimiçi noktalar içeren bir kenar çubuğu.
• 3 - Sağ: Widget'ın sağında render edilen aynı kenar çubuğu.

usersListLocation bayrağını ayarlayarak özelliği etkinleştirin:

Show Users List on the Right

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 "usersListLocation": 3

8}];

9</script>

10

Varsayılan olarak liste yalnızca şu anda çevrimiçi olan kullanıcıları gösterir. Geçmişte sayfada yorum yapmış (ancak şu anda görüntülemeyen) kişileri de dahil etmek için usersListIncludeOffline değerini true olarak ayarlayın:

Include Past Commenters

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 "usersListLocation": 3,

8 "usersListIncludeOffline": true

9}];

10</script>

11

Geçmiş yorumcular, yeşil çevrimiçi nokta olmadan render edilir, böylece şu anda kimlerin bulunduğu net olur.

Özel profillere sahip kullanıcılar, kimlikleri ortaya çıkmadan sayımın doğru kalmasını sağlamak için genel bir avatar ve "Özel Profil" etiketiyle gösterilir.

Bu aynı zamanda kod olmadan da yapılandırılabilir. Widget özelleştirme sayfasında "Users List Location" seçeneğine bakın. Konum Off dışındaki bir değere ayarlandığında, altında bir "Geçmiş yorumcuları dahil et" onay kutusu görünür.

Kullanıcı Listesi Ayarları

500 canlı kullanıcıdan sonra, liste en fazla 30 saniye gecikmeli olabilir.