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

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 UI'si.

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:

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

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.

Dikkat Edilmesi Gerekenler

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

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

Ancak, widget özelleştirme UI'sı üzerinden daha kolay bir yol vardır. Orada, EN_US yerel ayarında yorum widget'ı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.

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.

By default, FastComments will show the user's name as they entered it, or how it was passed to us via SSO.

However, it may be desirable to mask or show the user's name in a different way. For example, if the user's name is Allen Rex, maybe you want to only show "Allen R.".

This can be done without code in the Widget Customization UI, under the setting called Commenter Name Format:

İsim Biçimini Değiştir

The available formats are:

• Capitalize (display example user as Example User)
• Last Initial (display Example User as Example U.)
• All Initials (display Example User as E. U.)
• Show "Anonymous"

The effect of changing this is immediate. User's will still see their full username at the top of the comment area, for themselves, but their comments will show the modified username.

Usernames are masked server-side to protect users.

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 izlemez veya bununla ilgili istatistikler sağlamaz.

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.

Bu özelliği 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 yazmadan 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* izliyoruz, böylece yorumu tekrar görüntülerseniz sayı artmaz. Yorumu iki yıl sonra tekrar görüntülerseniz, sayı daha fazla 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 yapanların bir yorum göndermeden önce Hizmet Şartlarınızı kabul etmelerini zorunlu kılmanıza olanak tanır.

Etkinleştirildiğinde:

• Anonim kullanıcılar her yorum yaptıklarında bir TOS onay kutusu göreceklerdir
• Kimliği doğrulanmış kullanıcılar yalnızca ilk yorumlarında veya Hizmet Şartlarınızı güncellediğinizde onay kutusunu göreceklerdir

Configuration

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 "Hizmet Şartları ve Gizlilik Politikasını kabul ediyorum" metnini her iki belgeye bağlantılarla gösterir. Her dil için kendi metninizi sağlamak üzere "Yerel bazında metni özelleştir" seçeneğini seçin.
• TOS Son Güncelleme Tarihi: Hizmet Şartlarınızı güncellediğinizde bu tarihi ayarlayın. Bu tarihten önce kabul eden kullanıcıların tekrar kabul etmeleri gerekecektir.

How It Works

• TOS kabul zaman damgası kullanıcı başına ve yorum başına depolanır
• Bir kullanıcı TOS'u kabul ettiğinde, tarih kullanıcı profiline (per-tenant) kaydedilir
• Kullanıcının kabul tarihinden sonra bir "Last Updated" tarihi belirlerseniz, yeniden kabul etmeleri gerekir
• İzlenemeyen anonim kullanıcılar için, onay kutusu her yorum gönderiminde görünür

FastComments Secure SSO, SSO'yu uygulamak için mekanizma olarak HMAC-SHA256 şifrelemesini kullanır. Önce genel mimariyi, örnekleri ve ayrıntılı adımları inceleyeceğiz.

Benzer SSO mekanizmalarına sahip diğer sağlayıcılardan geçişle ve farklarla ilgili bazı belgeler de bulunmaktadır.

The flow looks like this:

Secure SSO Flow

Since Secure SSO involves full-stack development, full working code examples in Java/Spring, NodeJS/Express, and vanilla PHP are currently GitHub'da.

Although we use ExpressJS in the NodeJS example and Spring in the Java example there are no frameworks/libraries required in these run-times to implement FastComments SSO - the native crypto packages work.

You don't have to write any new API endpoints with FastComments SSO. Simply encrypt the user's info using your secret key and pass the payload to the comment widget.

API Gizli Anahtarınızı Alın

Your API Secret can be retrieved from this page. You can find this page also by going to My Account, clicking the API/SSO tile, and then clicking "Get API Secret Key".

Yorum Bileşeni Parametreleri

High-level API documentation for the comment widget can be found burada.

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

The comment widget takes a configuration object - you already pass this if you're using FastComments to pass your customer id (called tenantId).

To enable SSO, pass a new "sso" object, which must have the following parameters. The values should be generated server side.

• userDataJSONBase64: The user's data in JSON format, which is then Base64 encoded.
• verificationHash: The HMAC-SHA256 hash created from UNIX_TIME_MILLIS + userDataJSONBase64.
• timestamp: Epoch timestamp, in milliseconds. Must not be in the future, or more than two days in the past.
• loginURL: A URL that the comment widget can show to log the user in.
• logoutURL: A URL that the comment widget can show to log the user out.
• loginCallback: When provided instead of the login URL, a function that the comment widget will invoke when clicking the login button.
• logoutCallback: When provided instead of the logout URL, a function that the comment widget will invoke when clicking the logout button.

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": 1787115343452.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 aşağıdaki şemayı içerir:

Kullanıcı Nesnesi

Copy

1

