
Dil 🇹🇷 Türkçe
Üçüncü Taraf Eklentileri
Özel Kurulumlar
Belgelerde Gömme
Bir Web Sitesine Yorum Ekleme
Kurulum
FastComments, web sitenize yorum eklemeyi kolaylaştırır; siteniz statik veya dinamik, açık veya koyu tema, halka açık veya dahili sayfalar olsun fark etmez. Kurulumu kolay olmalı ve her tür site veya web tabanlı uygulamaya uyarlanabilmelidir. Bu, birçok durumda ilave yapılandırma gerekmeden hemen canlı yorum yapabilmenizi sağlar.
WordPress 
WordPress sitenize yorum eklemek için WordPress eklentimizi burada bulabilirsiniz.
Eklentiyle ilgili eksiksiz kurulum kılavuzu ve dokümantasyon burada.
Bu eklenti canlı yorum yapmayı, SSO'yu ve kod gerektirmeyen kurulumu destekler. Yönetici sayfasındaki kurulum kılavuzunu izleyin eklentiyi yükledikten sonra. Kurulum kılavuzu, WordPress kurulumunuzu hesabınıza bağlamanız konusunda size rehberlik edecektir.
FastComments aracılığıyla WordPress eklentimiz üzerinden bırakılan herhangi bir yorum, WordPress kurulumunuza otomatik olarak geri senkronize edilebilir, böylece verileriniz üzerinde kontrolü elinizde tutarsınız. Bu, WordPress veritabanınızın boyutunu sınırlamak için kapatılabilir.
VanillaJS / HTML Kod Parçası 
The VanillaJS sürümü olan widget, web sitenize yorum eklemenin en basit yoludur; herhangi bir derleme sistemi veya sunucu tarafı kodu gerektirmez.
Yorumları sitenize eklemek için aşağıdaki kod parçasını herhangi bir sayfaya eklemeniz yeterlidir:
Run 
Aynı kod parçasını birçok sayfada kullanabilirsiniz; sayfa başına otomatik olarak ayrı bir konu oluşturur.
Birçok uygulamada "HTML Embed Code" seçeneği bulunur. Bunu seçin ve yukarıdaki kod parçasını yapıştırın.
Denemek için bir hesabınızın olması da gerekmiyor! Giriş yapmadıysanız yukarıdaki kod parçasında "tenantId: demo" görebilirsiniz. Bu durumda demo hesabı kullanılacaktır.
Widget'ı yapılandırma ile ilgili dokümantasyonu burada bulabilirsiniz.
FastComments widget'ının tüm sürümleri, çekirdek VanillaJS kütüphanesi etrafında sarma (wrapper) yapılarıdır. Bu, özellik eklememize ve sorunları tek bir yerde düzeltmemize olanak tanır — ve yapılan değişiklikler yorum widget'ının diğer varyantlarına otomatik olarak yansır.
Angular 
Angular ile oluşturulmuş bir siteye yorum eklemek için Angular kütüphanemizi NPM'de burada bulabilirsiniz.
FastComments Angular yorum bileşeni VanillaJS sürümüyle aynı tüm özellikleri destekler - canlı yorum, sso vb.
fastcomments-typescript'e ihtiyacınız olacak; bu bir eş bağımlılıktır. Lütfen bunun TypeScript derlemenize dahil edildiğinden emin olun. Gelecekte bu eş bağımlılık @types/fastcomments'e taşınacak ve bu kurulumu basitleştirecektir.

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

Daha sonra, FastCommentsModule'u uygulamanıza ekleyin:

Kullanım
Başlamak için demo tenant için bir yapılandırma (config) nesnesi geçiriyoruz:

Yapılandırma oldukça karmaşık hale gelebileceğinden, bir nesne referansı geçebiliriz:


Bileşen değişiklik algılama kullanır, bu yüzden yapılandırma nesnesinin herhangi bir özelliğini değiştirmek bileşenin yeniden yüklenmesine neden olacaktır.
Angular bileşeninin desteklediği yapılandırmayı burada bulabilirsiniz.
React 
React ile oluşturulmuş bir siteye yorum eklemek için React kütüphanemizi NPM üzerinde burada bulabilirsiniz.
FastComments React yorum widget'ı, VanillaJS sürümünün tüm özelliklerini destekler - canlı yorumlama, sso ve benzeri.



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

React bileşeninin desteklediği yapılandırmayı burada bulabilirsiniz.
React Native 
React Native uygulamanıza yorum eklemek için React Native kütüphanemizi NPM'de burada bulabilirsiniz.
FastComments React Native yorum widget'ı, VanillaJS olan ile aynı tüm özellikleri destekler - canlı yorum, sso ve benzeri.


Yapılandırma, fastcomments-react kütüphanesine kıyasla biraz farklı şekilde belirtilir:

Eğer AB'deyseniz, region parametresini ayarlamak isteyeceksiniz:

