WordPress
CaptchaLa 공식 WordPress 플러그인. 코드를 작성하지 않고 WordPress 기본 폼과 주요 폼/커머스/커뮤니티 플러그인에 CAPTCHA 검증을 추가합니다.
보호 대상
아래 항목은 모두 플러그인 설정 패널의 개별 체크박스입니다 — 실제로 보호할 진입점만 활성화하면 됩니다.
- WordPress 로그인
- WordPress 회원가입
- WordPress 댓글
- WordPress 비밀번호 재설정
- WooCommerce 결제
- WooCommerce 계정 생성
- WooCommerce 로그인
- Contact Form 7
- Gravity Forms
- WPForms
- Elementor Forms
- BBPress (주제 및 답글)
- BuddyPress (가입 및 활동)
해당 폼 플러그인이 설치되어 있지 않으면 토글이 표시되지 않습니다 — 플러그인이 시작 시 사용 가능한 연동을 감지합니다.
설치
1. 플러그인 설치
두 가지 방법이 있습니다.
- WordPress 관리자 —
플러그인→새로 추가에서CaptchaLa를 검색하고 설치 → 활성화. - 수동 업로드 —
github.com/Captcha-La/captchala-wordpress/releases에서 최신 zip을 받아플러그인→새로 추가→플러그인 업로드로 업로드 후 활성화.
요구 사항: WordPress ≥ 6.0, PHP ≥ 7.4.
2. 키 발급
dash.captcha.la 에서 가입 후 애플리케이션을 만들고 아래를 복사합니다.
- App Key — 공개 키, 페이지에 임베드됩니다
- App Secret — 서버 전용, WordPress가
/v1/validate를 호출할 때 사용합니다
3. 연결
WP 관리자 좌측 메뉴에서 CaptchaLa를 엽니다.
- App Key와 App Secret을 붙여넣습니다.
- 검증 모드(popup, bind, embed, float — Web SDK 참고)를 선택합니다.
- 보호할 폼을 활성화합니다.
- 변경 사항 저장을 누릅니다.
보호된 폼 중 하나를 시크릿 창에서 열어 챌린지가 정상적으로 렌더링되는지 확인합니다.
설정 항목
모든 설정은 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 대시보드에서 가능합니다.
소스
- 플러그인 저장소:
github.com/Captcha-La/captchala-wordpress - 이슈 / 기능 요청: 위 저장소에 등록
- 관련 문서: Web SDK · PHP 서버 SDK · API 레퍼런스