---
title: WordPress
---

# WordPress

Plugin WordPress resmi CaptchaLa. Menambahkan verifikasi CAPTCHA ke formulir inti WordPress dan plugin formulir, e-commerce, serta komunitas yang paling umum tanpa menulis kode apa pun.

## Cakupan

Setiap item di bawah ini adalah kotak centang independen di panel pengaturan plugin — Anda hanya mengaktifkan permukaan yang benar-benar ingin dilindungi.

- Login WordPress
- Pendaftaran WordPress
- Komentar WordPress
- Lupa kata sandi WordPress
- Checkout WooCommerce
- Pembuatan akun WooCommerce
- Login WooCommerce
- Contact Form 7
- Gravity Forms
- WPForms
- Elementor Forms
- BBPress (topik dan balasan)
- BuddyPress (pendaftaran dan aktivitas)

Jika plugin formulir terkait belum dipasang, toggle-nya disembunyikan — plugin mendeteksi integrasi yang tersedia saat boot.

## Instalasi

### 1. Pasang plugin

Plugin ini ada di direktori resmi WordPress.org:
[**wordpress.org/plugins/captchala**](https://wordpress.org/plugins/captchala). Dua opsi:

- **Admin WordPress** (disarankan) — `Plugins` → `Add New`, cari `CaptchaLa`, klik **Install** lalu **Activate**. Pembaruan satu klik setelahnya.
- **Unggah manual** — unduh zip dari
  [`wordpress.org/plugins/captchala`](https://wordpress.org/plugins/captchala),
  unggah melalui `Plugins` → `Add New` → `Upload Plugin`, lalu aktifkan.

Plugin menargetkan WordPress ≥ 6.0 dan PHP ≥ 7.4.

### 2. Dapatkan kunci Anda

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

- **App Key** — kunci publik, disematkan di halaman
- **App Secret** — hanya sisi server, digunakan oleh WordPress untuk memanggil `/v1/validate`

### 3. Sambungkan

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

1. Tempel **App Key** dan **App Secret**.
2. Pilih mode verifikasi (popup, bind, embed atau float — lihat [Web SDK](/id/web-sdk)).
3. Aktifkan formulir yang ingin dilindungi.
4. Klik **Save changes**.

Buka salah satu formulir yang dilindungi di jendela private untuk memastikan tantangan tampil dengan benar.

## Konfigurasi

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

| Pengaturan | Tipe | Default | Deskripsi |
| --- | --- | --- | --- |
| App Key | string | — | Kunci publik (`cl_pub_…`) dari dasbor CaptchaLa. Wajib. |
| App Secret | string | — | Rahasia server. Wajib. Tidak pernah diekspos ke browser. |
| Mode verifikasi | enum | `popup` | Salah satu dari `popup`, `bind`, `embed`, `float`. Memetakan ke opsi `product` Web SDK. |
| Toggle formulir | bool[] | semua off | Satu toggle per formulir yang didukung (lihat [Cakupan](#cakupan)). |
| Lazy load | bool | `true` | Saat aktif, loader CaptchaLa hanya dimuat di halaman yang berisi formulir terlindungi. |
| Tema | enum | `auto` | `light`, `dark`, atau `auto` (mengikuti pengaturan sistem pengguna). |
| Label action | string | per formulir | String `action` yang dikirim saat validasi (`login`, `register`, `comment`, `wc_checkout`, dll). Plugin menetapkan default yang masuk akal — timpa hanya jika ada alasan. |
| Ikat ke IP | bool | `true` | Mengirim IP pengunjung saat penerbitan dan validasi. Nonaktifkan di belakang proxy yang tidak meneruskan IP klien. |
| Blokir saat verifikasi gagal | bool | `true` | Saat nonaktif, kegagalan verifikasi dicatat tetapi formulir tetap dikirim. Untuk peluncuran bertahap, bukan production. |

Pengaturan juga dapat diekspor / diimpor sebagai JSON dari footer halaman pengaturan.

## FAQ

**Apakah plugin ini gratis?**

Ya. Plugin WordPress-nya sendiri gratis. Paket gratis CaptchaLa mencakup 10.000 verifikasi per bulan — paket berbayar hanya berlaku jika Anda butuh volume lebih besar.

**Apakah akan memperlambat situs saya?**

Loader dimuat secara lazy, hanya di halaman yang merender formulir terlindungi. Panggilan verifikasi kembali dari edge dalam kurang dari 100ms di sebagian besar wilayah. Tidak ada script pelacakan di halaman depan.

**Apakah berfungsi dengan WooCommerce?**

Ya. Checkout, pembuatan akun, dan login didukung secara langsung — masing-masing toggle terpisah. Plugin meng-hook pipeline validasi standar WooCommerce, sehingga kegagalan verifikasi muncul sebagai kesalahan formulir WooCommerce biasa.

**Apakah saya perlu menulis kode?**

Tidak. Pasang, tempel dua kunci, pilih formulir yang ingin dilindungi. Filter hook tersedia jika Anda perlu menyesuaikan perilaku, tetapi semuanya opsional.

**Apakah patuh GDPR?**

CaptchaLa mengutamakan privasi: tidak ada pixel pelacakan pihak ketiga, tidak ada sinyal iklan, dan plugin WordPress hanya mengirim yang dibutuhkan untuk memverifikasi satu tantangan. Ekspor dan penghapusan per permintaan tersedia melalui dasbor CaptchaLa.

## Sumber

- Direktori WordPress.org: [`wordpress.org/plugins/captchala`](https://wordpress.org/plugins/captchala)
- Repositori plugin: [`github.com/Captcha-La/captchala-wordpress`](https://github.com/Captcha-La/captchala-wordpress)
- Isu / permintaan fitur: diajukan ke repositori di atas
- Terkait: [Web SDK](/id/web-sdk) · [PHP Server SDK](/id/sdk/server-php) · [Referensi API](/id/api-reference)