Skip to content
WordPress.org
  • Showcase
  • Plugins
  • Themes
  • Hosting
  • News
    • Learn WordPress
    • Documentation
    • Education
    • Forums
    • Developers
    • Blocks
    • Patterns
    • Photos
    • Openverse ↗︎
    • WordPress.tv ↗︎
    • About WordPress
    • Make WordPress
    • Events
    • Five for the Future
    • Enterprise
    • Gutenberg ↗︎
    • Job Board ↗︎
  • Swag ↗︎
  • Get WordPress
Get WordPress
WordPress.org

Plugin Directory

CodingCush Login Guard

  • Submit a plugin
  • My favorites
  • Log in
  • Submit a plugin
  • My favorites
  • Log in

CodingCush Login Guard

By codingcush
Download
  • Details
  • Reviews
  • Installation
  • Development
Support

Description

CodingCush Login Guard protects your WordPress login from password-guessing bots, and makes sure you can always get back in.

Failed logins are counted per IP address. When an address reaches the limit it is locked out for a while, and addresses that keep coming back get a long lockout. If you lock yourself out, the login screen offers an “Email me an unlock link” option: administrators receive a one-time link that lifts the lockout for their device.

Features

  • Login attempt limits – choose how many failed attempts are allowed, how long a lockout lasts, and when repeat offenders get a long lockout.
  • Attempts remaining – optionally show “2 attempts remaining.” under the login error.
  • Email unlock link – a locked-out administrator can request a one-time link (valid for 15 minutes). It only lifts the lockout; the password is still required.
  • IP allow list and block list – single addresses or CIDR ranges, IPv4 and IPv6. Your own address can never be saved to the block list.
  • Correct visitor IP behind proxies – choose direct connection, Cloudflare, X-Forwarded-For or X-Real-IP. The screen shows which headers your server actually sends.
  • Cloudflare Turnstile – a free, privacy-friendly CAPTCHA alternative on the login, registration and lost-password forms, and on the WooCommerce My Account forms. Off until you add your own keys.
  • Activity log – every failed login, lockout, unlock and Turnstile failure, with filters and search, plus the usernames attackers try most.
  • One-click unlock – unlock a single address or every lockout from the Overview screen.
  • Lockout emails – get an email for every lockout, only for long lockouts, or never.
  • Settings import – copies settings, allow lists and block lists from Limit Login Attempts or Limit Login Attempts Reloaded if they are installed.
  • Works with XML-RPC, application passwords and WooCommerce – every login path goes through the same limits.

Lightweight

  • Lockout state is kept in transients, so a normal page view does no extra database work.
  • The admin CSS and JavaScript load only on the plugin’s own settings screen.
  • The Turnstile script loads only on the forms you protect, and only after you add your keys.
  • Uninstalling removes the settings, the log table and every lockout.

External services

This plugin can connect to Cloudflare Turnstile, a service that checks whether a form is being submitted by a person or a bot. It is used only if you enter a Turnstile site key and secret key in Settings → Login Guard → Turnstile; until then nothing is sent to Cloudflare.

When Turnstile is on:

  • The protected forms (the ones you choose: login, registration, lost password and WooCommerce My Account) load Cloudflare’s widget script from https://challenges.cloudflare.com/turnstile/v0/api.js. The widget runs in the visitor’s browser and Cloudflare receives the usual browser data needed to run the check.
  • When one of those forms is submitted, the plugin sends the widget’s response token, your secret key and the visitor’s IP address to https://challenges.cloudflare.com/turnstile/v0/siteverify to confirm the check passed.

The service is provided by Cloudflare, Inc. Terms of service · Privacy policy · Turnstile privacy addendum.

No other external requests are made. The plugin has no tracking and does not contact CodingCush.

Screenshots

