Docs
Integrations
WordPress

WordPress

This is a all-in-one plugin for WordPress that allows you to configure client-side captcha widget and server-side verification.

WordPress plugin GitHub repository

Features

  • Form Protection: Login, registration, password reset, and comment forms
  • Flexible Configuration: Theme, language, start mode, and custom styling options
  • EU Compliance: Support for EU-only endpoints and custom domains
  • WP-CLI Commands: Emergency management tools for API key updates and login bypass

Step-by-step setup guide

Create a new property in Private Captcha portal

Go to Private Captcha Portal and click “Add new property” button.

Add new

Enter name and domain of your WordPress website e.g. mydomain.com and “My WordPress website”.

Warning

Domain of the property should exactly match your WordPress website domain.

Enter name and domain

Note Sitekey of the property

Open “Integrations” tab and note the Sitekey of the property you just created. You will need it for WordPress plugin configuration.

Enter name and domain

Create a new API key

Go to API key settings and click “Create new key”. Give it some meaningful name, like “WordPress API key”

Create a new API key

Copy API key value to your password manager to temporarily save it (note the expiration time you selected when creating above).

Copy API key value

Install Private Captcha plugin in WordPress

Click one of the two “Add plugin” buttons in your WordPress installation, search for Private Captcha and install the plugin:

Install plugin button

After the installation, Activate the plugin:

Activate installed plugin

Configure Sitekey and API key

Using values, that you created previously in the Private Captcha portal, configure the plugin:

Configure plugins

Notably, put created API key into a required field “API Key” and property sitekey into a required field “Site Key”.

Click “Save Changes” button below and your configuration will be verified.

Test integration

Just for test, enable login form integration.

Login form setting

Now, open login dialog for your WordPress installation (e.g. in Private browser tab):

Login form

Supported Forms

  • WordPress Login Form
  • WordPress Registration Form
  • WordPress Password Reset Form
  • WordPress Comment Forms (logged-in and guest users)
  • WPForms
  • Contact Form 7 (use [privatecaptcha] tag)
  • More forms support (including popular plugins) are currently in progress

WP-CLI Commands

Emergency management when locked out:

# Update API key
wp private-captcha update-api-key "your-new-api-key"

# Disable login captcha (emergency use)
wp private-captcha disable-login

Troubleshooting

Form integration is enabled, but captcha does not load.

Possible reasons:

  • Domain name of your WordPress site does not equal exactly to the domain name of the property in Private Captcha portal
  • If you are testing locally, you need to enable “Allow localhost” in Property settings

Requirements

Last updated on
RubyPHP