2interface SSOUser {

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

4 id: string;

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

6 email: string;

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

8 username: string;

9 /** Opsiyonel. URL'ler için maksimum 3k karakter. Varsayılan, e-postaya dayalı gravatar'dandır. 64 ile kodlanmış resimleri destekler; bu durumda limit 50k karakterdir. **/

10 avatar?: string;

11 /** Opsiyonel. Varsayılan false. **/

12 optedInNotifications?: boolean;

13 /** Opsiyonel. Varsayılan false. **/

14 optedInSubscriptionNotifications?: boolean;

15 /** Opsiyonel. Maksimum 100 karakter. Bu etiket isimlerinin yanında gösterilecektir. Uygulanabilir olduğunda varsayılan Yönetici/Moderatör'dür. **/

16 displayLabel?: string;

17 /** Opsiyonel. Maksimum 500 karakter. Bu, kullanıcı adı yerine gösterilecektir. **/

18 displayName?: string;

19 /** Opsiyonel. Maksimum 2k karakter. Kullanıcının adı buraya bağlanacaktır. **/

20 websiteUrl?: string;

21 /** Opsiyonel. Kullanıcı başına 100 gruba kadar. Bir grup kimliği 50 karakterden uzun olamaz. **/

22 groupIds?: string[];

23 /** Opsiyonel. Kullanıcıyı yönetici olarak belirtir. **/

24 isAdmin?: boolean;

25 /** Opsiyonel. Kullanıcıyı moderatör olarak belirtir. **/

26 isModerator?: boolean;

27 /** Opsiyonel, varsayılan true. Kullanıcının profilindeki "activity" sekmesini etkinleştirmek için false olarak ayarlayın. **/

28 isProfileActivityPrivate?: boolean;

29 /** Opsiyonel, varsayılan false. Profil yorumlarını devre dışı bırakmak için true olarak ayarlayın. **/

30 isProfileCommentsPrivate?: boolean;

31 /** Opsiyonel, 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 opsiyonel yapılandırma. **/

34 badgeConfig?: {

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

36 badgeIds: string[];

37 /** Geçerli sayfaya (urlId) özgü rozet kimlikleri dizisi. Yalnızca atandığı sayfada gösterilir. **/

38 pageBadgeIds?: string[];

39 /** True ise gösterilen mevcut rozetlerin yerini alır. Genel ve sayfa-açısına özgü rozetler bağımsız olarak üzerine yazılır. **/

40 override?: boolean;

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

42 update?: boolean;

43 };

44}

45

Moderatörler ve Yöneticiler

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

Bildirimler

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.

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

VIP Kullanıcılar ve Özel Etiketler

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

Kimlik Doğrulanmamış kullanıcılar

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

Kullanıcı Verilerinin Seri Haline Getirilmesi ve Hash'lenmesi için Doğrudan Örnekler

Daha fazla ayrıntı örnekleri js için burada, java için burada ve php için burada.

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

FastComments SSO (detaylar burada) kullanıcılarınıza başka bir platforma giriş yapmadan yorum yapma imkanı sunar.

Ancak, bu tek başına yorum dizilerinizi güvenli hale getirmez, çünkü varsayılan olarak yorum verileri herkese açık bir bilgi olarak sunulur - sayfayı görebilen 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ını kısıtlayabiliriz.

Kod Olmadan Kurulum

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

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

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

Bunu etkinleştirin ve özelleştirme kuralını kaydedin.

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

Yalnızca belirli bir alan adı 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 iki giriş alanı bulacağız: Domain ve URL ID.

Sadece 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, burada URL yerine bir kimlik türü girebilirsiniz.

Güvenlik Seviyeleri

SSO gerektirdiğinizde, Basit SSO mu yoksa Güvenli SSO mu istediğinize karar vermeniz gerekir. Basit SSO'yu seçerseniz, her ikisi de izin verilir, ancak Güvenli SSO'yu seçerseniz, içeriğin görüntülenebilmesi için API anahtarınızla hashlenmiş bir Güvenli SSO yüküyle alınması gerekir.

Güvenlik seviyesi seçeneği, "Yorumları Görüntülemek İçin SSO Gerektir" seçeneğini seçtiğinizde görünecektir.

Okumanın Ötesinde Koruma

Bu seçeneği etkinleştirmek, kullanıcı SSO üzerinden oturum açmadıkça sayfanın veya alan adının yorumlanmasını engelleyecektir.

Dikkat Edilmesi Gerekenler

SSO entegrasyonunuzdan önce yorum oluşturan kullanıcılar, SSO entegrasyonunuz üzerinden oturum açmadıkça bu yorumları göremezler.

Varsayılan olarak, FastComments yorum yapmak için bir e-posta gerektirir. E-posta geçerli olmak zorunda değildir, ancak kullanıcı kendisine gönderilen bağlantıya tıklayana kadar, yorumları "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

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ı

When users comment, and they are not logged in, they will be asked to provide their email.

This will create an "unverified session" for that user, and we will ask them to verify that session via email.

For some sites, or applications, it's desirable not to ask the user for their email when commenting or voting.

Enabling anonymous commenting makes the email input field optional. However, we can disable it completely. First, enable anonymous commenting, and then the option to disable the email input fields will appear.

E-posta Girişlerini Devre Dışı Bırak

With this on, the email fields will not show at all in all of our commenting products.

Note that, with this configuration, all comments will be unverified unless the user creates an account and logs into https://fastcomments.com.

You may want to consider 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 "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 kullandığında ve oturum açmamışlarsa, e-posta adreslerini ve kullanıcı adlarını girmeleri istenir.

Anonim yorumlama durumunda, bazen sürtünmeyi azaltmak için varsayılan bir kullanıcı adı tanımlamak istenir yorum yaparken. Bu, Özelleştirme UI'sinden yapılabilir. Anonim Yorumlama önce etkinleştirilmelidir.

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

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.

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.