---
title: WordPress
---

# WordPress

Plugin oficial da CaptchaLa para WordPress. Adiciona verificação CAPTCHA aos formulários nativos do WordPress e aos plugins de formulário, e-commerce e comunidade mais comuns, sem escrever uma linha de código.

## O que ele cobre

Cada item abaixo é uma checkbox individual no painel de configurações do plugin — você só habilita as superfícies que de fato quer proteger.

- Login do WordPress
- Cadastro do WordPress
- Comentários do WordPress
- Recuperação de senha do WordPress
- Checkout do WooCommerce
- Criação de conta do WooCommerce
- Login do WooCommerce
- Contact Form 7
- Gravity Forms
- WPForms
- Elementor Forms
- BBPress (tópicos e respostas)
- BuddyPress (cadastro e atividade)

Se um plugin de formulário não estiver instalado, seu toggle fica oculto — o plugin detecta as integrações disponíveis na inicialização.

## Instalação

### 1. Instale o plugin

O plugin está no diretório oficial do WordPress.org:
[**wordpress.org/plugins/captchala**](https://wordpress.org/plugins/captchala). Duas opções:

- **Painel WordPress** (recomendado) — `Plugins` → `Adicionar novo`, pesquise `CaptchaLa`, clique em **Instalar** e depois em **Ativar**. A partir daí, atualizações com um clique.
- **Upload manual** — baixe o zip em
  [`wordpress.org/plugins/captchala`](https://wordpress.org/plugins/captchala),
  envie via `Plugins` → `Adicionar novo` → `Enviar plugin` e ative.

O plugin tem como alvo WordPress ≥ 6.0 e PHP ≥ 7.4.

### 2. Obtenha suas chaves

Cadastre-se em [`dash.captcha.la`](https://dash.captcha.la), crie uma aplicação e então copie:

- **App Key** — pública, embarcada na página
- **App Secret** — apenas do lado do servidor, usada pelo WordPress para chamar `/v1/validate`

### 3. Faça a configuração

No WP-Admin, abra `CaptchaLa` no menu esquerdo:

1. Cole a **App Key** e o **App Secret**.
2. Escolha um modo de verificação (popup, bind, embed ou float — veja [SDK Web](/pt-BR/web-sdk)).
3. Habilite os formulários que deseja proteger.
4. Clique em **Salvar alterações**.

Abra um dos formulários protegidos em uma janela anônima para confirmar que o desafio é renderizado.

## Configuração

Todas as configurações ficam em `WP-Admin → CaptchaLa`. O plugin as armazena como uma única option do WordPress (`captchala_settings`).

| Configuração | Tipo | Padrão | Descrição |
| --- | --- | --- | --- |
| App Key | string | — | Chave pública (`cl_pub_…`) do painel da CaptchaLa. Obrigatória. |
| App Secret | string | — | Segredo do servidor. Obrigatório. Nunca exposto ao navegador. |
| Modo de verificação | enum | `popup` | Um de `popup`, `bind`, `embed`, `float`. Mapeia para a opção `product` do SDK Web. |
| Toggles de formulário | bool[] | todos desligados | Um toggle por formulário suportado (veja [O que ele cobre](#what-it-covers)). |
| Carregamento lazy | bool | `true` | Quando ligado, o loader da CaptchaLa só é enfileirado em páginas que contêm um formulário protegido. |
| Tema | enum | `auto` | `light`, `dark` ou `auto` (segue a preferência do sistema do usuário). |
| Rótulo de action | string | por formulário | A string `action` enviada na validação (`login`, `register`, `comment`, `wc_checkout`, etc). O plugin define padrões sensatos — só substitua se houver um motivo. |
| Vincular ao IP | bool | `true` | Envia o IP do visitante na emissão e na validação. Desabilite atrás de um proxy que não encaminhe IPs de cliente. |
| Bloquear em falha de verificação | bool | `true` | Quando desligado, verificações que falham são registradas, mas o formulário ainda é enviado. Use em rollout faseado, não em produção. |

As configurações também podem ser exportadas / importadas em JSON pelo rodapé da página de ajustes.

## FAQ

**O plugin é gratuito?**

Sim. O plugin para WordPress é gratuito. O plano gratuito da CaptchaLa cobre 10.000 verificações por mês — planos pagos só se aplicam se você precisar de mais volume.

**Ele vai deixar meu site mais lento?**

O loader é enfileirado de forma lazy, apenas em páginas que renderizam um formulário protegido. A chamada de verificação retorna do edge em menos de 100ms na maioria das regiões. Não há script de tracking na home.

**Funciona com o WooCommerce?**

Sim. Checkout, criação de conta e login têm suporte pronto de fábrica — cada um é um toggle separado. O plugin se conecta ao pipeline padrão de validação do WooCommerce, então verificações que falham aparecem como erros normais de formulário do WooCommerce.

**Preciso escrever código?**

Não. Instale, cole duas chaves, habilite os formulários que quer proteger. Há filtros disponíveis caso você precise customizar o comportamento, mas são opcionais.

**Está em conformidade com a GDPR?**

A CaptchaLa é privacy-first: sem pixels de tracking de terceiros, sem sinais de publicidade, e o plugin para WordPress transmite apenas o necessário para verificar um único desafio. Exportação e exclusão por requisição estão disponíveis pelo painel da CaptchaLa.

## Código-fonte

- Diretório do WordPress.org: [`wordpress.org/plugins/captchala`](https://wordpress.org/plugins/captchala)
- Repositório do plugin: [`github.com/Captcha-La/captchala-wordpress`](https://github.com/Captcha-La/captchala-wordpress)
- Issues / pedidos de funcionalidade: abertos no repositório acima
- Relacionados: [SDK Web](/pt-BR/web-sdk) · [SDK PHP Server](/pt-BR/sdk/server-php) · [Referência da API](/pt-BR/api-reference)