Drupal Sitelerine Canlı Yorum Ekle

Bu, Drupal talimatlarının "çok uzun; okumadım" sürümüdür.

1. Modülü composer require drupal/fcom ile yükleyin veya modules/custom/fastcomments/ dizinine koyun.
2. drush en fastcomments ile etkinleştirin veya yönetici arayüzünden /admin/modules üzerinden etkinleştirin.
3. Administration > Configuration > Content > FastComments (/admin/config/content/fastcomments) adresine gidin.
4. Tenant ID ve API Secret bilgilerinizi Ayarlar > API/SSO sayfasından girin (EU).
5. Herhangi bir içerik türüne FastComments alanını Structure > Content types > [type] > Manage fields üzerinden ekleyin.

Modül drupal.org/project/fcom adresinde yayınlanmıştır.

All settings live under Administration > Configuration > Content > FastComments (/admin/config/content/fastcomments).

Gerekli

• Tenant ID - FastComments Kiracı Kimliğiniz. Bunu Settings > API/SSO altında bulun (EU).
• API Secret - Güvenli SSO, webhook doğrulaması ve sayfa senkronizasyonu için gereklidir. Settings > API/SSO altında bulunur (EU).

API Gizli Anahtarını Saklama

Modül, API Gizli Anahtarını değer içeren bu kaynaklardan ilkinden okur:

1. Key module - Key kurun, bir Authentication anahtarı oluşturun ve ayar formundaki API Secret key altında seçin. Anahtar bir ortam değişkeni veya web kökünün dışındaki bir dosya ile desteklenebilir.
2. settings.php - $config['fastcomments.settings']['api_secret'] = 'your-secret'; satırını settings.php veya settings.local.php dosyasına ekleyin. Gizli anahtar hiçbir zaman dışa aktarılan yapılandırmaya girmez.
3. The settings form - API Secret alanına girin. Bu, değeri fastcomments.settings içinde saklar, böylece yapılandırma dışa aktarımlarına dahil olur. Drupal durum raporu, bu kaynağın aktif olduğunda uyarı verir.

Form, hangi kaynağın aktif olduğunu gösterir. Alanı boş bırakarak saklanan gizli anahtar korunur. Gizli anahtarı Key modülüne veya settings.php'ye taşıdıktan sonra silmek için Yapılandırmada saklanan API Gizli Anahtarını Kaldır kutusunu işaretleyin.

Yorumlama Stili

Sitenizde insanların nasıl konuşmasını istediğinize uygun widget'ı seçin.

• Live Comments - Gerçek zamanlı dallı yorumlar.
• Streaming Chat - Canlı sohbet arayüzü, etkinlikler ve canlı yayınlar için uygundur.
• Collab Chat - Ana içerik alanında metin seçimiyle açıklama. Ziyaretçiler metni vurgular ve bağlam içinde bir tartışma başlatır.
• Collab Chat + Comments - Aynı sayfada hem işbirliği sohbeti hem de standart yorumlar.

SSO Modu

• None - SSO yok. Kullanıcılar misafir olarak yorum yapar veya bir FastComments hesabı oluşturur.
• Simple - Drupal kullanıcı bilgilerini (ad, e-posta, avatar) FastComments'a sunucu tarafı doğrulama olmadan gönderir.
• Secure - Drupal kullanıcılarını FastComments ile doğrulamak için HMAC‑SHA256 kullanır. API Gizli Anahtarı yapılandırılmışsa önerilir.

Ayrıntılar için Single Sign-On (SSO) bölümüne bakın.

Diğer Ayarlar

• CDN URL - Varsayılan olarak https://cdn.fastcomments.com adresidir.
• Site URL - Varsayılan olarak https://fastcomments.com adresidir.
• Email notifications - Yeni bir yorum içeriklerine gönderildiğinde içerik yazarına e-posta gönderilir.

AB veri konumlandırması için EU Data Residency bölümüne bakın.

FastComments, SSO (tek oturum açma) aracılığıyla Drupal'ın kullanıcı sistemiyle bütünleşir. Kullanıcılarınız Drupal sitenize giriş yapar ve modül onların kimliğini FastComments'a otomatik olarak iletir. Ek hesap oluşturmanıza veya başlangıç senkronizasyonu çalıştırmanıza gerek yoktur.

The module supports three SSO modes, set under Administration > Configuration > Content > FastComments.

Yok

SSO yok. Kullanıcılar misafir olarak yorum yapar veya bir FastComments hesabı oluşturur. Siteniz herkese açıksa ve yorumları Drupal kullanıcılarına bağlamanız gerekmiyorsa bunu kullanın.

Basit

Drupal kullanıcısının adını, e-postasını ve avatarını sunucu tarafı doğrulaması olmadan FastComments'a aktarır. API Secret gerekmez. Dahili veya düşük riskli siteler için uygundur.

Güvenli (önerilir)

Her kullanıcı kimliğini FastComments ile doğrulamak için HMAC-SHA256 kullanır. API Secret yapılandırıldığında tercih etmeniz gereken mod budur ve bir ziyaretçinin başka bir kullanıcının kimliğine bürünmesini engelleyen tek moddur.

Kullanıcı kimliği, bir kullanıcı yorum dizisini her görüntülediğinde FastComments'a iletilir. Çalıştırılması gereken bir başlangıç veya sürekli senkronizasyon yoktur.

^{(İsteğe bağlı)} Yöneticilerinizi Kullanıcılar ve Yöneticiler bölümüne ve moderatörleri Yorum Moderatörleri bölümüne ekleyin; bu, deneyimlerini iyileştirir ve moderatörler için istatistik takibini etkinleştirir.

SSO'nin nasıl çalıştığına dair daha detaylı bilgi için özelleştirme belgelerinin SSO bölümü'ne bakın.

• Drupal 10 veya 11
• PHP 8.1 veya daha yeni
• Bir FastComments hesabı

Modül başka herhangi bir Drupal modülüne veya üçüncü taraf kütüphaneye ihtiyaç duymaz. Sadece Drupal çekirdeğine (user, field) bağlıdır.

Bir <noscript> yedeği, JavaScript olmayan ziyaretçiler için sunucu tarafından oluşturulmuş yorumlar sağlar; böylece Live Comments ve Streaming Chat, betikler devre dışı bırakılmış tarayıcılarda hâlâ çalışır.

FastComments sitenizde Drupal üzerine kurulduğunda, yorumlarda doğrudan canlı anketler de çalıştırabilirsiniz. Widget özelleştirme ayarlarınızda Enable Polls seçeneğini etkinleştirin ve yorum araç çubuğunda bir anket düğmesi görünür. Anketler 2 ile 10 seçenek alabilir, sonuçlar sayfadaki herkes için canlı olarak güncellenir ve kimlerin anket oluşturabileceğini ve oy vermenin oturum açmayı gerektirip gerektirmeyeceğini seçebilirsiniz. Drupal üzerinde başka bir şey kurmanıza gerek yok.

Canlı Anket demo'sını deneyin veya kurulum için Anket belgelerini okuyun.