Cloudflare Turnstile WordPress Entegrasyonu (Ücretsiz)

Cloudflare Turnstile, WordPress sitenizdeki formlara gelen bot trafiğini ve spam gönderimlerini ücretsiz olarak engellemenin etkili bir yoludur. Bu rehberde, Cloudflare Turnstile WordPress entegrasyonunu hem eklenti ile hem de manuel kod ekleyerek nasıl yapacağınızı adım adım göreceksiniz. Ayrıca kurulum sırasında karşılaşabileceğiniz sorunları ve çözümlerini de bulacaksınız.

Cloudflare Turnstile Nedir?

Cloudflare Turnstile, kullanıcıları rahatsız etmeden botları tespit eden bir doğrulama hizmetidir. Geleneksel CAPTCHA’lardan farklı olarak çoğu durumda kullanıcıdan kutucuk işaretlemesini bile istemez. Arka planda tarayıcı davranışlarını analiz eder ve şüpheli trafiği otomatik ayırt eder. WordPress sitelerinde yorum formu, iletişim formu, üyelik girişi ve sipariş sayfaları gibi alanlara eklenebilir. Böylece hem ziyaretçi deneyimi korunur hem de spam gönderimler önemli ölçüde azalır.

Cloudflare Turnstile Kurulumu İçin Ön Koşullar

Entegrasyona başlamadan önce aşağıdaki gereksinimleri karşıladığınızdan emin olun:

• Cloudflare hesabı: Cloudflare’e ücretsiz kayıt olabilirsiniz.
• Turnstile site key ve secret key: Bu anahtarları Cloudflare kontrol panelinden alacaksınız.
• WordPress yönetici erişimi: Eklenti kurmak veya tema dosyalarını düzenlemek için gereklidir.
• FTP veya dosya yöneticisi erişimi: Manuel kod eklerken işinizi kolaylaştırır.

Adım Adım Cloudflare Turnstile WordPress Entegrasyonu

Bu bölümde iki farklı yöntem anlatılmıştır. Kodla uğraşmak istemiyorsanız ilk yöntemi tercih edin.

Yöntem 1: WordPress Eklentisi ile Entegrasyon

1. Cloudflare hesabınıza giriş yapın ve Turnstile bölümüne gidin.
2. Yeni bir site ekleyin. Site adını ve alan adınızı girin. Widget modunu “Managed” olarak seçin.
3. Oluşturulan Site Key ve Secret Key değerlerini kopyalayın.
4. WordPress yönetici panelinizde “Eklentiler > Yeni Ekle” bölümüne gidin.
5. Arama çubuğuna “Cloudflare Turnstile” yazın. Topluluk tarafından geliştirilmiş, güncel ve iyi puanlı bir eklenti seçin.
6. Eklentiyi kurun ve etkinleştirin.
7. Eklenti ayarlar sayfasına giderek Site Key ve Secret Key alanlarını doldurun.
8. Korumak istediğiniz formları seçin. Çoğu eklenti Contact Form 7, yorumlar ve giriş sayfası ile uyumludur.
9. Ayarları kaydedin. Artık formlarınız Turnstile doğrulamasından geçecektir.

Yöntem 2: Manuel Kod ile Entegrasyon

Eklenti kullanmak istemiyorsanız Turnstile widget’ını doğrudan tema dosyalarınıza ekleyebilirsiniz. Bu yöntem daha esnektir ancak PHP bilgisi gerektirir.

1. Cloudflare panelinden aldığınız Site Key’i kullanarak formunuzun HTML bölümüne şu kodu ekleyin:

<script src="https://challenges.cloudflare.com/turnstile/v0/api.js" async defer></script>
<div class="cf-turnstile" data-sitekey="SITE_KEY"></div>

2. Formunuzun işlendiği PHP dosyasında doğrulama yapın. Aşağıdaki örnek kodu kendi form yapınıza göre uyarlayın:

