Ö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).

When rendering a comment thread, or leaving a comment, FastComments needs to know what page, or article, or product those comments belong to.

To do this, we use something we call the "URL ID". It's either an identifier, like a string or a number, or a URL.

By default, if you do not specify the urlId, it will become the page URL. We will take the current page URL, and clean it to remove any common marketing parameters or tracking identifiers.

In the case of third party integrations, like WordPress, our plugin will usually use the identifier that represents the current information being viewed as the URL ID, for example the article/page id.

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

8}];

9</script>

10

One thing that we'll often reference in this document is the Widget Özelleştirme Arayüzü.

This UI can be used to make many changes to the comment widget without using code.

When creating a customization rule, we'll often want it to apply to all pages to our site. However, in some cases we want to customize the comment widget on a particular page, either to apply custom styling, or maybe make comments for that particular page anonymous. You could also, for example, have live comments appear right away on some pages, while hiding them under notification buttons on others.

This is all possible via the URL ID input field on this page, which looks like as follows:

URL ID Input in The Widget Customization Page

The value in this field should match the urlId parameter passed into the comment widget. If you want your customization rule to be urlId agnostic, leave this field empty or enter *.

As of 2023 the URL ID field in widget customization now also takes patterns! For example you may have */blog/* to add styling specific to your blog and */store/* to have styling specific to your store, all while using the same domain.

Gotchas

1. If your page has hash parameters (like example.com#page-1) - this will become part of the URL ID, by default.
2. During migrations, for example from WordPress to Gatsby, you may have to migrate the URL ID comment values after the initial migration. For that, reach out to us.

FastComments, özelleştirilmeye yönelik tasarlanmıştır. Yorum bileşeni güvenlik nedeniyle bir iframe içinde çalışır, bu yüzden özel stil uygulamak için iki yaklaşımdan birini takip etmelisiniz.

Birinci, en kolay ve bizim tercih ettiğimiz yaklaşım, widget customization page kullanmaktır.

Widget özelleştirme sayfasında, "Show Advanced Options" bölümünü görün; bu bölümün altında "Custom CSS" adlı bir alan vardır:

Custom CSS Input Area

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

1. Girilen CSS, kullanıcıya gönderilmeden önce küçültülür (minify edilir) ve düzenleme kullanıcı arayüzünde biçimlendirme tutarlı tutulur.
2. Widget özelleştirme kullanıcı arayüzünün tüm avantajlarından yararlanırsınız; örneğin farklı siteler için yorum bileşenini kolayca farklı şekilde özelleştirebilirsiniz.
3. Yorum bileşeninde değişiklik yaptığımızda, özel stiliniz sürüm yayın sürecimizin bir parçası olarak test edilecektir.

İkinci yaklaşım ise widget yapılandırmasında customCSS parametresini belirtmektir, şu şekilde:

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

8}];

9</script>

10

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

1. Başlıkların (headers) boyutu nedeniyle sunucularımız isteği reddetmeden önce iletilebilecek özel CSS miktarı için bir sınır vardır.
2. Özel CSS'i kendi altyapınızda ve derleme sisteminizde yönetmelisiniz. Bu, bir dezavantajdan ziyade avantaj da olabilir.
3. Bu kullanım durumunda özel CSS'in ağ üzerinden iki kez gönderilmesi gerektiği için ek bir yük vardır; önce sunucularımıza gönderilir, sonra iframe içeriğinde geri gönderilir. Ancak çoğu yük boyutu için bu farkedilebilir değildir.
4. Yaygın bir optimizasyon, CSS'i ağ üzerinden gönderim boyutunu azaltmak için küçültmektir (minify); ancak bu yaklaşımda bunu sizin halletmeniz gerekir.
5. Özel CSS'iniz bizim değişiklik yaptığımızda test edilmeyecektir.

External CSS Files

Dış bir dosyayı getirmesini widget'a @import kullanarak söyleyebilirsiniz!

@import'ı bir özelleştirme kuralına koymanız önerilir. Bu şekilde, yorum bileşeninde değişiklik yapmamız gerektiğinde, kurulumunuzu doğrulamak için otomasyon araçlarımızı kullanabiliriz. Örneğin, Widget Özelleştirme UI'da bir özelleştirme kuralı oluşturur, Advanced'a tıklar ve Custom CSS içine şunu girersiniz:

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

In Code - Not Recommended

Harici bir CSS dosyasını ayrıca customCSS özelliği aracılığıyla da yükleyebilirsiniz:

External CSS File

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.

User Profile Modal Styling

Kullanıcı profil modal'ları da özel CSS ile stillendirilebilir. Ancak özel stilin kullanıcı profillerine uygulanmasını sağlamak için tüm CSS seçicilerinin .user-profile ile öneklenmiş olması gerekir. Bu önek olmadan, kullanıcı profil modal'ları için özel stil göz ardı edilecektir.

Örneğin:

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

Backwards Compatibility

FastComments'ta, müşterilerimizin yorum bileşenini özelleştirdiğini biliyoruz. Bu tasarımın bir parçasıdır - ürünümüzün ürününüzde tasarım tutarsızlıklarına neden olmasını istemeyiz.

Bu, ürünümüzün önemli bir parçası olduğundan, her sürümde müşteri başına yorum bileşenindeki değişiklikleri incelememizi sağlayan bir derleme hattımız (build pipeline) vardır.

Küçük sorunlar bulursak, sürümün sorunsuz gitmesini sağlamak için hesabınızı güncelleriz. Büyük kırılmaya yol açan değişiklikler görürsek, bu 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 bileşenindeki tüm metinler özelleştirilebilir.

Gönderme düğmesi gibi tek bir metni veya tüm yorum bileşenindeki tüm metinleri değiştirebilirsiniz.

Varsayılan olarak, yorum bileşenindeki metin kullanıcıların yerel ayarlarına göre çevrilir. Ancak, kullanıcı tabanımızın aynı yerel/dili kullandığından eminseniz metni geçersiz kılabiliriz, örneğin:

Custom Text

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" sekmesi altında bulunur.

Ancak, widget özelleştirme kullanıcı arayüzü üzerinden daha kolay bir yol var. Orada, yorum bileşeninde EN_US yerel ayarında gösterilen metni bulup, bir değişiklik belirtebiliriz.

Custom Text

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

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

Ancak bir avatar bulamazsak veya kullanıcı hesabında hiç avatar ayarlamamışsa, statik bir varsayılan avatar resmi gösteririz.

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

Override The Default Avatar

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 işlem kod olmadan da yapılabilir. Widget özelleştirme sayfasında "Varsayılan Avatar" bölümüne bakın.

Customizing The Default Avatar

Belirli bir kullanıcı için avatarın tanımlanmasının, örneğin SSO ile, kendi bölümünde ele alındığını unutmayın.

Avatarlar, kullanıcılar kendi avatarlarını tanımlamış olsalar bile, yorum bileşeninden tamamen kaldırılabilir.

Hiding Avatars

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:

Hiding Avatars

Daha büyük özelleştirilmiş stil projelerinde, temiz bir sayfadan başlamak ve varsayılan stilleri hiç kullanmamak tercih edilebilir.

Tüm varsayılan stiller, noStyles parametresini true olarak ayarlayarak kaldırılabilir, şu şekilde:

Disabling All Default Styles

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 kullanmadan, widget özelleştirme sayfasında, Gelişmiş Seçenekler altında özelleştirilebilir:

Disabling All Default Styles

Varsayılan olarak, üst düzey yorumlara yapılan yanıtlar gösterilir.

Bu, kullanıcıların çocuk yorumları görmek için üst düzey yorumlarda "Yanıtları Göster"e tıklaması gerekecek şekilde yapılandırılabilir.

Collapse Replies to Top Level Comments

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:

Collapse Replies

Bu ayar başlangıçta yüklenen üst düzey yorumların sayısını etkilemez. Eğer bir üst düzey yorumunuz ve 29 çocuğu varsa, bu ayar açıkken şunları göreceksiniz:

• Üst düzey yorumu görürsünüz.
• Bu yorumun altında "Yanıtları Göster (29)" görürsünüz.

Bu seçenekle birlikte tüm üst düzey yorumları göstermek istiyorsanız, başlangıç sayfasını -1 olarak ayarlayın.

Varsayılan olarak FastComments'taki biçimlendirme işlevleri, metninizin etrafına <b></b> gibi görünür etiketler ekleyerek yapılır. Araç çubuğuna tıklamak veya kısayolları kullanmak bunu sizin için yapar. Ancak bazı topluluklar, biçimlendirmeyi bağlantı etiketleri olmadan kullanmayı tercih edebilir. Buna WYSIWYG (gördüğünüz şey, elde ettiğiniz şey) düzenleyicisini etkinleştirmek denir. Bu düzenleyici görünüş olarak varsayılan olanla tamamen aynıdır; farkı, kullanıcıların metinlerini görünür etiketler olmadan kalın, altı çizili vb. yapmalarını sağlayan ek kodu yüklemesidir.

Enabling WYSIWYG Editing

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 "Gelişmiş Biçimlendirmeyi Etkinleştir" seçeneğine bakın.

Enable WYSIWYG

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

Bu araç çubuğu kodla veya Özelleştirme Arayüzü ile devre dışı bırakılabilir.

Disabling The Toolbar

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 işlem kod olmadan da yapılabilir. Widget özelleştirme sayfasında, "Yanıt Araç Çubuğunu Devre Dışı Bırak" seçeneğine bakın.

Disabling The Toolbar

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ında bildirimlerin engellenmesine ve benzeri durumlara neden olur.

Bu işlevi devre dışı bırakmak isteyebilirsiniz. Şöyle yapılabilir:

Disable Blocking

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, ayrıca uygun sunucu tarafı doğrulamasını etkinleştirerek, Widget Özelleştirme UI'si aracılığıyla kod yazmadan da yapılabilir:

Disable Blocking

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

Mutlak tarihler kullanmak gerekli veya istenen bir şey olabilir; bu durumda bu parametreyi true olarak ayarlarsınız.

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

8}];

9</script>

10

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

Use Absolute Dates

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

Bu göreli tarih biçimini korumak gerekebilir veya isteğe bağlı olabilir; ancak aynı zamanda tam tarihi de yanında göstermek istiyorsanız, 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 kullanıcı arayüzünde (UI) görebilmek için önce Mutlak Tarihleri etkinleştirmeniz gerekir.

Use Both Absolute and Relative Dates

Başlık veya bir mesaj gibi bazı metinler, yorum sayısının altında ancak giriş durumu metninin üzerinde görüntülenebilir.

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

Specifying Header HTML

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:

Specifying Header HTML

Varsayılan olarak, FastComments bağlantıları şu şekilde gösterir: https://exmaple.com - burada bağlantı URL'si tıklanabilir HTML bağlantı etiketi olur.

Bazı siteler bunu devre dışı bırakmak isteyebilir; örneğin dolandırıcıları caydırmak için. Bunu, Comment HTML Rendering Option öğesini 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:

Render Links as Text

Varsayılan olarak, FastComments yorum giriş kutusunu ve yorum dizisini aynı anda gösterir. Dikey alandan tasarruf etmek için, widget ile etkileşim olana kadar diğer gerekli alanları da gizler.

Bununla birlikte, yorum widget'ı örneğin bir düğmenin arkasına gizlenebilir:

Click to Show Comments

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

Click to Show or Hide Comments

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ın yerine geçecek şekilde tasarlanmıştır.

Sayaç, yorum dizisiyle birlikte canlı olarak güncellenir. Hiç yorum yoksa düğme gösterilmez.

Bu, bir özelleştirme kuralı oluşturarak ve "Yorumları Göstermek İçin Tıklayın" seçeneğini etkinleştirerek kod olmadan etkinleştirilebilir:

Enable Click to Show Comments

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

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

Customizing The Comment Count Text

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 gerektirmeden, widget özelleştirme sayfasında özelleştirilebilir:

Customizing The Comment Count Text

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

Bazı durumlarda bu özelliği devre dışı bırakmak veya API üzerinden hangi hashtag'lerin kullanılabileceğini kontrol etmek isteyebilirsiniz.

Bunu yapmak için, Widget Özelleştirme UI üzerinden Disable Automatic #hashtag Creation öğesini etkinleştirin.

Disabling Automatic HashTag Creation

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

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

• Kullanıcı size yanıt verdi.
• Kullanıcı, yorum yaptığınız bir başlıkta yanıt verdi.
• Kullanıcı yorumunuza oy verdi.
• Kullanıcı, abone olduğunuz bir sayfaya yanıt verdi.

Bildirim zili ayrıca bir sayfaya abone olma mekanizması da sağlar.

Ancak, bildirim zilini tamamen devre dışı bırakabiliriz:

Disable Notification Bell

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 kod olmadan da yapılabilir. Widget özelleştirme sayfasında, "Bildirim Zilini Devre Dışı Bırak" bölümüne bakın.

Disable Notification Bell

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

Ancak bu işlevselliği devre dışı bırakabiliriz:

Disable Profiles

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, kod kullanmadan da yapılabilir. Widget özelleştirme sayfasında "Profilleri Devre Dışı Bırak" bölümüne bakın.

Disable Profiles

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

Disable Success Message

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 ayrıca kod olmadan da yapılabilir. Widget özelleştirme sayfasında:

Disable Success Message

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

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

Bu kodda veya kullanıcı arayüzü üzerinden ayarlanabilir. Kodda şu şekilde yapabiliriz:

Set Gif Rating

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

Kullanıcı arayüzünde, Gif Picker Rating altında bulacaksınız; ancak Disable Image Uploads? işaretli olmadıkça.

Setting The Gif Rating

Varsayılan olarak, FastComments yorum widget'ında görsel içerik moderasyonu off durumundadır.

Mevcut seçenekler off, low, medium ve high'dir.

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

Setting The Image Content Moderation Level

Varsayılan olarak, FastComments oy seçeneklerini yukarı ve aşağı oklar olarak render eder; kullanıcıların bir yorumu ya yukarı ya da aşağı oylamasına olanak tanır.

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 tarzı bir oylama mekanizmasını kullanmaktır.

Aşağıdaki gibi voteStyle bayrağını kullanıyoruz:

Enable Heart Button

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 sunucu tarafı doğrulamaları da etkinleştirdiği için kodsuz yapmanızı şiddetle öneriyoruz. Widget özelleştirme sayfasında "Vote Style" bölümüne bakın.

Change Voting Style

Oylama ayrıca devre dışı bırakılabilir, stil seçeneklerinin yukarısında Disable Voting bölümüne bakın.

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

Ancak bu engellenebilir.

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

Disable Comment Deleting

• Bu yalnızca normal yorum yapan kullanıcıları etkiler; moderatörler veya yöneticiler etkilenmez, onlar yine de silebileceklerdir.
• Bu, contextUserId iletildiğinde API entegrasyonlarını da etkileyecektir.

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

Ancak, bu engellenebilir.

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

Disable Comment Editing

• Bu yalnızca normal Commenters kullanıcılarını etkiler; moderators veya admins ise yine düzenleyebilecektir.
• Bu, contextUserId iletildiğinde API entegrasyonlarını da etkileyecektir.

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

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

Sayfa boyutunu değiştirmek hesaplarınızdaki tüm yorum dizilerinin yeniden hesaplanmasını gerektirir. Bu birkaç dakika sürebilir.

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

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

Custom Page Sizes

Sayfa boyutları, farklı özelleştirme kuralları oluşturarak genel olarak, alan bazında veya sayfa bazında özelleştirilebilir.

Bu, platformumuz aracılığıyla yorumları göstermek için kullanıyor olabileceğiniz tüm istemcileri, entegrasyonları ve çerçeveleri etkileyecektir.

Varsayılan olarak, FastComments kullanıcının adı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ı şekilde göstermek isteyebilirsiniz. Örneğin, kullanıcının adı Allen Rex ise, belki yalnızca "Allen R." göstermek istersiniz.

Bu, kod yazmadan Widget Özelleştirme UI'sında Commenter Name Format adlı ayar altında yapılabilir:

Change Name Format

Mevcut biçimler şunlardır:

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

Bu değişikliğin etkisi hemen geçerlidir. Kullanıcılar, kendileri için yorum alanının üst kısmında yine tam kullanıcı adlarını görecekler, ancak yorumlarında değiştirilmiş kullanıcı adı gösterilecektir.

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

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

Disabling Image Uploads

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 kullanmadan widget özelleştirme sayfasında özelleştirilebilir:

Disabling Image Uploads

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

Ancak, bunu enableSearch bayrağını true olarak ayarlayarak etkinleştirebiliriz:

Enabling Search

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, kod kullanmadan da yapılabilir. Widget özelleştirme sayfasında "Arama Kutusunu Etkinleştir" seçeneğine bakın.

Enable Search Box

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

Enabling Spoilers

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 işlem kod kullanmadan da yapılabilir. Widget özelleştirme sayfasında "Spoilerleri Etkinleştir" seçeneğine bakın.

Enable Spoilers

Metin vurgulandığında ve artık görünen SPOILER düğmesine tıklandığında, kullanıcı fareyi üzerine getirmedikçe metin maskelenir. Karanlık mod için de aynı şeyi yapıyoruz, ancak karanlık moda daha iyi uyan farklı renkler kullanıyoruz.

Bu aynı zamanda WYSIWYG düzenleyici ile de uyumludur.

Varsayılan olarak FastComments, her yorumu kimin görüntülediğini izlemez veya bununla ilgili herhangi bir istatistik sağlamaz.

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

Bu gerçekleştiğinde, her yorumda gösterilen bir göz simgesinin yanındaki sayı artırılacaktır. 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:

Enabling Comment View Counts

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, widget özelleştirme sayfasında kod yazmadan özelleştirilebilir:

Enabling Comment View Counts

Yorumu görüntüleyen kullanıcı kimliğini* izliyoruz; böylece yorumu tekrar görüntülerseniz sayı artmaz. Yorumu iki yıl sonra tekrar görüntülerseniz, sayı yeniden artar.

• *Not: veya anonim oturum kimliği, veya kullanıcının IP'sinin hashlenmiş değeri.

Varsayılan olarak canlı yorumlama etkinleştirilmiştir. Bu, herhangi bir yorum eklendiğinde, silindiğinde, düzenlendiğinde veya sabitlendiğinde değişikliklerin görünmesi gerektiği anlamına gelir yorum dizisini aynı anda görüntüleyen tüm kullanıcılara.

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

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

Bu, sayfa boyutunun kullanıcının ekranında sürekli değişmesini önlemek içindir; bu, kaydırma çubuğunu yakalamaya çalışırken hayal kırıklığına neden olabilir.

Bazı kullanım durumları için, örneğin canlı teklif verme veya çevrimiçi etkinlikler gibi, bu istenen davranış değildir - yorum bileşeninin yeni yorumların "show right away" olduğu bir "chat" kutusuna daha çok benzemesini isteyebilirsiniz.

Bu özelliği etkinleştiren bayrağın adı şudur: showLiveRightAway.

Şu şekilde açabiliriz:

Show Live Comments Right Away

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, kod olmadan, bileşen özelleştirme sayfasında özelleştirilebilir:

Show Live Comments Right Away

Varsayılan olarak, FastComments'te canlı yorumlama etkinleştirilmiştir.

Bu, yorum dizisini görüntüleyen her kullanıcının aynı içeriği görmesi anlamına gelir.

Örneğin, bir yorum eklendiğinde, o yorum görünmelidir. Bir yorum düzenlenir veya kaldırılırsa, o yorumlar yorum dizisini görüntüleyen tüm kullanıcılar için düzenlenir veya kaldırılır. Oylar ve tüm moderasyon işlemleri için de aynı durum geçerlidir.

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 "Canlı Yorumlamayı Devre Dışı Bırak" bölümüne bakın.

Disable Live Commenting

Varsayılan olarak, FastComments yorumları "Most Relevant" sıralama yönüne göre sıralar.

Most Relevant sıralaması, yorumun bırakıldığı zamanı ve oy sayısını sıralama için dikkate alır.

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

Ancak varsayılanı bu üçünden herhangi biri olacak şekilde değiştirebiliriz. Örneğin, en eski yorumları ilk 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 yönü "OF" olacak şekilde "OF" olarak ayarlarız.

En Yeni İlk sıralama yönü için aşağıdakileri 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: "Most Recent"
• NF: "Newest First"
• OF: "Oldest First"

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

Changing The Default Sort Direction

Dikkat: Her sayfa için, her sıralama yönündeki yorumlar önceden hesaplanır; bu nedenle tüm sıralama yönleri aynı performansa sahiptir.

Varsayılan olarak yorum giriş alanı yorum dizisinin önünde yer alır. Ancak bu yapılandırma parametresini true olarak ayarlayarak bunu yorum dizisinin sonrasında 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 gerektirmeden widget özelleştirme sayfasında özelleştirilebilir:

Moving The Reply Box to The Bottom

Yorum giriş alanına girilebilecek maksimum karakter sayısı maxCommentCharacterLength parametresiyle sınırlandırılabilir.

Varsayılan değer 2000'dir.

Görüntü URL'leri gibi öğeler uzunluk hesaplamasına dahil edilmez.

Limit Comment Length

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, widget özelleştirme sayfasında kod gerektirmeden özelleştirilebilir:

Limit Comment Length

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

Ancak, kullanıcının yalnızca tek bir satır metin girmesiyle sınırlandırılması istenebilir. Örnek kullanım durumları arasında çevrimiçi teklif verme veya canlı sohbet bulunur; FastComments bu amaçlarla kullanılabilir.

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

Enable Single-Line Comment Input

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 kullanmadan da yapılabilir. Widget özelleştirme sayfasında, "Tek Satırlık Yorum Girişini Etkinleştir" bölümüne bakın.

Enable Single-Line Comment Input

Unutmayın ki, her sayfadaki yorumlar her sıralama yönü için önceden hesaplanır; bu nedenle tüm sıralama yönlerinin performansı aynıdır.

Varsayılan olarak, her kullanıcı aynı dakika içinde en fazla 5 comments gönderebilir.

Bu, user id, anon user id ve ip address (hashed) ile izlenir.

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

Limiting Comment Volume Per User

Unutmayın ki, comment creation API'yi kullanıyorsanız, istekte kullanıcının orijinal ip adresini backend'imize göndermek isteyebilirsiniz, böylece rate limiting uygulanır kullanıcı bazında ve hesabınıza genel olarak değil.

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

Ayrıca benzer SSO mekanizmalarına sahip diğer sağlayıcılardan geçişle ilgili bazı belgeler ve farklar bulunmaktadır.

Akış şu şekilde görünür:

Güvenli SSO Akışı

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

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

FastComments SSO ile herhangi bir yeni API uç noktası yazmanız gerekmez. Kullanıcının bilgilerini gizli anahtarınızı kullanarak şifreleyin ve yükü yorum widget'ına iletin.

API Gizli Anahtarınızı Alın

API Gizli Anahtarınız bu sayfadan alınabilir. Bu sayfayı ayrıca My Account'a giderek, API/SSO kutucuğuna tıklayarak ve ardından "Get API Secret Key"e tıklayarak da bulabilirsiniz.

Yorum Widget Parametreleri

Yorum widget'ı için üst düzey API dokümantasyonu burada bulunabilir.

Bu parametrelerin ne anlama geldiğini daha ayrıntılı inceleyelim.

Yorum widget'ı bir yapılandırma nesnesi alır - FastComments kullanıyorsanız zaten müşteri kimliğinizi (tenantId olarak adlandırılır) geçirmek için bunu sağlıyorsunuz.

SSO'yu etkinleştirmek için, sunucu tarafında oluşturulması gereken aşağıdaki parametrelere sahip yeni bir "sso" nesnesi geçin.

• userDataJSONBase64: Kullanıcının JSON formatındaki verileri, daha sonra Base64 ile kodlanmış halde.
• verificationHash: UNIX_TIME_MILLIS + userDataJSONBase64'den oluşturulan HMAC-SHA256 hash.
• timestamp: Epoch zaman damgası, milisaniye cinsinden. Gelecekte olmamalı veya iki günden fazla geçmiş olmamalı.
• loginURL: Yorum widget'ının kullanıcıyı oturum açması için gösterebileceği bir URL.
• logoutURL: Yorum widget'ının kullanıcıyı oturum kapatması için gösterebileceği bir URL.
• loginCallback: Giriş URL'si yerine sağlandığında, yorum widget'ının giriş düğmesine tıklandığında çağıracağı bir fonksiyon.
• logoutCallback: Çıkış URL'si yerine sağlandığında, yorum widget'ının çıkış düğmesine tıklandığında çağıracağı bir fonksiyon.

Secure SSO Client Code

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": 1768890095030,

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

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

13 }

14}];

15</script>

16

The User Object

The User object contains the following schema:

Kullanıcı Nesnesi

Copy

1

2interface SSOUser {

3 /** Zorunlu. Maksimum 1k karakter. **/

