{"id":406604,"date":"2026-11-18T01:57:22","date_gmt":"2026-11-18T01:57:22","guid":{"rendered":"https:\/\/wordpress.org\/plugins\/selfcap-self-hosted-captcha\/"},"modified":"2026-11-18T11:26:18","modified_gmt":"2026-11-18T11:26:18","slug":"selfcap","status":"publish","type":"plugin","link":"https:\/\/tr.wordpress.org\/plugins\/selfcap\/","author":23607153,"comment_status":"closed","ping_status":"closed","template":"","meta":{"version":"1.0.3","stable_tag":"1.0.3","tested":"7.1.5","requires":"6.3","requires_php":"7.4","requires_plugins":null,"header_name":"Selfcap \u2013 Self-Hosted Captcha","header_author":"Christiano Erick","header_description":"A privacy-friendly captcha that runs entirely inside your WordPress site: a checkbox widget backed by proof-of-work, with no third-party service and no external server.","last_updated":"2026-11-18 11:26:18","external_support_url":"","external_repository_url":"","donate_link":"","header_plugin_uri":"https:\/\/github.com\/christianoerick\/selfcap","header_author_uri":"","rating":0,"author_block_rating":0,"active_installs":0,"downloads":89,"num_ratings":0,"support_threads":0,"support_threads_resolved":0,"author_block_count":0,"sections":["description","installation","faq","changelog"],"tags":{"1.0.2":{"tag":"1.0.2","author":"christianoerick","date":"2026-11-18 01:56:57","revision":3808425},"1.0.3":{"tag":"1.0.3","author":"christianoerick","date":"2026-11-18 11:26:18","revision":3809148}},"upgrade_notice":{"1.0.3":"<p>The widget now speaks 15 languages.<\/p>","1.0.2":"<p>Translations now come from translate.wordpress.org.<\/p>","1.0.1":"<p>Choose where the captcha goes on the WooCommerce checkout, and its alignment.<\/p>","1.0.0":"<p>First release.<\/p>"},"ratings":[],"assets_icons":{"icon-128x128.png":{"filename":"icon-128x128.png","revision":3808425,"resolution":"128x128","location":"assets","locale":"","width":128,"height":128},"icon-256x256.png":{"filename":"icon-256x256.png","revision":3808425,"resolution":"256x256","location":"assets","locale":"","width":256,"height":256},"icon.svg":{"filename":"icon.svg","revision":3808425,"resolution":false,"location":"assets","locale":false}},"assets_banners":{"banner-1544x500.png":{"filename":"banner-1544x500.png","revision":3808425,"resolution":"1544x500","location":"assets","locale":"","width":1544,"height":500},"banner-772x250.png":{"filename":"banner-772x250.png","revision":3808425,"resolution":"772x250","location":"assets","locale":"","width":772,"height":250}},"assets_blueprints":{},"all_blocks":[],"tagged_versions":["1.0.2","1.0.3"],"block_files":[],"assets_screenshots":{"screenshot-1.png":{"filename":"screenshot-1.png","revision":3808425,"resolution":"1","location":"assets","locale":"","width":2560,"height":1720},"screenshot-2.png":{"filename":"screenshot-2.png","revision":3808425,"resolution":"2","location":"assets","locale":"","width":2560,"height":1600},"screenshot-3.png":{"filename":"screenshot-3.png","revision":3808425,"resolution":"3","location":"assets","locale":"","width":2560,"height":1280},"screenshot-4.png":{"filename":"screenshot-4.png","revision":3808425,"resolution":"4","location":"assets","locale":"","width":2560,"height":3076},"screenshot-5.png":{"filename":"screenshot-5.png","revision":3808425,"resolution":"5","location":"assets","locale":"","width":1200,"height":1240}},"screenshots":{"1":"Overview: totals, daily chart and verification log.","2":"The widget above the \"Place order\" button of the WooCommerce checkout.","3":"IP rules, manual and automatic.","4":"Settings.","5":"The widget on the login screen."}},"plugin_section":[],"plugin_tags":[2656,362,600,599,286],"plugin_category":[44,45,54],"plugin_contributors":[293519],"plugin_business_model":[],"class_list":["post-406604","plugin","type-plugin","status-publish","hentry","plugin_tags-anti-spam","plugin_tags-captcha","plugin_tags-security","plugin_tags-spam","plugin_tags-woocommerce","plugin_category-discussion-and-community","plugin_category-ecommerce","plugin_category-security-and-spam-protection","plugin_contributors-christianoerick","plugin_committers-christianoerick"],"banners":{"banner":"https:\/\/ps.w.org\/selfcap\/assets\/banner-772x250.png?rev=3808425","banner_2x":"https:\/\/ps.w.org\/selfcap\/assets\/banner-1544x500.png?rev=3808425","banner_rtl":false,"banner_2x_rtl":false},"icons":{"svg":"https:\/\/ps.w.org\/selfcap\/assets\/icon.svg?rev=3808425","icon":"https:\/\/ps.w.org\/selfcap\/assets\/icon.svg?rev=3808425","icon_2x":false,"generated":false},"screenshots":[{"src":"https:\/\/ps.w.org\/selfcap\/assets\/screenshot-1.png?rev=3808425","caption":"Overview: totals, daily chart and verification log."},{"src":"https:\/\/ps.w.org\/selfcap\/assets\/screenshot-2.png?rev=3808425","caption":"The widget above the \"Place order\" button of the WooCommerce checkout."},{"src":"https:\/\/ps.w.org\/selfcap\/assets\/screenshot-3.png?rev=3808425","caption":"IP rules, manual and automatic."},{"src":"https:\/\/ps.w.org\/selfcap\/assets\/screenshot-4.png?rev=3808425","caption":"Settings."},{"src":"https:\/\/ps.w.org\/selfcap\/assets\/screenshot-5.png?rev=3808425","caption":"The widget on the login screen."}],"raw_content":"<!--section=description-->\n<p>Selfcap protects your forms with a simple \"I'm not a robot\" checkbox. Everything happens on your own site: WordPress issues the challenge, checks the answer, keeps the log and blocks attackers. Nothing is sent to another company, and there is nothing to sign up for.<\/p>\n\n<p><strong>How it protects<\/strong><\/p>\n\n<ul>\n<li><strong>Proof-of-work.<\/strong> The visitor's browser solves a small computation in the background. People do not notice it; bots sending thousands of requests pay for every one.<\/li>\n<li><strong>Browser signals.<\/strong> Automated browsers, scripted clicks and fake user agents are refused.<\/li>\n<li><strong>One-time tokens.<\/strong> Each solved captcha is good for a single form submission from the same address, and expires in 5 minutes. Tokens solved elsewhere are refused.<\/li>\n<li><strong>Rate limit and adaptive difficulty.<\/strong> The more an address asks, the harder each challenge gets.<\/li>\n<li><strong>Automatic blocking.<\/strong> Addresses that behave like an attack are blocked temporarily (15 minutes, then 1 hour, then 24 hours). A customer who fails a few times is never blocked, nor are the people sharing their address.<\/li>\n<li><strong>No side doors.<\/strong> Login over XML-RPC is closed, and the WordPress and WooCommerce forms share one setting, so neither is a way around the other.<\/li>\n<\/ul>\n\n<p><strong>Forms<\/strong><\/p>\n\n<ul>\n<li>Login, registration, lost password and comments, on wp-login.php, WooCommerce My Account and multisite sign-up<\/li>\n<li>WooCommerce checkout, in both the block checkout and the classic one, plus the Pay for order page<\/li>\n<li>Contact Form 7, with the <code>[selfcap]<\/code> tag<\/li>\n<li>Any other form, with the <code>[selfcap]<\/code> shortcode and <code>selfcap_verify()<\/code><\/li>\n<\/ul>\n\n<p><strong>Dashboard<\/strong><\/p>\n\n<ul>\n<li>Totals and a daily chart for the last 7, 30 or 90 days<\/li>\n<li>Verification log with result, score, reason, IP address and browser<\/li>\n<li>IP rules: block or allow an address or a CIDR range, permanently or for a while<\/li>\n<li>Real visitor IP behind Cloudflare, a load balancer or your own proxy<\/li>\n<\/ul>\n\n<p><strong>Languages<\/strong><\/p>\n\n<p>The widget speaks 15 languages: English, Spanish, Portuguese, German, French, Italian, Dutch, Japanese, Chinese, Russian, Polish, Indonesian, Turkish, Persian (right to left) and Swedish. It follows the visitor's browser, or a language you choose. The admin screen and the messages are translated on translate.wordpress.org: WordPress installs the translation for your site language automatically, and you can force any of those languages in the settings once its translation is available.<\/p>\n\n<p><strong>Privacy<\/strong><\/p>\n\n<p>This plugin does not contact any external service. It stores, on your own database and for a limited time (30 days by default), the IP address, browser user agent and result of each verification. A suggested paragraph for your privacy policy is added under Settings &gt; Privacy.<\/p>\n\n<!--section=installation-->\n<ol>\n<li>Upload the plugin to <code>\/wp-content\/plugins\/<\/code> or install it from the Plugins screen.<\/li>\n<li>Activate it. Login, registration, lost password and comments are protected right away.<\/li>\n<li>Open <strong>Selfcap &gt; Settings<\/strong> to choose which forms to protect, including WooCommerce and Contact Form 7 when those plugins are active.<\/li>\n<\/ol>\n\n<p>For Contact Form 7, add the <code>[selfcap]<\/code> tag to the form.<\/p>\n\n<!--section=faq-->\n<dl>\n<dt id=\"does%20it%20send%20any%20data%20to%20a%20third%20party%3F\"><h3>Does it send any data to a third party?<\/h3><\/dt>\n<dd><p>No. The challenge, the validation, the log and the blocking all run on your own site.<\/p><\/dd>\n<dt id=\"i%20am%20locked%20out%20of%20the%20login.%20what%20now%3F\"><h3>I am locked out of the login. What now?<\/h3><\/dt>\n<dd><p>Add <code>define('SELFCAP_DISABLE', true);<\/code> to <code>wp-config.php<\/code>. That switches the captcha off until you remove the line.<\/p><\/dd>\n<dt id=\"does%20it%20work%20with%20page%20caching%3F\"><h3>Does it work with page caching?<\/h3><\/dt>\n<dd><p>Yes. The widget fetches its challenge after the page loads, so cached pages are fine.<\/p><\/dd>\n<dt id=\"does%20it%20need%20the%20rest%20api%3F\"><h3>Does it need the REST API?<\/h3><\/dt>\n<dd><p>Yes. The widget talks to <code>\/wp-json\/selfcap\/v1\/<\/code> on your own site. If a security plugin closes the REST API to visitors, leave that route open.<\/p><\/dd>\n<dt id=\"my%20site%20is%20behind%20cloudflare%20or%20a%20load%20balancer.%20will%20it%20see%20the%20right%20ip%3F\"><h3>My site is behind Cloudflare or a load balancer. Will it see the right IP?<\/h3><\/dt>\n<dd><p>Yes. Forwarding headers are read only when the connection comes from Cloudflare, a private address or a proxy you list in the settings, so a visitor cannot forge them. The settings screen shows the address detected for you.<\/p><\/dd>\n<dt id=\"can%20a%20determined%20bot%20get%20through%3F\"><h3>Can a determined bot get through?<\/h3><\/dt>\n<dd><p>Browser signals can be forged by a dedicated bot. The real cost comes from the proof-of-work, the rate limit, the one-time tokens and the automatic blocking, which make large-scale abuse expensive.<\/p><\/dd>\n<dt id=\"how%20do%20i%20protect%20a%20custom%20form%3F\"><h3>How do I protect a custom form?<\/h3><\/dt>\n<dd><p>Print the widget with <code>echo do_shortcode('[selfcap]');<\/code> inside the form and call <code>selfcap_verify()<\/code> in the code that handles the submission. It returns true or false.<\/p><\/dd>\n<dt id=\"does%20it%20work%20with%20express%20payment%20buttons%20%28apple%20pay%2C%20google%20pay%29%3F\"><h3>Does it work with express payment buttons (Apple Pay, Google Pay)?<\/h3><\/dt>\n<dd><p>Those buttons place the order without showing the checkout form, so with the WooCommerce checkout protected they are refused until the visitor ticks the box. Test them on your store, and turn the checkout option off if you rely on them.<\/p><\/dd>\n<dt id=\"i%20use%20the%20wordpress%20mobile%20app.\"><h3>I use the WordPress mobile app.<\/h3><\/dt>\n<dd><p>The app logs in over XML-RPC, which this plugin closes by default because attackers use it to get around the login captcha. Turn off \"Block logins over XML-RPC\" in the settings.<\/p><\/dd>\n<dt id=\"can%20i%20change%20the%20thresholds%3F\"><h3>Can I change the thresholds?<\/h3><\/dt>\n<dd><p>Yes, with the <code>selfcap_config<\/code> filter (timeouts, rate limit, blocking thresholds). Extra hostnames for the same site can be added with the <code>selfcap_hostnames<\/code> filter.<\/p><\/dd>\n<dt id=\"where%20is%20the%20source%20of%20the%20widget%3F\"><h3>Where is the source of the widget?<\/h3><\/dt>\n<dd><p>The readable source of <code>assets\/widget.js<\/code> is in <code>assets\/src\/<\/code>. It is bundled with esbuild.<\/p><\/dd>\n\n<\/dl>\n\n<!--section=changelog-->\n<h4>1.0.3<\/h4>\n\n<ul>\n<li>The widget speaks 15 languages: German, French, Italian, Dutch, Japanese, Chinese, Russian, Polish, Indonesian, Turkish, Persian (right to left) and Swedish join English, Spanish and Portuguese.<\/li>\n<li>The widget and plugin language settings list all of them.<\/li>\n<\/ul>\n\n<h4>1.0.2<\/h4>\n\n<ul>\n<li>Translations of the admin screen now come from translate.wordpress.org (language packs); the plugin no longer ships its own .po\/.mo files in the directory package.<\/li>\n<\/ul>\n\n<h4>1.0.1<\/h4>\n\n<ul>\n<li>Position of the widget on the WooCommerce checkout: above the Place order button (follows the button when the theme moves it), before or after payment, before or after billing, or before any element by CSS selector.<\/li>\n<li>Widget alignment: left, center or right, in a full-width row.<\/li>\n<li>Themes that print the checkout widget twice end up with a single one.<\/li>\n<\/ul>\n\n<h4>1.0.0<\/h4>\n\n<ul>\n<li>First release.<\/li>\n<\/ul>","raw_excerpt":"A privacy-friendly captcha that runs entirely inside your WordPress site. No third-party service, no account, no API keys.","jetpack_sharing_enabled":true,"_links":{"self":[{"href":"https:\/\/tr.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin\/406604","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/tr.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin"}],"about":[{"href":"https:\/\/tr.wordpress.org\/plugins\/wp-json\/wp\/v2\/types\/plugin"}],"replies":[{"embeddable":true,"href":"https:\/\/tr.wordpress.org\/plugins\/wp-json\/wp\/v2\/comments?post=406604"}],"author":[{"embeddable":true,"href":"https:\/\/tr.wordpress.org\/plugins\/wp-json\/wporg\/v1\/users\/christianoerick"}],"wp:attachment":[{"href":"https:\/\/tr.wordpress.org\/plugins\/wp-json\/wp\/v2\/media?parent=406604"}],"wp:term":[{"taxonomy":"plugin_section","embeddable":true,"href":"https:\/\/tr.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_section?post=406604"},{"taxonomy":"plugin_tags","embeddable":true,"href":"https:\/\/tr.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_tags?post=406604"},{"taxonomy":"plugin_category","embeddable":true,"href":"https:\/\/tr.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_category?post=406604"},{"taxonomy":"plugin_contributors","embeddable":true,"href":"https:\/\/tr.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_contributors?post=406604"},{"taxonomy":"plugin_business_model","embeddable":true,"href":"https:\/\/tr.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_business_model?post=406604"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}