$secret = 'SECRET_KEY';
$response = $_POST['cf-turnstile-response'] ?? '';
$ip = $_SERVER['REMOTE_ADDR'];
$url = 'https://challenges.cloudflare.com/turnstile/v0/siteverify';
$data = [
    'secret'   => $secret,
    'response' => $response,
    'remoteip' => $ip,
];
$options = [
    'http' => [
        'header'  => "Content-type: application/x-www-form-urlencoded\r\n",
        'method'  => 'POST',
        'content' => http_build_query($data),
    ],
];
$context  = stream_context_create($options);
$result   = file_get_contents($url, false, $context);
$outcome  = json_decode($result, true);

if ( ! empty( $outcome['success'] ) ) {
    // Doğrulama başarılı, formu işleyin.
} else {
    // Doğrulama başarısız, kullanıcıya hata gösterin.
}

3. Site Key ve Secret Key değerlerini kendi anahtarlarınızla değiştirin.
4. Değişiklikleri kaydedin ve formu test edin.

Sorun Giderme ve Sık Karşılaşılan Hatalar

Cloudflare Turnstile entegrasyonunda en sık görülen sorunlar şunlardır:

• Widget formda görünmüyor: Tema veya önbellek eklentisi script yüklemesini engelliyor olabilir. Önbelleği temizleyin ve script’in sayfa kaynağında yüklendiğini kontrol edin.
• Doğrulama her zaman başarısız: Secret Key ile Site Key’in aynı siteye ait olduğundan emin olun. Anahtarlarda boşluk veya eksik karakter olmadığını kontrol edin.
• Form gönderilmiyor: Tarayıcı konsolunda JavaScript hatası olup olmadığına bakın. Başka bir güvenlik eklentisiyle çakışma olabilir.
• Hazır tema veya sayfa kurucu ile uyumsuzluk: Bazı tema formları standart WordPress form kancalarını kullanmaz. Bu durumda eklenti ayarlarındaki “özel form” seçeneğini kullanmanız gerekebilir.

Turnstile doğrulaması çalışmıyorsa formu geçici olarak kapatmak yerine sitenizin spam trafiğini başka yöntemlerle de azaltabilirsiniz. Ayrıntılı bilgi için Web Sitelerinde Spam Trafiğini Engelleme rehberine göz atabilirsiniz.

Sıkça Sorulan Sorular

Cloudflare Turnstile ücretsiz mi?

Evet, Cloudflare Turnstile temel kullanım için ücretsiz bir hizmettir. Yüksek hacimli kullanımlarda limitler değişebileceği için güncel bilgiyi Cloudflare’in resmi dokümantasyonundan kontrol edebilirsiniz.

Turnstile, Google reCAPTCHA’dan daha mı iyi?

Turnstile, kullanıcı etkileşimi gerektirmemesi nedeniyle daha az rahatsız edicidir. Ayrıca kişisel veri işleme konusunda farklı bir yaklaşım sunar. Hangisinin sitenize uygun olduğu, hedef kitlenize ve veri politikalarınıza bağlıdır.

Turnstile’ı WooCommerce formlarına ekleyebilir miyim?

Evet, uyumlu bir eklenti veya özel kod kullanarak WooCommerce giriş, kayıt ve sipariş formlarına Turnstile doğrulaması ekleyebilirsiniz.

Eklenti olmadan sadece HTML kodu eklemek yeterli mi?

Hayır, yalnızca HTML kodu eklemek botları engellemez. Sunucu tarafında doğrulama yapılması gerekir. Aksi halde botlar formu atlayabilir.

Hangi Yöntemi Seçmelisiniz?

Teknik bilginiz sınırlıysa veya hızlı bir kurulum istiyorsanız eklenti yöntemi en pratik çözümdür. Eklenti, anahtar yönetimini ve form entegrasyonunu sizin için halleder. Özel bir form yapınız varsa veya eklenti bağımlılığı istemiyorsanız manuel kod eklemeyi tercih edin. Her iki durumda da Cloudflare Turnstile, WordPress sitenizi spam trafiğinden korumak için etkili ve ücretsiz bir araçtır.