4 id: string;

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

6 email: string;

7 /** Zorunlu. Maksimum 1k karakter. Not: Kullanıcı adı bir e-posta olamaz. Benzersiz olması gerekmez. **/

8 username: string;

9 /** İsteğe bağlı. URL'ler için maksimum 3k karakter. Varsayılan, e-posta bazlı gravatardan alınır. 64 kodlu (Base64) resimleri 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ı. Maksimum 100 karakter. Bu etiket isimlerinin yanında gösterilecektir. Uygun olduğunda varsayılan Administrator/Moderator'dür. **/

16 displayLabel?: string;

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

18 displayName?: string;

19 /** İsteğe bağlı. Maksimum 2k karakter. Kullanıcının adı buraya bağlantı verilir. **/

20 websiteUrl?: string;

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

22 groupIds?: string[];

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

24 isAdmin?: boolean;

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

26 isModerator?: boolean;

27 /** İsteğe bağlı, varsayılan true. Kullanıcının profilindeki "etkinlik" 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}

34

Moderators and Administrators

For admins and moderators, pass the respective isAdmin or isModerator flags in the SSOUser object.

Notifications

To enable or disable notifications, set the value of optedInNotifications to true or false respectively. The first time the user loads the page with this value in the SSO payload, their notification settings will be updated.

Additionally, if you want users to receive notification emails for activity on pages they subscribed to (as opposed to just in-app notifications), then set optedInSubscriptionNotifications to true.

VIP Users & Special Labels

You can display a special label next to the user's name by using the optional "displayLabel" field.

Unauthenticated users

To represent an unauthenticated user, simply do not populate userDataJSONBase64, verificationHash, or timestamp. Provide a loginURL.

These users will not be able to comment, and instead will be presented with a login message (message, link, or button, depending on configuration).

Direct Examples for Serializing and Hashing User Data

More details as an examples here (js), here (java) and here (php).

We understand that any integration can be a complicated and painful process. Don't hesitate to reach out to your representative or use the support page.

FastComments SSO (ayrıntılar burada) kullanıcılarınıza başka bir platforma giriş yapmadan yorum yapma imkanı sağlar.

Ancak bu tek başına yorum dizilerinizi güvence altına almaz, çünkü varsayılan olarak yorum verileri herkese açık bilgidir - 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ınmasına izin verecek şekilde sınırlandırabiliriz.

Kod Gerektirmeyen Kurulum

SSO kurulduğunda yorum dizilerimizin görüntülenmesini ve etkileşimde bulunulmasını engellemek için bir özelleştirme kuralı oluşturabiliriz.

Bunu yaparken SSO'yu arayın ve şu seçeneği bulacaksınız:

Require SSO To View Comments

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

Yalnızca Belirli Bir Alan Adı veya Sayfayı Korumak

Yalnızca belirli bir Domain veya Sayfayı korumak için özelleştirme kuralını buna göre yapılandırmamız yeterlidir.

Özelleştirme arayüzünün üst kısmında iki girdi alanı bulacaksınız: Domain ve URL ID.

Sadece belirli bir domaini korumak için ilgili domaini "domain" alanına girin.

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

Güvenlik Düzeyleri

SSO gerekli olduğunda Simple SSO mu yoksa Secure SSO mu istediğinize karar vermelisiniz. Simple SSO'yu seçerseniz her iki yöntem de kabul edilir; ancak Secure SSO'yu seçerseniz içeriğin görüntülenebilmesi için API key'inizle hash'lenmiş bir Secure SSO yükü ile getirilmesi gerekir.

Güvenlik düzeyi seçeneği, "Require SSO To View Comments" seçeneğini seçtiğinizde görünecektir.

Okumanın Ötesinde Koruma

Bu seçeneği etkinleştirmek, kullanıcı SSO ile giriş yapmadıkça sayfanın veya domainin yorum yapılmasına karşı korunmasını sağlar.

Uyarılar

SSO entegrasyonunuzdan önce yorum oluşturan kullanıcılar, SSO entegrasyonunuz aracılığıyla giriş yapmadıkça bunları göremeyeceklerdir.

Varsayılan olarak, FastComments yorum yapmak için bir e-posta gerektirecektir. Bu geçerli bir e-posta olmak zorunda değildir; ancak kullanıcı kendisine gönderilen bağlantıya tıklayana kadar, yorumlarının üzerinde "Doğrulanmamış Yorum" etiketi gösterilecektir.

Ancak e-posta gereksinimini kaldırabiliriz. E-posta giriş alanı yine de görünecektir, ancak artık zorunlu olmayacaktır.

Bu, widget özelleştirme kullanıcı arayüzü üzerinden yapılandırılabilir:

Enabling Anonymous Comments

FastComments, belirlenen 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, yapılmaz.

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

Moderation Settings

Kullanıcılar yorum yaptığında ve oturum açmamışlarsa, e-postalarını sağlamaları istenir.

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

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

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

Disable Email Inputs

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

Not: Bu yapılandırmayla, kullanıcı bir hesap oluşturup ve oturum açmadıkça tüm yorumlar doğrulanmamış olacaktır. https://fastcomments.com

Şunu düşünmek isteyebilirsiniz: doğrulanmamış etiketini devre dışı bırakmayı.

Varsayılan olarak, FastComments, doğrulanmamış bir tarayıcı oturumuna sahip bir kullanıcı için bırakılan yorumlarda "Unverified Comment" etiketini gösterir. Doğrulanmamış yorumlar hakkında daha fazla bilgiyi buradan okuyun.

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

Additionally, this feature can be used, without writing code, in the Customization UI:

Disable The Unverified Label

Kullanıcılar bir yoruma oy vermeye çalıştıklarında ve giriş yapmamışlarsa, kullanıcı adlarını ve e-posta adreslerini sağlamaları istenir.

Bu gereksinimi kaldırabiliriz; böylece herkes herhangi bir bilgi bırakmadan bir yoruma oy verebilir.

Allow Anonymous Votes

Kullanıcılar yorum yaptıklarında veya oy verdiklerinde ve oturum açmamışlarsa, e-posta adreslerini ve kullanıcı adlarını sağlamaları istenir.

Anonim yorum yapma durumunda, bazen yorum yaparken yaşanan sürtüşmeyi azaltmak için varsayılan bir kullanıcı adı tanımlamak isteyebilirsiniz. Bu, Özelleştirme UI'si üzerinden yapılabilir. Anonim Yorumlama önce etkinleştirilmelidir.

Setting The Default Username

Varsayılan olarak, FastComments yorum bileşenini kullanıcının sistem ve tarayıcısı tarafından belirlenen yerel ayara (locale) göre gösterir.

Bir kullanıcı yorum yaptığında veya giriş yaptığında, son kullandıkları locale bilgisini güncelliyoruz ve e-postaları gönderirken bunu kullanıyoruz.

Bu, yorum bileşeninin kullanıcı için nasıl çevrileceğini etkiler. Locale, kullanıcının dil ve bölgesinden oluşur; bu yüzden locale'i yapılandırmak genellikle kullanıcıya gösterilen metnin dilini değiştirir.

Arayüz Üzerinden

Bu, bileşen özelleştirme kullanıcı arayüzü kullanılarak tanımlanabilir. "Yerel Ayar / Dil" seçeneğine bakın:

Changing The Locale / Language

Kod ile

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

Manually Defining the User's Locale

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 ve karşılık gelen locale kodlarının tam listesini burada bulabilirsiniz.

SSO Notu

SSO kullanıyorsanız, e-postaların ve diğer öğelerin kullanıcı için doğru şekilde yerelleştirilmesini sağlamak üzere kullanıcının locale bilgisini kullanıcı nesnesinde iletmek isteyebilirsiniz.

Varsayılan olarak FastComments, yorum yaparken kullanılan dilleri kısıtlamaz.

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

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

Allowed Languages

Sistem, yorumu ayrıştırır ve dilini belirler, ardından izin verilen listeyle eşleştirir.

Yorum izin verilmeyen bir dilde yazıldıysa, yerelleştirilmiş bir hata mesajı gösterilir.

readonly bayrağı true olarak ayarlandığında yorum yapma kilitlenebilir, böylece yeni yorumlar veya oylar bırakılamaz.

Yorumlar ayrıca düzenlenemeyecek veya silinemeyecek.

Making The Comment Thread Readonly

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, tüm bir alan adı veya sayfa için, kod olmadan widget özelleştirme sayfasında özelleştirilebilir:

Making The Comment Thread Readonly

Güncelleme!

Kasım 2022 itibarıyla, yorum dizileri 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ı engeller; yine de oy vermeye ve kullanıcıların istedikleri takdirde yorumlarını silmelerine izin verir; oysa readonly bunlara izin vermez.

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

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

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

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

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

Restrict External Link Domains

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

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

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

Enabling Commenter Links

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

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

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

Enabling Commenter Links

Moderasyon Grupları sayfasından oluşturulan kimliklerin bir listesi.

Belirtildiğinde, belirtilen yapılandırma kullanılarak bırakılan yorumlar aynı moderationGroupIds kümesini içerecektir.

Eğer bir Moderator için bir veya daha fazla Moderasyon Grubu tanımlanmışsa, o kişi yalnızca grup(ları) ile ilişkili Moderate Comments sayfasındaki yorumları görecektir.

Specify Moderation Groups

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 çerezlerinin etkin olmasına bağlıdır. Bunlar olmadan, kullanıcılar her zaman e-posta bırakmak zorunda kalmaktadır yorum yapmak için (e-posta giriş alanı gizlenmedikçe) ve yorumları her zaman doğrulanmamış olarak görünecektir (varsayılan olarak).

Bunun üstesinden gelmek için üçüncü taraf çerez atlamasını etkinleştirebilirsiniz.

Bu ayar etkinleştirildiğinde, kullanıcının giriş yapıldığına dair bir mesaj gösteren küçük bir açılır pencere oluşturur. Bu açılır pencere kullanıcı yorum bileşeniyle etkileşime girdiği her seferde gösterilir; örneğin, bir yorum bıraktığında.

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

Enabling Third-Party Cookie Bypass

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 üzerinden, Enable Third-Party Cookie Popup altında da ayarlayabilirsiniz:

Enabling Third-Party Cookie Bypass

Varsayılan olarak kullanıcılar kendi yorumlarını silebilir. Ayrıca, bir yorumu silmek dizideki tüm alt ve geçici yorumları otomatik olarak siler. Bu davranış aynı zamanda canlı ortamda da geçerlidir.

Bunu şu şekillerde kısıtlayabilirsiniz:

• Bunun yerine, silinen yorumu anonimleştirin (isim ve metni [deleted] veya özel bir değere ayarlayın).
• Yanıtlar varsa yorumların silinmesine izin vermeyin. Özelleştirilebilir bir hata mesajı gösterilir.
• Bir yorumun yanıtları olduğunda silme işlemini yalnızca yöneticiler ve moderatörlerle sınırlayın.

Bu, Widget Özelleştirme UI'daki Comment Thread Deletion bölümünden yapılandırılabilir.

Customize Delete Behavior for Replies

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 adlarının yanına gösterebiliriz:

Show Badges in Top Bar Option

Bu, kullanıcının rozetlerini adının yanında üst çubuk alanında görüntüleyerek yorum yazarken başarılarını ve durumunu daha belirgin hale getirir.

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

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