Description
WM Simple Captcha adds an image CAPTCHA to the default WordPress registration
form. The CAPTCHA image can be customized to match your theme: size, colors,
font, character set, background noise, border, label and refresh control.
The plugin generates each code on the server, stores it in a short-lived
transient keyed by an unguessable token, and accepts each code only once. No PHP
sessions are used, so it works on sites with page caching, multiple web servers
and strict session settings. The answer is never printed in the page HTML or
JavaScript.
Features
- Enable or disable the CAPTCHA on the WordPress registration form
- Set the image width and height
- Choose the number of characters
- Adjust the font size
- Add space between characters
- Choose from bundled or uploaded TrueType/OpenType fonts
- Configure the character set
- Add random dots and lines
- Set text, dots, line, background and border colors
- Change the field label and error messages
- Enable a border around the image
- Enable or disable the refresh button
- Use a custom refresh image from the media library
- Add custom CSS
- Case-insensitive validation
- One-time codes with automatic expiry
- Graceful fallback when the PHP GD extension is unavailable
Requirements
The PHP GD extension is required to render CAPTCHA images. FreeType support is
recommended for TrueType fonts; without it the plugin falls back to a built-in
GD bitmap font. If GD itself is unavailable, the plugin hides the CAPTCHA field
instead of blocking registrations and shows an administrator notice.
Installation
Manual installation
- Download the plugin and unzip it.
- Upload the
wm-simple-captchafolder to/wp-content/plugins/. - Activate the plugin through the “Plugins” menu in WordPress.
- Go to Settings → WM Simple Captcha and configure the image.
- Make sure “Anyone can register” is enabled under Settings → General.
Automatic installation
- Log in to the WordPress admin area.
- Go to Plugins → Add New.
- Search for “WM Simple Captcha”.
- Click “Install Now” and then “Activate”.
- Go to Settings → WM Simple Captcha and configure the image.
FAQ
Why is the CAPTCHA image not showing?
Check the System status card on the settings screen. The PHP GD extension is
required. If GD is missing, the plugin shows an administrator notice and does
not block registrations.
Why does the image look different after saving?
The preview uses the saved settings. Save your changes and press “New code” to
refresh the preview.
Are CAPTCHA codes stored in the session?
No. Codes are stored server-side in short-lived transients keyed by a random
token. Each successful validation deletes the code, and codes expire
automatically.
Can I use the CAPTCHA on a custom registration form?
The plugin hooks into the standard register_form and registration_errors
hooks, so any form that fires those hooks is protected. Styles are loaded on the
login/registration screen; enqueue the wm-simple-captcha-front handle if your
custom form lives elsewhere.
Can I change the colors and font?
Yes. Every visual setting is available under Settings → WM Simple Captcha.
Screenshots
Changelog
3.0.0 – 2026-11-17
- Fixed: CAPTCHA images were corrupted by PHP 8.2+ deprecation output from
hexdec(). - Fixed: Image generation no longer depends on PHP sessions or direct plugin file access.
- Fixed: Refresh always produces a new random code and token.
- Fixed: Expired, reused and invalid codes are rejected; codes are single-use.
- Added: AJAX-based settings screen with live preview, font upload and media picker.
- Added: Token-based challenge storage with expiry and attempt limiting.
- Added: Graceful GD/FreeType fallback and administrator notices.
- Added: PHP 8.2, 8.3 and 8.4 compatibility.
- Improved: Nonce verification, capability checks, sanitization and output escaping.
- Improved: Multisite-safe uninstall routine.
- Removed: Deprecated session code, direct-access image script and remote feedback form.
2.0.3 – 2016-01-03
- Tested with WordPress 4.4.
2.0.2 – 2015-08-22
- Tested with WordPress 4.3.
- Bug fixes.
2.0.1 – 2015-07-12
- Bug fixes.
2.0.0 – 2015-07-12
- Tested with WordPress 4.2.2.
- Added font upload functionality.
1.1.1 – 2015-04-18
- Fixed activation error.
- Tested with WordPress 3.8.x and 3.9.
1.1 – 2015-03-02
- Fixed activation error.
1.0 – 2015-03-01
- Initial release.





