Kurulum

Embed kodu

Embed kodunuzu Site Console → widget'ınız → Install & Embed sayfasından kopyalayın; uygulama anahtarınız orada hazır yazılıdır.

<script defer src="https://embeds.crowment.com/comments.js"></script>

<crow-comments app-key="YOUR_APP_KEY"></crow-comments>

1. <script> etiketini sayfalarınızın <head> bölümüne koyun. Sayfa başına bir kez yüklenmesi yeterlidir.
2. <crow-comments> etiketini <body> içinde, yorum bölümünün görüneceği yere koyun; genellikle makalenizin hemen altı.

Kurulum bu kadar. Widget, çevresindeki öğenin genişliğine uyar.

WordPress

Crowment Comments eklentisi WordPress'in yerleşik yorumlarını widget ile değiştirir; temanızı düzenlemeniz gerekmez.

1. crowment-comments.zip dosyasını indirin.
2. WordPress'te Plugins → Add New → Upload Plugin yolunu izleyin, zip'i seçip Install Now, ardından Activate düğmesini seçin.
3. Settings → Crowment Comments sayfasında app key'inizi yapıştırıp kaydedin.

Mevcut WordPress yorumlarınız veritabanında kalır; eklenti etkinken gizlenir. Eklentiyi güncellemek için yeni zip'i aynı şekilde yükleyin ve mevcut sürümün değiştirilmesini onaylayın.

Framework'ler ve site oluşturucular

<crow-comments> standart bir web bileşenidir; HTML ekleyebildiğiniz her yerde çalışır: statik siteler, CMS temaları, React, Vue, Svelte, Angular ve diğerleri.

Bazı framework'ler tanımadıkları etiketler için uyarı verir. Onlara crow-comments'in bir custom element olduğunu söyleyin:

export default defineNuxtConfig({
  vue: {
    compilerOptions: {
      isCustomElement: tag => tag === 'crow-comments',
    },
  },
})

import vue from '@vitejs/plugin-vue'

export default {
  plugins: [
    vue({
      template: {
        compilerOptions: {
          isCustomElement: tag => tag === 'crow-comments',
        },
      },
    }),
  ],
}

Tek sayfalı uygulamalar (SPA)

Uygulamanız sayfa değiştirdiğinde widget'ı yeniden oluşturmanız gerekmez. Widget, istemci tarafı gezinmeyi (pushState, replaceState, ileri ve geri düğmeleri) kendisi takip eder ve yeni sayfanın yorum dizisini yükler.

Bir sayfa hangi yorum dizisini gösterir

Her sayfanın kendi yorum dizisi vardır. Varsayılan olarak widget sayfayı URL yolu ile tanır, adresin geri kalanını yok sayar. https://example.com/blog/merhaba?ref=mail#yorumlar için bu /blog/merhaba olur. Yani:

• /blog/merhaba?utm_source=bulten ile /blog/merhaba aynı diziyi paylaşır.
• /blog/merhaba ile /blog/merhaba/ farklı yollardır, dolayısıyla farklı dizileri vardır. URL'lerinizi tutarlı tutun.
• Diziler tek bir widget'a aittir. Aynı yolda olsalar bile iki widget asla yorum paylaşmaz.

Üç özellik (attribute) sayfanın nasıl tanındığını değiştirir:

• watch-query, sorgu parametrelerini alfabetik sırayla sayfa kimliğine ekler; böylece ?b=2&a=1 ile ?a=1&b=2 aynı sayılır. İçeriği sorgu belirliyorsa kullanın, örneğin /watch?v=abc123. utm_source gibi takip parametreleri dahil her parametre hesaba katılır.
• watch-hash, hash kısmını sayfa kimliğine ekler. /#/posts/42 gibi hash tabanlı yönlendirmede kullanın.
• page-id, URL yerine sizin seçtiğiniz bir kimliği kullanır. Aynı içerik birden çok URL'de yayınlanıyorsa ya da URL'leriniz değişebilecekse kullanın. Yazınızın veritabanı kimliği gibi sabit bir değer, URL ne kadar değişirse değişsin diziyi sayfaya bağlı tutar.

<crow-comments app-key="YOUR_APP_KEY" page-id="post-1842"></crow-comments>

Bir yoruma bağlantı vermek

Herhangi bir sayfa URL'sine bir yorum kimliğiyle crowment_cid ekleyerek sayfayı o yorumun dizisi yüklenmiş şekilde açabilirsiniz, örneğin https://example.com/blog/merhaba?crowment_cid=COMMENT_ID. Yorum kimlikleri widget'ta yorumun menüsünden kopyalanabilir.

Özellik başvurusu

Boolean özellikler yazıldığında açıktır: <crow-comments app-key="…" watch-query>. Sayfa yüklendikten sonra herhangi bir özelliği değiştirebilirsiniz; widget değişikliği takip eder.