Form CAPTCHA (Shortcode)

Put a BotBlocker challenge inside any form on your site.

WordPress protects the login form and the comment form. Other forms such as contact forms, newsletter sign-ups, quote requests and checkout extras are often open to bots. This add-on gives you one shortcode that places a BotBlocker visitor check inside any front-end form, without a separate CAPTCHA plugin.

The widget is the size of a Google reCAPTCHA block. It offers the same simple checks as the main visitor verification: a robot button, a color button, or a hold button. The challenge is tied to the visitor's own connection: the IP address, browser user agent and session cookie must stay the same from the moment the widget loads to the moment the form is submitted. A copied or replayed answer does not pass.

This is a PRO add-on: it needs a PRO license.

How it works

1. You place the shortcode in a form. Add [bbcs_form_captcha] inside the form, before the submit button. The add-on prints nothing on other pages.

2. The visitor passes the check. The visitor clicks the robot button, picks the requested color, or holds the button in the green zone. The result is signed and tied to the visitor's connection.

3. The form submission is checked. If the answer is missing or invalid, the form is rejected and the failure message is shown. If the answer is valid, the form continues to its normal handler.

4. The check can be styled. Choose a light or dark theme, add your own CSS class, or override the challenge type for one shortcode.

Settings

Open BotBlocker → Add-ons → Form CAPTCHA (Shortcode).

Main

Enable Form CAPTCHA

Default: On after activation

The master switch. When it is off, the shortcode outputs nothing and form submissions are not checked.

Default CAPTCHA type

Default: I am not a robot

The challenge used when a shortcode does not set its own type. Options:

  • I am not a robot: one click.
  • Color button: pick the requested color.
  • Hold button: hold the button and release it in the green zone.

Default theme

Default: Light

The widget color theme: Light or Dark. Override it per shortcode with theme="light" or theme="dark".

Failure message

Default: Please complete the CAPTCHA verification and try again.

Shown when a form is submitted without a valid CAPTCHA answer. Keep it short and tell the visitor what to do.

Shortcode

Basic usage:

[bbcs_form_captcha]

Optional attributes:

[bbcs_form_captcha type="robot|color|hold" theme="light|dark" class="your-class"]
Attribute Values What it does
type robot, color, hold Overrides the default challenge type for this shortcode
theme light, dark Overrides the default widget theme
class any CSS class name Adds your class to the widget wrapper

Before you use it

  • Keep the shortcode inside the <form>. The add-on checks the submission, so the widget and the form must belong to the same page and the same visitor session.
  • Do not cache pages with the widget. A cached form can show another visitor's challenge state. Exclude those pages from page caching, or use BotBlocker's Page Cache, which serves cached pages only to verified visitors.
  • One widget per form. A second widget on the same form is not needed and can confuse the check.
  • Test after changing the theme or type. Submit the form once as a real visitor and once with the widget removed, so you see both the success path and the failure message.

Common problems

  • The shortcode shows nothing. The add-on is not active, or Enable Form CAPTCHA is off.
  • Every submission is rejected. The page is cached, the form posts to a different domain, or a security plugin strips the challenge fields. Clear the cache and test with caching off.
  • The widget looks broken. Your theme may override button styles. Add the class attribute and adjust the widget in your theme CSS.
  • A real visitor cannot pass. Try another challenge type for that form, or check whether the visitor's browser blocks cookies. The challenge needs a session cookie.
  • Spam still arrives. The add-on protects only forms that contain the shortcode. Add the shortcode to every public form you want to protect.