---
title: Flarum
---

# Flarum

Sambungan Flarum rasmi CaptchaLa. Menambah pengesahan CAPTCHA kepada tindakan yang biasanya disasarkan bot di forum — pendaftaran, log masuk, reset kata laluan dan menghantar pos — dengan togol per-tindakan di panel pentadbir.

## Apa yang dilindungi

Setiap tindakan di bawah ialah togol berasingan di bawah `Admin → Extensions → CaptchaLa`.

- Pendaftaran
- Log masuk
- Reset kata laluan
- Balasan pos
- Perbincangan baharu
- Suntingan profil

Sesi yang disahkan melalui pembekal SSO / Auth Sync dikecualikan — lihat [SSO / Auth Sync](#sso-auth-sync) di bawah.

## Pasang

### 1. Perlukan sambungan

Dari root pemasangan Flarum anda:

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

Sebagai alternatif, dalam `Admin → Extension Manager` tampal `captchala/flarum` ke dalam medan **Install**. Sambungan ini memerlukan Flarum ≥ 1.8 dan PHP ≥ 8.1.

### 2. Aktifkan di panel pentadbir

Buka `Admin → Extensions`, cari **CaptchaLa**, dan klik **Enable**.

### 3. Konfigurasi

Di panel tetapan sambungan:

1. Tampal **App Key** dan **App Secret** anda dari [`dash.captcha.la`](https://dash.captcha.la).
2. Aktifkan tindakan yang mahu dilindungi.
3. Simpan.

## Konfigurasi

Tetapan disimpan di jadual settings standard Flarum di bawah awalan `captchala.*`.

| Tetapan | Jenis | Lalai | Penerangan |
| --- | --- | --- | --- |
| App Key | string | — | Kunci awam (`cl_pub_…`) dari papan pemuka CaptchaLa. Wajib. |
| App Secret | string | — | Rahsia pelayan. Wajib. Digunakan di sebelah pelayan sahaja untuk memanggil `/v1/validate`. |
| Lindungi pendaftaran | bool | `true` | Cabaran semasa pendaftaran. |
| Lindungi log masuk | bool | `false` | Cabaran pada modal log masuk. Lalai mati kerana kebanyakan forum melindungi log masuk melalui had kadar. |
| Lindungi reset kata laluan | bool | `true` | Cabaran apabila meminta e-mel reset kata laluan. |
| Lindungi balasan pos | bool | `false` | Cabaran semasa menghantar balasan. Lalai mati; aktifkan jika forum berada di bawah tekanan spam. |
| Lindungi perbincangan baharu | bool | `false` | Cabaran semasa membuka perbincangan. |
| Mod pengesahan | enum | `popup` | Satu daripada `popup`, `bind`, `embed`. Sepadan dengan opsyen `product` Web SDK. |
| Tema | enum | `auto` | `light`, `dark`, atau `auto`. |
| Langkau pengguna dipercayai | bool | `true` | Pengguna dalam kumpulan yang ditanda dipercayai (mis. moderator) memintas cabaran. |

## SSO / Auth Sync

Sambungan ini bekerjasama dengan cangkuk pembekal autentikasi standard Flarum (`UserAuthenticated`, pembekal Auth Sync pihak ketiga, jambatan OAuth).

- Jika pengguna tiba melalui sesi SSO yang disahkan, tiada cabaran dipaparkan — sambungan menganggap sesi tersebut telah disahkan.
- Untuk persediaan campuran di mana sesetengah pengguna log masuk melalui SSO dan yang lain melalui borang setempat, hanya laluan borang setempat menjalankan cabaran.
- Togol "Langkau pengguna dipercayai" bertindan di atas ini: kumpulan dipercayai memintas cabaran walaupun pada log masuk borang setempat.

## Soalan lazim

**Adakah sambungan ini percuma?**

Ya. Pakej Composer itu sendiri percuma. Pelan percuma CaptchaLa merangkumi 10,000 pengesahan sebulan.

**Adakah ia menghentikan pendaftaran spam?**

Ia menyekat atau mencabar kebanyakan pendaftaran automatik pada skor risiko pertama. Tiada CAPTCHA menyekat 100% — tetapi di forum ujian kami, volum pendaftaran spam jatuh kira-kira satu darjah magnitud selepas diaktifkan.

**Bolehkah saya memerlukannya hanya pada pendaftaran?**

Boleh. Setiap tindakan ialah togol berasingan. Profil lalai mengaktifkan hanya pendaftaran dan reset kata laluan.

**Adakah ia berfungsi dengan SSO / Auth Sync?**

Ya. Sesi yang dibuka oleh pembekal SSO / Auth Sync melangkau cabaran. Lihat [SSO / Auth Sync](#sso-auth-sync).

**Adakah ia sumber terbuka?**

Ya — kod sambungan PHP adalah sumber terbuka. Panggilan pengesahan berjalan terhadap perkhidmatan CaptchaLa yang dihos.

## Sumber

- Repositori sambungan: [`github.com/Captcha-La/captchala-flarum`](https://github.com/Captcha-La/captchala-flarum)
- Packagist: [`captchala/flarum`](https://packagist.org/packages/captchala/flarum)
- Berkaitan: [Web SDK](/ms/web-sdk) · [PHP Pelayan SDK](/ms/sdk/server-php) · [Rujukan API](/ms/api-reference)