---
title: WordPress
---

# WordPress

Pemalam WordPress rasmi CaptchaLa. Menambah pengesahan CAPTCHA ke borang teras WordPress dan pemalam borang, e-dagang serta komuniti yang paling biasa, tanpa menulis sebarang kod.

## Apa yang dilindungi

Setiap item di bawah ialah kotak pilihan berasingan di panel tetapan pemalam — anda hanya aktifkan permukaan yang benar-benar mahu dilindungi.

- Log masuk WordPress
- Pendaftaran WordPress
- Komen WordPress
- Reset kata laluan WordPress
- Pembayaran WooCommerce
- Pembuatan akaun WooCommerce
- Log masuk WooCommerce
- Contact Form 7
- Gravity Forms
- WPForms
- Elementor Forms
- BBPress (topik dan balasan)
- BuddyPress (pendaftaran dan aktiviti)

Jika pemalam borang berkenaan tidak dipasang, togolnya disembunyikan — pemalam mengesan integrasi yang tersedia semasa but.

## Pasang

### 1. Pasang pemalam

Pemalam ini berada di direktori rasmi WordPress.org:
[**wordpress.org/plugins/captchala**](https://wordpress.org/plugins/captchala). Dua pilihan:

- **Admin WordPress** (disyorkan) — `Plugins` → `Add New`, cari `CaptchaLa`, klik **Install** kemudian **Activate**. Kemas kini sekali klik selepas itu.
- **Muat naik manual** — muat turun zip dari
  [`wordpress.org/plugins/captchala`](https://wordpress.org/plugins/captchala),
  muat naik melalui `Plugins` → `Add New` → `Upload Plugin`, dan aktifkan.

Pemalam memerlukan WordPress ≥ 6.0 dan PHP ≥ 7.4.

### 2. Dapatkan kunci anda

Daftar di [`dash.captcha.la`](https://dash.captcha.la), cipta aplikasi, kemudian salin:

- **App Key** — kunci awam, dibenamkan dalam halaman
- **App Secret** — sebelah pelayan sahaja, digunakan oleh WordPress untuk memanggil `/v1/validate`

### 3. Sambungkan

Dalam WP-Admin, buka `CaptchaLa` di menu kiri:

1. Tampal **App Key** dan **App Secret**.
2. Pilih mod pengesahan (popup, bind, embed atau float — lihat [Web SDK](/ms/web-sdk)).
3. Aktifkan borang yang mahu dilindungi.
4. Klik **Save changes**.

Buka salah satu borang yang dilindungi dalam tetingkap peribadi untuk mengesahkan cabaran dipaparkan.

## Konfigurasi

Semua tetapan berada di bawah `WP-Admin → CaptchaLa`. Pemalam menyimpannya sebagai satu option WordPress (`captchala_settings`).

| Tetapan | Jenis | Lalai | Penerangan |
| --- | --- | --- | --- |
| App Key | string | — | Kunci awam (`cl_pub_…`) dari papan pemuka CaptchaLa. Wajib. |
| App Secret | string | — | Rahsia pelayan. Wajib. Tidak pernah didedahkan kepada pelayar. |
| Mod pengesahan | enum | `popup` | Satu daripada `popup`, `bind`, `embed`, `float`. Sepadan dengan opsyen `product` Web SDK. |
| Togol borang | bool[] | semua mati | Satu togol untuk setiap borang yang disokong (lihat [Apa yang dilindungi](#apa-yang-dilindungi)). |
| Muat lewat | bool | `true` | Bila hidup, loader CaptchaLa hanya dimuatkan pada halaman yang mengandungi borang yang dilindungi. |
| Tema | enum | `auto` | `light`, `dark`, atau `auto` (mengikut tetapan sistem pengguna). |
| Label action | string | bergantung borang | Rentetan `action` yang dihantar semasa pengesahan (`login`, `register`, `comment`, `wc_checkout`, dll.). Pemalam menetapkan nilai lalai yang munasabah — tindih hanya jika ada sebab tertentu. |
| Ikat ke IP | bool | `true` | Menghantar IP pelawat semasa pengeluaran dan pengesahan. Matikan di belakang proksi yang tidak meneruskan IP klien. |
| Sekat apabila pengesahan gagal | bool | `true` | Bila mati, kegagalan pengesahan hanya dilog dan borang tetap dihantar. Untuk pelancaran berperingkat, bukan pengeluaran. |

Tetapan juga boleh dieksport / diimport sebagai JSON dari kaki halaman tetapan.

## Soalan lazim

**Adakah pemalam ini percuma?**

Ya. Pemalam WordPress itu sendiri percuma. Pelan percuma CaptchaLa merangkumi 10,000 pengesahan sebulan — pelan berbayar hanya berkenaan jika anda perlukan volum lebih tinggi.

**Adakah ia akan memperlahankan tapak saya?**

Loader dimuatkan secara lewat dan hanya pada halaman yang memaparkan borang yang dilindungi. Panggilan pengesahan kembali dari edge dalam masa di bawah 100ms di kebanyakan rantau. Tiada skrip jejak di halaman utama.

**Adakah ia berfungsi dengan WooCommerce?**

Ya. Pembayaran, pembuatan akaun dan log masuk disokong di luar kotak — setiap satu togol berasingan. Pemalam menyambung ke pipeline pengesahan standard WooCommerce, jadi kegagalan pengesahan muncul sebagai ralat borang WooCommerce biasa.

**Perlukah saya menulis kod?**

Tidak. Pasang, tampal dua kunci, pilih borang yang mahu dilindungi. Cangkuk filter tersedia jika anda perlu menyesuaikan tingkah laku, tetapi semuanya pilihan.

**Adakah ia mematuhi GDPR?**

CaptchaLa mengutamakan privasi: tiada piksel jejak pihak ketiga, tiada isyarat iklan, dan pemalam WordPress hanya menghantar apa yang diperlukan untuk mengesahkan satu cabaran. Eksport dan padam mengikut permintaan tersedia melalui papan pemuka CaptchaLa.

## Sumber

- Direktori WordPress.org: [`wordpress.org/plugins/captchala`](https://wordpress.org/plugins/captchala)
- Repositori pemalam: [`github.com/Captcha-La/captchala-wordpress`](https://github.com/Captcha-La/captchala-wordpress)
- Isu / permintaan ciri: fail terhadap repositori di atas
- Berkaitan: [Web SDK](/ms/web-sdk) · [PHP Pelayan SDK](/ms/sdk/server-php) · [Rujukan API](/ms/api-reference)