Overview: failed logins, lockouts, the activity log and one-click unlock.
Overview: failed logins, lockouts, the activity log and one-click unlock.
Login limits with a plain-language summary of what the settings do.
Login limits with a plain-language summary of what the settings do.
IP rules: pick the IP source your server really uses, plus allow and block lists.
IP rules: pick the IP source your server really uses, plus allow and block lists.
Cloudflare Turnstile: add your keys and choose which forms to protect (login, registration, lost password, WooCommerce).
Cloudflare Turnstile: add your keys and choose which forms to protect (login, registration, lost password, WooCommerce).
The lockout message with the email unlock link on the login screen.
The lockout message with the email unlock link on the login screen.

Installation

  1. In your dashboard go to Plugins → Add New, search for “CodingCush Login Guard”, then click Install Now and Activate.
  2. Open Settings → Login Guard. Protection is on straight away with sensible defaults (4 attempts, 20-minute lockout, 24-hour lockout after 4 lockouts in a day).
  3. If your site is behind Cloudflare or another proxy, open the IP rules tab and choose where the visitor’s IP address comes from.
  4. Optional: add Cloudflare Turnstile keys on the Turnstile tab.

FAQ

What happens if I lock myself out?

On the login screen, under the lockout message, click “Locked out? Email me an unlock link”, and enter your administrator username or email address. Open the link from the email on the same device and you can log in again. You can also add your IP address to the allow list in advance (there is a one-click button on the Overview tab).

Does the unlock link log me in?

No. It only lifts the lockout for the device that opens it, for one hour. You still need your password. Links work once, expire after 15 minutes and are only sent to accounts that can manage the site.

My site is behind Cloudflare and every visitor has the same IP.

Open Settings → Login Guard → IP rules and choose “Cloudflare (CF-Connecting-IP)”. The screen shows which headers your server receives so you can pick the right one. Only choose a proxy header if your site really is behind that proxy.

Is Turnstile required?

No. The login limits work on their own. Turnstile adds a second layer that stops most bots before they even try a password.

Does it work with WooCommerce?

Yes. WooCommerce logins count towards the same limits, and Turnstile can be added to the My Account login, registration and lost password forms.

Does it protect XML-RPC and application passwords?

Yes. Those logins go through the same check, so a locked-out address is refused everywhere. Turnstile is skipped for them because there is no form to show it on.

Can I use it alongside another login-limiting plugin?

It is best to use one. If you are switching from Limit Login Attempts, use Tools → Import to copy your settings, then deactivate the other plugin so failed logins are not counted twice.

What is removed when I delete the plugin?

Everything: the settings, the activity log table, running lockouts and any unused unlock links.

Reviews

There are no reviews for this plugin.

Contributors & Developers

“CodingCush Login Guard” is open source software. The following people have contributed to this plugin.

Contributors
  • codingcush

Translate “CodingCush Login Guard” into your language.

Interested in development?

Browse the code, check out the SVN repository, or subscribe to the development log by RSS.

Changelog

1.0.0

  • First release.

Meta

  • Version 1.0.0
  • Last updated 8 hours ago
  • Active installations Fewer than 10
  • WordPress version 6.2 or higher
  • Tested up to 7.1.4
  • PHP version 7.4 or higher
  • Tags
    Brute Forcecaptchalimit login attemptslogin securityturnstile
  • Advanced View

Ratings

No reviews have been submitted yet.

Your review

See all reviews

Contributors

  • codingcush

Support

Got something to say? Need help?

View support forum

  • About
  • News
  • Hosting
  • Privacy
  • Showcase
  • Themes
  • Plugins
  • Patterns
  • Learn
  • Documentation
  • Developers
  • WordPress.tv ↗
  • Get Involved
  • Events
  • Donate ↗
  • Swag ↗
  • WordPress.com ↗
  • Matt ↗
  • bbPress ↗
  • BuddyPress ↗
WordPress.org

The WordPress® trademark is the intellectual property of the WordPress Foundation.

  • Visit our X (formerly Twitter) account
  • Visit our Bluesky account
  • Visit our Mastodon account
  • Visit our Threads account
  • Visit our Facebook page
  • Visit our Instagram account
  • Visit our LinkedIn account
  • Visit our TikTok account
  • Visit our YouTube channel
  • Visit our Tumblr account
Code is Poetry