Add Live Commenting to Drupal Sites
Hızlı Başlangıç 
Bu, Drupal talimatlarının "çok uzun; okumadım" sürümüdür.
- Modülü
composer require drupal/fcomile yükleyin veyamodules/custom/fastcomments/dizinine koyun. drush en fastcommentsile etkinleştirin veya yönetici arayüzünden/admin/modulesüzerinden etkinleştirin.Administration > Configuration > Content > FastComments(/admin/config/content/fastcomments) adresine gidin.- Tenant ID ve API Secret bilgilerinizi Ayarlar > API/SSO sayfasından girin (EU).
- Herhangi bir içerik türüne
FastCommentsalanınıStructure > Content types > [type] > Manage fieldsüzerinden ekleyin.
Modül drupal.org/project/fcom adresinde yayınlanmıştır.
Kurulum
FastComments Drupal modülü, Drupal'ın yerleşik yorum sistemini hızlı, gerçek zamanlı bir yorum sistemiyle değiştirir. Modül drupal.org'da yayımlandı ve Drupal 10 ile 11 ile çalışır.
Kurmanın iki yolu vardır.
Composer ile Kurulum
composer require drupal/fcom
drush en fastcommentsManuel Kurulum
Modülü drupal.org/project/fcom adresinden indirin ve sitenizin modules/custom/fastcomments/ dizinine yerleştirin. Ardından drush en fastcomments ile etkinleştirin veya yönetici arayüzünden Extend (/admin/modules) üzerinden etkinleştirin.
Not: Modül yalnızca Drupal çekirdeğine (user ve field) bağımlıdır. Başka Drupal modülleri veya kütüphaneler gerekli değildir.
Modül etkinleştirildikten sonra, Tenant ID ve API Secret'inizi ayarlamak için Configuration bölümüne gidin.
Yapılandırma
Tüm ayarlar Administration > Configuration > Content > FastComments (/admin/config/content/fastcomments) altında bulunur.
Gereksinimler
- Tenant ID - FastComments Tenant ID'niz. Bunu Settings > API/SSO (EU) altında bulun.
- API Secret - Secure SSO, webhook doğrulaması ve sayfa eşitleme için gereklidir. Settings > API/SSO (EU) altında bulunur.
Yorum Stili
Sitenizde insanların nasıl konuşmasını istediğinize uygun widget'i seçin.
- Live Comments - Gerçek zamanlı dallanmış yorumlar.
- Streaming Chat - Canlı sohbet arayüzü; etkinlikler ve canlı yayınlar için uygun.
- Collab Chat - Ana içerik alanında metin seçimine dayalı açıklama. Ziyaretçiler metni vurgular ve bağlam içinde tartışma başlatır.
- Collab Chat + Comments - Aynı sayfada hem collab chat 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 (isim, e-posta, avatar) sunucu tarafı doğrulama olmadan FastComments'a iletir.
- Secure - Drupal kullanıcılarını FastComments ile doğrulamak için HMAC-SHA256 kullanır. Bir API Secret yapılandırıldığında önerilir.
Detaylar için Single Sign-On (SSO) bölümüne bakın.
Diğer Ayarlar
- CDN URL - Varsayılan olarak
https://cdn.fastcomments.com. - Site URL - Varsayılan olarak
https://fastcomments.com. - Email notifications - Yeni bir yorum içeriğe eklendiğinde içerik yazarına e-posta gönderir.
EU veri yerleşimi için EU Data Residency bölümüne bakın.
Widget Blokları
Modül, Structure > Block layout (/admin/structure/block) üzerinden yerleştirebileceğiniz birkaç blok ile birlikte gelir.
- FastComments Widget - Ana yorum widget'ı. Mevcut varlığı otomatik algılar. FastComments alanı zaten eklenmiş varlıkları atlar, böylece aynı sayfada yinelenen widget'lar görmezsiniz.
- FastComments Live Chat - Gerçek zamanlı akışlı sohbet. Aynı sayfadaki yorum alanının yanında yerleştirilebilir.
- FastComments Collab Chat - Metin seçimiyle yapılan açıklama ve tartışma.
- FastComments Image Chat - Görseller üzerinde koordinat tabanlı açıklama. Ziyaretçiler, belirli konumlarla bağlantılı yorum bırakmak için bir görsele tıklar.
- FastComments Recent Comments - Sitenizdeki son yorumları gösterir. Gösterilecek sayı blok üzerinde yapılandırılabilir.
- FastComments Top Pages - Sitenizde en çok yoruma sahip sayfaları gösterir.
İçerik merkezli bloklar (Live Chat, Collab Chat, Image Chat) mevcut varlığı otomatik algılar ve varlık olmayan sayfalarda yol tabanlı bir tanımlayıcıya başvurur. Bu, taksonomi sayfalarında, görünümlerde ve özel rotalarda herhangi bir ekstra kurulum gerektirmeden çalıştıkları anlamına gelir.
İçerik Türü Alanları
Çoğu site için yorum eklemenin en kolay yolu, içerik türlerinize FastComments alanını eklemektir. Structure > Content types > [type] > Manage fields yoluna gidin ve alanı ekleyin.
Alana sahip her varlık şunları alır:
- Bir durum geçiş düğmesi böylece editörler her varlık için yorumları açıp kapatabilir.
- İsteğe bağlı bir özel tanımlayıcı böylece Drupal varlık yoluna bağlı olmayan sabit bir kimlik kullanabilirsiniz.
Ana FastComments Widget bloğu bu alanı bilir ve zaten eklenmiş olan varlıkları atlayacaktır. Böylece aynı sayfada FastComments Widget'ı iki kez görmeden, varlık başına yorumları blok ile birlikte kullanabilirsiniz.
Tek Oturum Açma (SSO)
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.
İzinler
Modül, People > Permissions altında her role atayabileceğiniz üç Drupal izni ekler.
- Administer FastComments - FastComments ayar formuna
/admin/config/content/fastcommentsadresinden erişim. - View FastComments - Yorum bileşenini görmek için gereklidir. Bu izin olmadan bileşen görüntülenmez.
- Toggle FastComments - Kullanıcıların alan widget'ını kullanarak yorumları varlığa göre etkinleştirmesine veya devre dışı bırakmasına izin verir.
Varsayılan olarak, yalnızca administer site configuration iznine sahip kullanıcılar FastComments ayarlarını değiştirebilir. Ziyaretçilerin widget'ı görmesini istiyorsanız View FastComments iznini anonim ve doğrulanmış kullanıcılara verin.
Çok Dilli
Modül, mevcut Drupal site dilini her FastComments widget'ına otomatik olarak aktarır. Eğer Drupal siteniz birden fazla dil için yapılandırılmışsa, yorum kullanıcı arayüzü herhangi bir ek yapılandırma gerektirmeden eşleşen dilde görüntülenecektir.
Bu, tüm widget türlerine uygulanır: Live Comments, Streaming Chat, Collab Chat, Image Chat, Recent Comments ve Top Pages.
AB Veri Yerleşimi
FastComments hesabınız AB'de barındırılıyorsa, Administration > Configuration > Content > FastComments altında iki ayarı güncelleyin:
- CDN URL -
https://cdn-eu.fastcomments.com - Site URL -
https://eu.fastcomments.com
Ayrıca Tenant ID ve API Secret'ınızı varsayılan ABD kontrol paneli yerine AB kontrol panelinden eu.fastcomments.com/auth/my-account/api adresinden almanız gerekecektir. Modüldeki diğer her şey aynı şekilde çalışır.
Özelleştirme
FastComments, sitenize uyacak şekilde özelleştirilmek üzere tasarlanmıştır.
Özel stil eklemek veya yapılandırmayı ayarlamak isterseniz, nasıl yapılacağını öğrenmek için Özelleştirme Belgelerimizi İnceleyin
Gereksinimler
- 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.