
Dil 🇹🇷 Türkçe
Shopify Kurulumu
Shopify Sitelerine Yorum Ekle
FastComments, Shopify App Store üzerinde mevcuttur. Uygulamayı yükleyin ve Shopify tema düzenleyicisinden herhangi bir blog gönderisine, ürün sayfasına veya özel sayfaya FastComments blokları ekleyin. Kod düzenlemesi gerekmez.
Uygulamayı yüklediğinizde, Shopify FastComments hesabınızı hazırlar, mağaza alan adınızı bağlar ve faturalamayı otomatik olarak aktif eder. fastcomments.com adresinde ayrı bir kayıt yapmanıza gerek yoktur.
Bu kılavuzdaki sayfalar, uygulamanın sağladığı her FastComments bloğunu, Shopify müşterileriniz için tek oturum açmanın (single sign-on) nasıl çalıştığını ve geçiş yapmadan önce mevcut Shopify yorumlarını nasıl içe aktaracağınızı kapsar.
FastComments Uygulamasını Kurun 
Shopify App Store'dan yükleyin
- Shopify App Store'daki FastComments sayfasını açın.
- Uygulamayı ekle'ye tıklayın ve kurulum akışı sırasında istediğiniz planı seçin.
- Kurulum tamamlandığında Shopify sizi Shopify içindeki FastComments yönetim paneline geri yönlendirir.
Kurulum bu kadar. Tema dosyalarınıza yapıştırmanız gereken bir şey yok.
Sizin için nelerin kuruldu
Yükleme, aksi takdirde elle yapacağınız tüm adımları yürütür:
- Mağazanız için bir FastComments tenant oluşturulur ve mağaza alan adınıza bağlanır.
- Mağazanızın URL'si tenant'ın yetkilendirilmiş alan adlarına eklenir, böylece yorumlar alan adı hatası olmadan yüklenir.
- Her bloğun hangi tenant'a göre görüntüleneceğini bilmesi için
fastcomments.tenant_idshop metafield yazılır. - Shopify müşterileriniz için tek oturum açma (single sign-on) varsayılan olarak etkinleştirilir.
- Faturalandırma Shopify Managed Pricing üzerinden yürütülür. Ücretler standart Shopify faturanıza yansır. Shopify yönetici panelinizde Ayarlar > Uygulamalar ve satış kanalları > FastComments bölümünden yükseltme, düşürme veya iptal yapabilirsiniz.
Eğer mağazanız uygulamayı yüklemeden önce zaten FastComments müşterisiyse, kurulum yeni bir tenant oluşturmaktansa mevcut tenant'ı tekrar kullanır.
Gömülü yönetim paneli
Shopify yönetici panelinizden FastComments uygulamasını açtığınızda, sizi tam FastComments arka ucuna tek tıkla erişim sağlayan bir pano karşılar:
- Dashboard: hesap ayarları, kullanım ve abonelik detayları.
- Moderasyon Kuyruğu: mağazanız genelindeki yorumları onaylayın, reddedin ve yanıtlayın.
- Özelleştir: widget renklerini, yazı tiplerini, moderasyon kurallarını ve yapılandırmayı ayarlayın.
- Puanlar & İncelemeler Yardımcısı: yıldız puanlarını ve inceleme sorularını ayarlayın; Reviews Summary bloğunu kullanmak isterseniz.
Her kutucuk FastComments'i tek kullanımlık bir oturum açma bağlantısıyla açar, böylece ayrı bir oturum açmanıza gerek kalmaz.
Sonraki: mağazanıza bloklar ekleyin
Shopify tema düzenleyicinizi açın (Çevrimiçi Mağaza > Temalar > Özelleştir), yorum veya inceleme eklemek istediğiniz şablonu açın ve Blok ekle'ye tıklayın. FastComments blokları Uygulamalar altında görünür. Bu kılavuzun geri kalanı her bir bloğu kapsar.
Blog Gönderilerine ve Ürünlere Yorum Ekleyin 
The FastComments bloğu ana yorum arayüzüdür. Bunu blog yazısı şablonlarına, ürün şablonlarına veya tartışma dizisi ya da canlı sohbet istediğiniz herhangi bir sayfaya ekleyin.
Bloğu ekleyin
- Shopify tema düzenleyicisini açın (Online Store > Themes > Customize).
- Yorumların görünmesini istediğiniz şablonu seçin: Blog post, Product, veya başka bir sayfa ya da bölüm şablonu.
- Yorumların görünmesini istediğiniz bölümde Add block üzerine tıklayın.
- Apps altında FastComments'ı seçin.
- Save'e tıklayın.
Blok hemen görünür. Girilmesi gereken bir Tenant ID yoktur; mağazanızın tenant'ı uygulamayı yüklediğinizde otomatik olarak bağlanır.
Ayarlar
| Setting | What it does | Default |
|---|---|---|
| Tenant ID (optional) | Bloğun hangi FastComments tenant'ı üzerinde render edileceğini geçersiz kılar. Mağazanızın otomatik olarak yapılandırılan tenant'ını kullanmak için boş bırakın. Manuel bir tenant ID'si için fastcomments.com/auth/my-account/api-secret adresine bakın. | (blank) |
| SSO | Ziyaretçiyi yorum yapmadan önce Shopify müşteri hesabı olarak otomatik oturum açtırır. Bkz. Shopify Müşterilerinin Otomatik Girişi. | Açık |
| Commenting Style | İç içe yanıtlar ve oylar için Threaded, veya gerçek zamanlı sohbet akışı için Streaming. | Threaded |
| Custom URL ID | Otomatik algılanan sayfa tanımlayıcısını geçersiz kılar. İki URL'nin aynı yorum dizisini paylaşmasını istediğinizde bunu kullanın. | (auto-detected) |
Sayfa tanımlayıcısı nasıl seçilir
Her yorum dizisi bir URL ID ile anahtarlanır. Blok bunu otomatik olarak seçer:
- Blog post template:
shopify-article-{article.id}, bu, slug ve başlık değişiklikleri boyunca sabittir. - Product template:
shopify-product-{product.id}, bu, slug ve başlık değişiklikleri boyunca sabittir. - Other templates: istek yolu (request path).
Eğer Custom URL ID ayarlarsanız, bunun yerine bu değer kullanılır. Birden fazla blok arasında (örneğin, ürün sayfasının yerelleştirilmiş bir varyantında) tek bir yorum dizisini paylaşmak için aynı Custom URL ID'yi kullanın.
Threaded vs Streaming
Threaded varsayılandır. Ziyaretçiler birbirlerine yanıt verir, oy verir ve moderasyon araçları beklendiği gibi çalışır. Blog yazıları ve ürün incelemeleri için en uygunudur.
Streaming dallanmayı bırakır ve yeni yorumları gönderildikçe gerçek zamanlı olarak gösterir; bir sohbet akışı gibidir. Ürün lansmanları, canlı etkinlikler ve topluluk sayfaları için en uygunudur.
Aynı sayfada birden fazla blok
Aynı şablona blok birden fazla kez eklenebilir. Örneğin, bir ürün sayfasının üst kısmında bir İnceleme Özeti ve altında bir FastComments bloğu olabilir. Bloklar bir URL ID paylaşır, böylece özet alttaki yorumları yansıtır.
İpuçları
- Tema düzenleyici önizlemesinde tenant bulamazsa blok kendini sarı bir uyarı ile gizler. Bu canlı mağazanızda görünüyorsa FastComments uygulamasını yeniden yükleyin.
- Bir ürün sayfası için FastComments bloğu aynı zamanda ürün incelemeleri widget'ınız olarak da çalışır. Sayfanın en üstünde yıldız derecelendirme özeti için bunu FastComments - Reviews Summary ile eşleştirin.
Yorum Sayısı Rozeti Ekleyin 
The FastComments - Comment Count bloğu tek bir sayfa için küçük bir yorum sayısı görüntüler. Bunu blog gönderi listelerinde, ürün kartlarında veya yorumların bulunduğu bir sayfaya bağlantı veren herhangi bir şablonda kullanın; böylece ziyaretçiler tıklamadan önce her konunun ne kadar aktif olduğunu görebilir.
Bloğu ekleyin
- Shopify tema düzenleyicisini açın.
- Sayımın görünmesini istediğiniz şablonu açın. Örneğin, Blog şablonu (gönderi listesi) veya bir ürün listeleme bölümü.
- Her öğeyi render eden bölümde Add block (Bloğu ekle) öğesine tıklayın.
- Apps altında FastComments - Comment Count öğesini seçin.
- Save (Kaydet) öğesine tıklayın.
Ayarlar
| Setting | What it does | Default |
|---|---|---|
| Tenant ID (optional) | Hangi FastComments kiracısından (tenant) sayımın okunacağını geçersiz kılar. Mağazanın otomatik yapılandırılmış kiracısını kullanmak için boş bırakın. | (boş) |
| Custom URL ID | Sayımın aradığı sayfa tanımlayıcısını geçersiz kılar. Sayım, takip ettiği FastComments bloğundan farklı bir sayfadaysa bunu kullanın. | (otomatik algılandı) |
Sayımın yorum dizisiyle eşleşmesi
Comment Count bloğu, FastComments bloğu ile aynı otomatik algılama mantığını kullanır:
- Blog gönderi şablonu:
shopify-article-{article.id} - Ürün şablonu:
shopify-product-{product.id} - Diğer şablonlar: istek yolu
Bir sayfada FastComments bloğunda bir Custom URL ID ayarlarsanız, aynı konuyu işaret etmeleri için Comment Count bloğunda da aynı Custom URL ID'yi ayarlayın.
İpuçları
- Sayfadaki her öğe için sayımlar tek bir istekte alınır, bu nedenle uzun bir listede bloğu her öğeye eklemenin ekstra bir tur maliyeti yoktur.
- Bir listelemedeki her makale veya ürün için bir Comment Count bloğu beklenen kullanımdır; bloğu ihtiyaç duyduğunuz kadar ekleyebilirsiniz.
Son Yorumlar Akışı Ekleyin 
The FastComments - Recent Comments block shows the most recent comments across your whole store. Use it to show fresh activity in a sidebar, footer, or homepage section.
Add the block
- Open the Shopify theme editor.
- Open the template where you want the feed. A sidebar section, the home page, or the blog index all work well.
- Click Add block in the section that should hold it.
- Under Apps, select FastComments - Recent Comments.
- Click Save.
Settings
| Ayar | Ne yapar | Varsayılan |
|---|---|---|
| Tenant ID (optional) | Beslemenin okuduğu FastComments tenant'ını geçersiz kılar. Mağazanın otomatik yapılandırılmış tenant'ını kullanmak için boş bırakın. | (boş) |
| Number of comments | Kaç tane en son yorum gösterileceğini belirler. Değer 1 ile 50 arasında olabilir. | 5 |
İpuçları
- Her yorum gönderildiği sayfaya bağlantı verir, bu yüzden blok aynı zamanda "insanların şu anda ne hakkında konuştuğu" hakkında bir gezinme ipucu olarak da çalışır.
- Besleme mağaza geneldir. Tek bir sayfa için en son yorumları göstermek istiyorsanız, bunun yerine o sayfada FastComments bloğunu kullanın.
Son Tartışmalar Akışı Ekleyin 
The FastComments - Recent Discussions bloğu mağazanızdaki en son yorum etkinliğine sahip sayfaları listeler; sayfa başına bir giriş. Ziyaretçilerin bireysel yorumlar yerine aktif konuları keşfetmelerini istediğinizde kullanın.
Add the block
- Shopify tema düzenleyicisini açın.
- Beslemeyi yerleştirmek istediğiniz şablonu açın; örneğin bir yan çubuk, footer, blog indeksi veya ana sayfa bölümü.
- Bölümün içinde tutması gereken yere tıklayın ve Add block seçeneğine tıklayın.
- Apps altında FastComments - Recent Discussions'ı seçin.
- Save'e tıklayın.
Settings
| Setting | What it does | Default |
|---|---|---|
| Tenant ID (optional) | Hangi FastComments tenant'ından beslemenin okunduğunu geçersiz kılar. Mağazanın otomatik yapılandırılmış tenant'ını kullanmak için boş bırakın. | (blank) |
| Number of comments | Gösterilecek en son tartışma sayısı. Aralık 1 ile 50 arasındadır. | 20 |
Recent Discussions vs Recent Comments
Her iki blok da aynı veriden beslenir, ancak farklı görünümler gösterir:
- Recent Comments: en son bireysel yorumların düz bir listesi. "Az önce ne söylendi" için en uygunudur.
- Recent Discussions: sayfa başına bir giriş, en son etkinliğe göre sıralanmış. "Hangi konular şu anda aktif" için en uygunudur.
Aynı mağazada her ikisini de kullanabilirsiniz. Örneğin, blog yan çubuğunda Recent Comments ve ana sayfada Recent Discussions.
En Popüler Sayfalar Listesi Ekleyin 
FastComments - Top Pages bloğu, mağazanızdaki genel olarak en fazla yorum etkinliğine sahip sayfaları listeler. En çok tartışılan gönderi veya ürünlerinizi ön plana çıkarmak için kullanın.
Bloğu ekleyin
- Shopify tema düzenleyicisini açın.
- Listenin görünmesini istediğiniz şablonu açın; örneğin bir kenar çubuğu, altbilgi veya blog indeks bölümü.
- Bu bölümü barındırması gereken yerde Blok ekle'ye tıklayın.
- Uygulamalar altında FastComments - Top Pages'i seçin.
- Kaydet'e tıklayın.
Ayarlar
| Ayar | Ne işe yarar | Varsayılan |
|---|---|---|
| Tenant ID (optional) | Listenin hangi FastComments tenant'ından okunduğunu geçersiz kılar. Mağazanın otomatik yapılandırılmış tenant'ını kullanmak için boş bırakın. | (boş) |
Top Pages vs Recent Discussions
- Top Pages, toplam etkileşime göre sıralama yapar; bu yüzden aynı gönderiler bir süre üst sıralarda kalma eğilimindedir. 'Popüler gönderiler' kenar çubuğu için uygundur.
- Recent Discussions, en son etkinliğe göre sıralama yapar; bu yüzden liste hızla değişir. 'Şu anda neler popüler' paneli için uygundur.
İncelemeler Özeti Ekleyin 
The FastComments - İncelemeler Özeti bloğu bir sayfa için toplu yıldız puanını ve inceleme dökümünü gösterir. Standart inceleme düzeni için ürün şablonlarındaki FastComments bloğuyla eşleştirin: özet yukarıda, inceleme formu ve incelemeler aşağıda.
Önkoşul: Derecelendirmeler & İncelemeler'i ayarlama
İncelemeler Özeti bloğu, mağazanız için yapılandırdığınız değerlendirme sorularını gösterir. Önce bunları ayarlayın:
- Shopify yönetiminizde FastComments uygulamasını açın.
- Ratings & Reviews Helper karosuna tıklayın (veya doğrudan Derecelendirmeler & İncelemeler Yardımcısı sayfasını açın).
- Her değerlendiricinin yanıtlamasını istediğiniz soruları ekleyin (genel yıldız puanı, "beden nasıl uydu", vb.).
Sorular yapılandırılmamışsa, özet bloğunun toplayacağı veri olmaz.
Bloğu ekleyin
- Shopify tema düzenleyicisini açın.
- Ürün şablonunu açın (veya özetin yer almasını istediğiniz sayfa şablonunu).
- Sayfa bölümünün üst kısmına yakın, Bloğu ekle'ye tıklayın; bu, FastComments bloğunun olacağı yerin üzerinde olmalıdır.
- Uygulamalar altında FastComments - İncelemeler Özeti'ni seçin.
- Ziyaretçilerin inceleme bırakabilmesi için aynı sayfada daha aşağıya bir FastComments bloğu ekleyin (henüz eklemediyseniz).
- Kaydet'e tıklayın.
Ayarlar
| Setting | What it does | Default |
|---|---|---|
| Tenant ID (optional) | Özetin hangi FastComments kiracısından okuma yapacağını geçersiz kılar. Mağazanın otomatik olarak yapılandırdığı kiracıyı kullanmak için boş bırakın. | (boş) |
| Custom URL ID | Özetin toplama yaptığı sayfa kimliğini geçersiz kılar. Özet, yansıttığı FastComments bloğundan farklı bir sayfadaysa bunu kullanın. | (otomatik algılanır) |
Özetin incelemelerle nasıl eşleştiği
İncelemeler Özeti bloğu, FastComments bloğuyla aynı otomatik algılama mantığını kullanır:
- Product template:
shopify-product-{product.id} - Blog post template:
shopify-article-{article.id} - Other templates: the request path
Normal bir ürün sayfası için özet ile yorum dizisi otomatik olarak bir URL kimliğini paylaşır; herhangi bir yapılandırma gerekmez.
İpuçları
- Özet salt okunurdur. İnceleme toplamak için aynı sayfada bir FastComments bloğuna ihtiyacınız vardır.
- İncelemeleri topladıktan sonra Derecelendirmeler & İncelemeler Yardımcısı'nda değerlendirme sorularını değiştirirseniz, özet yeni soru kümesine göre yeniden hesaplanır.
Shopify Müşterileri için Otomatik Oturum Açma 
The FastComments bloğu tek oturum açma (SSO) destekler, böylece Shopify müşterileriniz ayrı bir FastComments hesabı oluşturmadan kendi kimlikleriyle yorum yapabilirler.
Nasıl çalışır
When a visitor who is logged into your store opens a page with the FastComments block:
- Blok Shopify
customernesnesini algılar. - Müşterinin adını ve e-postasını imzalı bir uygulama vekil isteği aracılığıyla FastComments'e gönderir.
- FastComments,
shopify-{customerId}anahtarıyla bir kullanıcı oluşturur veya eşler, böylece aynı müşteri oturumlar ve yeniden yüklemeler arasında her zaman aynı FastComments kullanıcısına karşılık gelir. - Ziyaretçinin adı yorumlarında görünür. Yeniden oturum açmaları istenmez.
If the visitor is not logged into the store, the block falls back to anonymous commenting (or the FastComments sign-in flow, depending on your widget configuration).
SSO'yu kapatma
SSO, her FastComments bloğu için varsayılan olarak açıktır. Belirli bir blokta kapatmak için:
- Shopify tema düzenleyicisini açın.
- Bloğu içeren şablonu açın ve bloğu seçmek için üzerine tıklayın.
- SSO işaretini kaldırın.
- Kaydet'e tıklayın.
Yorum yapanların konuşma için ayrı bir kimlik seçmesini istiyorsanız SSO'yu kapatın. Örneğin, personelin farklı bir görüntüleme adıyla yorum yaptığı dahili bir topluluk sayfası.
FastComments'in aldığı veriler
Her müşteri için gönderilen SSO yükü şunları içerir:
- Shopify müşteri kimliğinden türetilmiş bir kullanıcı kimliği (
shopify-{customerId}). - Müşterinin e-postası (kullanıcıyı tanımlamak için kullanılır; halka açık şekilde gösterilmez).
- Müşterinin görüntüleme adı (yorum yazarı adı olarak kullanılır).
Sipariş geçmişi, ödeme veya adres verileri gönderilmez. Yük sunucu tarafında imzalanır; müşterinin tarayıcısı asla bir kimlik bilgisi görmez.
Giriş ve çıkış bağlantıları
SSO açık olduğunda, yorum widget'ının oturum açma ve oturum kapatma bağlantıları standart Shopify müşteri hesap yolları olan /account/login ve /account/logout adreslerine işaret eder. Yapılandırılacak bir şey yoktur. Bu bağlantılar müşteri hesapları etkinleştirilmiş herhangi bir mağaza için çalışır.
Mevcut Yorumları İçe Aktar 
Shopify blog gönderilerinizde zaten yorumlar varsa ve bunları saklamak istiyorsanız, Shopify'ın yerleşik yorum özelliğini devre dışı bırakmadan önce bunları FastComments'a aktarın.
İçe aktarma, Shopify'ın yerleşik yorumları hâlâ etkin ve görünürken çalıştırılmalıdır. Bunları devre dışı bıraktığınızda FastComments artık bunları okuyamaz.
İçe aktarmaya nasıl başlanır
- FastComments uygulamasının mağazanıza yüklü olduğundan emin olun.
- Şimdilik Shopify'ın yerleşik yorum özelliğini etkin bırakın.
- Bir destek bileti açın ve hangi blogları içe aktaracağınızı bize bildirin.
İçe aktarma bir günden kısa sürede tamamlanır.
Mevcut yorumlar FastComments'a alındıktan sonra, blog gönderisi şablonunuza FastComments bloğunu ekleyin ve Shopify'ın yerleşik yorumlarını kaldırın veya devre dışı bırakın. Bakınız Blog Gönderilerine ve Ürünlere Yorum Ekle.
Mevcut yorumları saklamanız gerekmiyorsa, bu sayfayı atlayabilirsiniz.
Özelleştirme 
Renkler, yazı tipleri, moderasyon kuralları, izin verilen HTML ve anonim yorum bırakma, mağazanızın marka kimliğine uygun olacak şekilde yapılandırılabilir.
Shopify yönetiminizde FastComments uygulamasını açın ve widget özelleştirme ekranını açmak için Özelleştir kutucuğuna tıklayın. Tek kullanımlık bir giriş bağlantısı kullanır, bu nedenle ayrı bir oturum açmanıza gerek yoktur.
Tüm özelleştirme seçeneklerinin tam listesi için bkz. Özelleştirme ve Yapılandırma kılavuzu.
Alan Adı Hataları 
Eğer FastComments'i Shopify App Store'dan yüklediyseniz, mağaza alan adınız otomatik olarak kiracının yetkili alanlarına eklenir ve bir alan hatası görmemeniz gerekir. Bu sayfa, manuel kurulum yolunu izlediyseniz veya mağaza ön yüzünüz uygulama yüklendiğinde Shopify'a kayıtlı olmayan özel bir alan adında sunuluyorsa geçerlidir.
You may get an authorization error that looks like this:
This means FastComments doesn't recognize the domain the widget is loading on as authorized for your tenant.
To fix it, add the domain to your FastComments account: Etki Alanlarını Yapılandır.
Manuel Kurulum (Gelişmiş) 
If you can't install the Shopify App Store app, you can still add FastComments by editing your theme. This path is useful when you want to wire up a FastComments tenant you already own, or when you're embedding on a Shopify storefront where the app isn't an option.
The app-based install is the supported path for most stores. Reach for this only if the app doesn't fit.
Adım 1: Shopify'ın yerleşik yorumlarını devre dışı bırakın
Shopify yönetiminizde, Blog posts > Manage blogs bölümüne gidin, her blogu açın ve sağ panelde Comments are disabled seçeneğini ayarlayın. Kaydedin.
Bu, Shopify'ın yerleşik yorum sisteminin FastComments ile birlikte gösterilmesini durdurur.
Adım 2: Blog tema şablonunu açın
Shopify yönetiminizde:
- Go to Online Store > Themes.
- Under your current theme, click Actions > Edit code.
- In the file browser on the left, open Sections and click
main-article.liquid.
Bu, Shopify'ın tek bir blog makalesi için render ettiği şablondur.
Adım 3: FastComments kod parçacığını yapıştırın
main-article.liquid dosyasının yaklaşık 100. satırına, makale gövdesinin kapanış </div> etiketinin hemen sonrasına gidin. Aşağıdaki kod parçacığını yapıştırın:

Replace "demo" with your own Tenant ID from fastcomments.com/auth/my-account/api-secret. Click Save.
Adım 4: Mağaza alan adınızı yetkilendirin
Canlı mağazanızda bir blog gönderisini açın. Eğer yorum bileşeni yerine bir yetkilendirme hatası görürseniz, FastComments'in mağazanızın bu tenant'ı kullanmasına izin verildiğini bilmesi gerekir. Bakınız Alan Adı Hataları.
FastComments'i diğer sayfalara ekleme
Aynı kod parçacığı, ürün sayfaları, özel sayfalar ve ana sayfa dahil olmak üzere herhangi bir Liquid şablonunda çalışır. Yorumların görünmesini istediğiniz yere yapıştırın ve sayfa başına sabit bir tanımlayıcı istiyorsanız urlId değerini ayarlayın (örneğin, bir ürün şablonunda urlId: "{{ product.id }}").