---
title: WordPress
---

# WordPress

CaptchaLa 공식 WordPress 플러그인. 코드를 작성하지 않고 WordPress 기본 폼과 주요 폼/커머스/커뮤니티 플러그인에 CAPTCHA 검증을 추가합니다.

## 보호 대상

아래 항목은 모두 플러그인 설정 패널의 개별 체크박스입니다 — 실제로 보호할 진입점만 활성화하면 됩니다.

- WordPress 로그인
- WordPress 회원가입
- WordPress 댓글
- WordPress 비밀번호 재설정
- WooCommerce 결제
- WooCommerce 계정 생성
- WooCommerce 로그인
- Contact Form 7
- Gravity Forms
- WPForms
- Elementor Forms
- BBPress (주제 및 답글)
- BuddyPress (가입 및 활동)

해당 폼 플러그인이 설치되어 있지 않으면 토글이 표시되지 않습니다 — 플러그인이 시작 시 사용 가능한 연동을 감지합니다.

## 설치

### 1. 플러그인 설치

플러그인이 공식 WordPress.org 디렉터리에 등록되어 있습니다:
[**wordpress.org/plugins/captchala**](https://wordpress.org/plugins/captchala). 두 가지 방법이 있습니다.

- **WordPress 관리자**(권장) — `플러그인` → `새로 추가`에서 `CaptchaLa`를 검색하고 **설치** → **활성화**. 이후 원클릭으로 업데이트됩니다.
- **수동 업로드** —
  [`wordpress.org/plugins/captchala`](https://wordpress.org/plugins/captchala)
  에서 zip을 받아 `플러그인` → `새로 추가` → `플러그인 업로드`로 업로드 후 활성화.

요구 사항: WordPress ≥ 6.0, PHP ≥ 7.4.

### 2. 키 발급

[`dash.captcha.la`](https://dash.captcha.la) 에서 가입 후 애플리케이션을 만들고 아래를 복사합니다.

- **App Key** — 공개 키, 페이지에 임베드됩니다
- **App Secret** — 서버 전용, WordPress가 `/v1/validate`를 호출할 때 사용합니다

### 3. 연결

WP 관리자 좌측 메뉴에서 `CaptchaLa`를 엽니다.

1. **App Key**와 **App Secret**을 붙여넣습니다.
2. 검증 모드(popup, bind, embed, float — [Web SDK](/ko/web-sdk) 참고)를 선택합니다.
3. 보호할 폼을 활성화합니다.
4. **변경 사항 저장**을 누릅니다.

보호된 폼 중 하나를 시크릿 창에서 열어 챌린지가 정상적으로 렌더링되는지 확인합니다.

## 설정 항목

모든 설정은 `WP 관리자 → CaptchaLa`에 있습니다. 플러그인은 단일 WordPress option(`captchala_settings`)으로 저장합니다.

| 설정 | 타입 | 기본값 | 설명 |
| --- | --- | --- | --- |
| App Key | string | — | CaptchaLa 대시보드의 공개 키(`cl_pub_…`). 필수. |
| App Secret | string | — | 서버 시크릿. 필수. 브라우저로 노출되지 않습니다. |
| 검증 모드 | enum | `popup` | `popup`, `bind`, `embed`, `float` 중 하나. Web SDK의 `product` 옵션에 매핑. |
| 폼 토글 | bool[] | 모두 OFF | 지원 폼별 토글([보호 대상](#보호-대상) 참고). |
| 지연 로드 | bool | `true` | ON일 때 보호된 폼이 포함된 페이지에서만 CaptchaLa loader가 로드됩니다. |
| 테마 | enum | `auto` | `light`, `dark`, 또는 `auto`(OS 설정 추종). |
| Action 라벨 | string | 폼별 | 검증 시 전송하는 `action` 문자열(`login`, `register`, `comment`, `wc_checkout` 등). 플러그인이 합리적인 기본값을 설정하므로 필요할 때만 덮어쓰세요. |
| IP 바인딩 | bool | `true` | 발급/검증 시 방문자 IP를 함께 전송합니다. 클라이언트 IP를 전달하지 않는 리버스 프록시 뒤에서는 비활성화하세요. |
| 검증 실패 시 차단 | bool | `true` | OFF로 두면 검증 실패가 로그에만 기록되고 폼은 제출됩니다. 점진 출시에 적합하며 운영 환경에는 권장하지 않습니다. |

설정은 설정 페이지 하단에서 JSON으로 내보내기/가져오기 할 수 있습니다.

## FAQ

**플러그인은 무료인가요?**

네, 무료입니다. WordPress 플러그인 자체는 무료이며, CaptchaLa 무료 플랜은 월 1,000회 검증을 포함합니다 — 더 큰 사용량이 필요한 경우에만 유료 플랜이 적용됩니다.

**사이트가 느려지나요?**

loader는 지연 로드되며, 보호된 폼이 있는 페이지에서만 등록됩니다. 대부분 지역에서 검증 호출은 엣지에서 100ms 이하로 응답합니다. 메인 페이지에 트래킹 스크립트가 들어가지 않습니다.

**WooCommerce에서 동작하나요?**

동작합니다. 결제, 계정 생성, 로그인이 기본 지원이며 각각 개별 토글입니다. 플러그인이 WooCommerce 표준 검증 파이프라인에 연결되므로 검증 실패는 일반적인 WooCommerce 폼 오류로 표시됩니다.

**코드 작성이 필요한가요?**

아니요. 설치하고, 키 두 개를 붙여넣고, 보호할 폼을 선택하면 됩니다. 필요한 경우 커스터마이즈용 filter 훅이 있지만 모두 선택 사항입니다.

**GDPR을 준수하나요?**

CaptchaLa는 프라이버시 우선입니다. 제3자 트래킹 픽셀이나 광고 신호가 없으며, WordPress 플러그인은 단일 챌린지 검증에 필요한 정보만 전송합니다. 요청 단위의 내보내기/삭제는 CaptchaLa 대시보드에서 가능합니다.

## 소스

- WordPress.org 디렉터리: [`wordpress.org/plugins/captchala`](https://wordpress.org/plugins/captchala)
- 플러그인 저장소: [`github.com/Captcha-La/captchala-wordpress`](https://github.com/Captcha-La/captchala-wordpress)
- 이슈 / 기능 요청: 위 저장소에 등록
- 관련 문서: [Web SDK](/ko/web-sdk) · [PHP 서버 SDK](/ko/sdk/server-php) · [API 레퍼런스](/ko/api-reference)