---
title: Flarum
---

# Flarum

Flarum için resmi CaptchaLa uzantısı. Bir forumda botların tipik olarak hedef aldığı işlemlere — kayıt, giriş, parola sıfırlama ve gönderi yayınlama — yönetici panelinden işlem başına anahtarlarla CAPTCHA doğrulaması ekler.

## Kapsadıkları

Aşağıdaki her işlem, `Yönetici → Uzantılar → CaptchaLa` altında ayrı bir anahtardır.

- Kayıt
- Giriş
- Parola sıfırlama
- Yanıt gönderme
- Yeni tartışmalar
- Profil düzenlemeleri

Bir SSO / Auth Sync sağlayıcısı üzerinden açılan kimlik doğrulamalı oturumlar muaftır — aşağıdaki [SSO / Auth Sync](#sso-auth-sync) bölümüne bakın.

## Kurulum

### 1. Uzantıyı ekleyin

Flarum kurulum kökünüzden:

```bash
composer require captchala/flarum
```

Alternatif olarak, `Yönetici → Eklenti Yöneticisi` altında **Kur** alanına `captchala/flarum` yapıştırın. Uzantı, Flarum ≥ 1.8 ve PHP ≥ 8.1 hedefler.

### 2. Yönetici panelinde etkinleştirin

`Yönetici → Uzantılar`'ı açın, **CaptchaLa**'yı bulun ve **Etkinleştir**'i tıklayın.

### 3. Yapılandırın

Uzantının ayarlar panelinde:

1. [`dash.captcha.la`](https://dash.captcha.la) adresinden **App Key** ve **App Secret** değerlerinizi yapıştırın.
2. Hangi işlemlerin korunacağını açın.
3. Kaydedin.

## Yapılandırma

Ayarlar, standart Flarum ayarlar tablosunda `captchala.*` ön eki altında saklanır.

| Ayar | Tür | Varsayılan | Açıklama |
| --- | --- | --- | --- |
| App Key | string | — | CaptchaLa panelinden alınan public anahtar (`cl_pub_…`). Zorunlu. |
| App Secret | string | — | Sunucu secret'i. Zorunlu. Yalnızca sunucu tarafında `/v1/validate` çağırmak için kullanılır. |
| Kaydı koru | bool | `true` | Kayıt sırasında challenge. |
| Girişi koru | bool | `false` | Giriş modalında challenge. Çoğu forum giriş işlemini hız sınırlamasıyla koruduğu için varsayılan olarak kapalıdır. |
| Parola sıfırlamayı koru | bool | `true` | Parola sıfırlama e-postası istenirken challenge. |
| Yanıt gönderimini koru | bool | `false` | Yanıt gönderirken challenge. Varsayılan kapalı; forum spam baskısı altındaysa açın. |
| Yeni tartışmaları koru | bool | `false` | Tartışma açarken challenge. |
| Doğrulama modu | enum | `popup` | `popup`, `bind`, `embed`'den biri. Web SDK `product` seçeneğine eşlenir. |
| Tema | enum | `auto` | `light`, `dark` veya `auto`. |
| Güvenilir kullanıcılar için atla | bool | `true` | Güvenilir olarak işaretlenmiş gruplardaki kullanıcılar (örn. moderatörler) challenge'ı atlar. |

## SSO / Auth Sync

Uzantı, Flarum'un standart auth-provider kancalarıyla (`UserAuthenticated`, üçüncü taraf Auth Sync sağlayıcıları, OAuth köprüleri) işbirliği yapar.

- Kullanıcı kimlik doğrulamalı bir SSO oturumu üzerinden gelirse, challenge gösterilmez — uzantı oturumu zaten doğrulanmış kabul eder.
- Bazı kullanıcıların SSO ile, diğerlerinin yerel formla giriş yaptığı karışık kurulumlarda yalnızca yerel form yolu challenge'ı çalıştırır.
- `skip_for_trusted_users` anahtarı bunun üstüne istiflenir: güvenilir gruplar yerel form girişinde bile challenge'ı atlar.

## SSS

**Uzantı ücretsiz mi?**

Evet. Composer paketi ücretsizdir. CaptchaLa ücretsiz planı ayda 10.000 doğrulamayı kapsar.

**Spam kayıtları durdurur mu?**

Otomatik kayıtların çoğunu ilk risk skorunda engeller veya challenge'a tabi tutar. Hiçbir CAPTCHA %100 engellemez — ancak test forumlarımızda etkinleştirildikten sonra spam kayıt hacmi yaklaşık bir büyüklük mertebesi düştü.

**Yalnızca kayıt sırasında zorunlu kılabilir miyim?**

Evet. Her işlem ayrı bir anahtardır. Varsayılan profil yalnızca kayıt ve parola sıfırlamayı etkinleştirir.

**SSO / Auth Sync ile çalışır mı?**

Evet. SSO / Auth Sync sağlayıcısı tarafından açılan oturumlar challenge'ı atlar. Bkz. [SSO / Auth Sync](#sso-auth-sync).

**Açık kaynak mı?**

Evet — PHP uzantı kodu açık kaynaktır. Doğrulama çağrıları, barındırılan CaptchaLa hizmetine yapılır.

## Kaynak

- Uzantı deposu: [`github.com/Captcha-La/captchala-flarum`](https://github.com/Captcha-La/captchala-flarum)
- Packagist: [`captchala/flarum`](https://packagist.org/packages/captchala/flarum)
- İlgili: [Web SDK](/tr/web-sdk) · [PHP Sunucu SDK](/tr/sdk/server-php) · [API Referansı](/tr/api-reference)