React Native bileşeninin desteklediği yapılandırmayı burada bulabilirsiniz.
Vue 
Vue ile oluşturulmuş web sitenize yorum eklemek için Vue kütüphanemizi NPM'de burada bulabilirsiniz.
Ayrıca, vue-next kütüphanesi NPM'de burada
Kaynak kodu GitHub'da bulunabilir.
FastComments Vue yorum bileşeni VanillaJS olanla aynı tüm özellikleri destekler - canlı yorum, sso ve benzeri.
Aşağıdaki talimatlar Vue 3 içindir çünkü bir süredir kullanımdadır, ancak FastComments ayrıca Vue 2'yi fastcomments-vue kütüphanesi aracılığıyla da destekler.



Eğer AB içindeyseniz, region değerini EU olarak ayarlamak isteyebilirsiniz:

fastcomments-vue ve fastcomments-vue-next kütüphaneleri, VanillaJS yorum bileşeniyle aynı yapılandırmayı destekler.
Vue bileşeninin desteklediği yapılandırmayı burada bulabilirsiniz.
Aynı Sayfada Birden Fazla Örnek 
Yorum widget'ının her örneği izole edilmiştir. Bu nedenle, FastComments doğası gereği sayfa başına birden fazla örneği veya aynı sohbet dizisini işaret eden birden fazla örneği destekler.
Örneğin VanillaJS kütüphanesi durumunda, yorum widget'ını farklı DOM düğümlerine bağlamanız yeterlidir. Sayfadaki geçerli diziyi güncellemek istiyorsanız, Sayfayı Yeniden Yüklemeden Yorum Dizilerini Değiştirme bölümüne bakın;
Birden Fazla Örnek Arasında Kimlik Doğrulama Durumunu Senkronize Etme
Kendi yorum dizisine sahip sık sorulan sorular listesi olan özel bir tek sayfa uygulaması örneğini inceleyelim.
Bu durumda, DOM'da aynı anda birden fazla FastComments örneğimiz var.
Bu sorun değil, ancak kullanıcı deneyimi için bazı zorluklar ortaya çıkarır.
Bu akışı düşünün:
- Kullanıcı, her biri kendi yorum widget'ına sahip sorular listesi olan bir sayfayı ziyaret eder.
- Kullanıcı kullanıcı adını ve e-postasını girer ve dizilerden birine bir soru bırakır.
- Sorusu olan başka bir SSS öğesi görürler.
- Tekrar yorum yapmaya giderler. E-postalarını ve kullanıcı adlarını tekrar girmek zorundalar mı?
Bu durumda, FastComments widget örnekleri arasında kimlik doğrulama durumunu sizin için senkronize eder. Dördüncü adımda, aynı sayfada kullanıcı adını ve e-postasını girdikleri için kullanıcı zaten geçici olarak kimlik doğrulaması yapmış olacaktır.
Yaygın Kullanım Senaryoları 
Canlı Yorumları Hemen Gösterme
Yorum bileşeni varsayılan olarak canlıdır, ancak sayfa içeriğinin kaymasını önlemek için canlı yorumlar bir "N Yeni Yorum Göster" düğmesinin altında görünür.
Bazı durumlarda, yeni yorumların bir düğmeye tıklamaya gerek kalmadan hemen gösterilmesi yine de istenebilir.
Bu durumda, burada belgelerini bulabileceğiniz showLiveRightAway bayrağını etkinleştirmek istersiniz.
Anonim Yorumlamaya İzin Verme (E-posta Gerektirmeme)
Varsayılan olarak, FastComments kullanıcının yorum yaparken bir e-posta bırakmasını ister.
Bu devre dışı bırakılabilir, talimatlar burada.
Ziyaretçileri bir kullanıcı adı seçme zahmetinden de kurtarmak için, FastComments her ziyaretçi için bir tane oluşturabilir.
Özel Stil Uygulama
Müşterilerimizin çoğu yorum bileşenine kendi stillerini uygular. Belgeleri burada bulabilirsiniz.
Aynı Yorumları Birden Fazla Alan Adında Gösterme
Aynı yorumları birden fazla sitede göstermek, FastComments'in kutudan çıktığı gibi desteklediği bir özelliktir. Bu konudaki belgelerimize bakın.
Mevcut Sayfayı Değiştirme
FastComments SPA'ları ve karmaşık uygulamaları destekler. Mevcut sayfayı değiştirmek kolaydır ve burada ele alınmıştır.
Yaygın Sorunların Hata Ayıklanması 
Sık karşılaştığımız bazı belirtiler ve yaygın çözümleri aşağıda bulabilirsiniz.
"This is a demo" Mesajı
Bu mesaj, widget kodunu ana sayfamızdan kopyaladığınızda görünür; ana sayfadaki kod demo kiracımızı (tenant) kullanır. Kendi kiracınızı kullanmak için widget kodunu buradan kopyalayın.
"FastComments cannot load on this domain" Hatası
FastComments, hesabınızla ilişkili isteklerin kimliğini doğrulamak için hangi alan adlarının size ait olduğunu bilmelidir. Bu hatayı nasıl çözeceğinizi görmek için dokümantasyonumuza göz atın (basitçe tam alt alan adı + alan adını hesabınıza ekleyin).
Bunun yalnızca deneme süresi bittikten sonra gerçekleşmesi gerektiğini unutmayın. Deneme süresi boyunca, yeni alan adlarından gelen istekler otomatik olarak hesabınıza eklenir.
Özel Kurulumlarda Taşınan Yorumların Görünmemesi
Genellikle bu, içe aktarılan yorumların bir Page ID değerine bağlı olması ve sizin bir URL iletmeniz (veya hiçbir değer iletmemeniz, bu durumda sayfa URL'si varsayılan olarak kullanılır) durumunda gerçekleşir.
Bunu, yorumlarınızı dışa aktararak ve URL ID sütununu (şu anda B sütunu) görüntüleyerek hata ayıklayabilirsiniz.
URL ID sütununda gördüğünüz değerlerin, widget yapılandırmasına urlId parametresi olarak ilettiğiniz değerlerle aynı olduğundan emin olun.
Daha fazla açıklama için Yorumların Sayfalara ve Makalelere Nasıl Bağlandığı dokümantasyonumuzu okumayı deneyin.
Her şey başarısız olursa, bize ulaşın.
Yorum Widget'ının Görünmemesi
Yorum widget'ı görünmüyorsa, hatalar için Chrome geliştirici konsolunu kontrol edin.
Çoğu yanlış yapılandırma durumunda, yorum widget'ı yükleyebilirse sayfada en azından bir hata gösterir. Hiçbir şey görmemek genellikle bir betik (scripting) hatasına işarettir.
İstenen Yapılandırmanın Beklendiği Gibi Çalışmaması
Yorum widget'ına hangi yapılandırmanın iletildiğini görmek için Chrome uzantımızı deneyin. Her şey başarısız olursa, Chrome uzantısının gösterdiklerinin ekran görüntüsünü alın ve bize ulaşın.
Aynı URL'de Farklı Hash Bang ile Yorumların Eksik Olması
Varsayılan olarak, FastComments yorumların saklandığı "bucket" için sayfa URL'sini kullanır. URL'leriniz #hashbang değerleri içeriyorsa ve bu #hashbang değerleri bir yorum dizisini tanımlayan tanımlayıcının parçası olmamalıysa, hash bang değerini basitçe yok sayabiliriz, örneğin:

Bu değişikliği yaptıktan sonra, mevcut yorumlar için bir taşıma (migration) işleminin gerçekleştirilmesi gerekeceğini unutmayın. Bunun için bize ulaşın.
URL Sorgu Parametrelerinin Widget'ı Etkilemesi
Varsayılan olarak, FastComments yorumların saklandığı "bucket" için sayfa URL'sini kullanır. URL'leriniz, bir yorum dizisini tanımlayan tanımlayıcının parçası olmaması gereken sorgu parametreleri içeriyorsa, bunları basitçe yok sayabiliriz, örneğin:

Bu değişikliği yaptıktan sonra, mevcut yorumlar için bir taşıma (migration) işleminin gerçekleştirilmesi gerekeceğini unutmayın. Bunun için bize ulaşın.
E-posta Alınamaması
FastComments olarak, e-postalarımızın teslimatını mümkün olduğunca güvenilir hale getirmek için çok çalışıyoruz. Ancak, bazı e-posta sağlayıcıları güvenilir teslimat için zorlu olarak bilinir. fastcomments.com'dan gelen mesajlar için spam klasörünüzü kontrol edin.
Bize ulaşırsanız, genellikle e-postalarımızı neden göremeyebileceğiniz konusunda daha fazla bilgi sağlayabiliriz.
Notion ve Google Sites 
Notion sayfalarınıza, Google Sites veya Nimbus Notes'a yorum eklemek mi istiyorsunuz? Size yardımcı oluyoruz.
Notion
Notion dokümanlarına yorum eklemek için, açıklayıcı videoya buradan bakın.
Google Sites
Google Sites de desteklenir ve işlem akışı benzerdir.
- Gömülecek bir konuşma oluşturun.
- Google Sitenizi düzenlerken,
Insert->Embedyolunu izleyin.By URLöğesini seçin. - Adım 1'den URL'yi yapıştırın.
Insert'e tıklayın. Tamam!
Nimbus Note
Bir Nimbus Note'a canlı yorum eklemek de desteklenir ve işlem akışı Notion ile benzerdir.
- Gömülecek bir konuşma oluşturun.
- Notunuzu düzenlerken, bir embed bloğu ekleyin.
- Gömülecek URL olarak Adım 1'deki URL'yi kullanın.
- Tamam!