Title: WP-Ban Author: Lester Chan Published: January 21, 2007 Last modified: March 9, 2025 --- Search plugins ![](https://ps.w.org/wp-ban/assets/banner-772x250.jpg?rev=1206682) This plugin **hasn’t been tested with the latest 3 major releases of WordPress**. It may no longer be maintained or supported and may have compatibility issues when used with more recent versions of WordPress. ![](https://ps.w.org/wp-ban/assets/icon.svg?rev=978059) # WP-Ban By [Lester Chan](https://profiles.wordpress.org/gamerz/) [Download](https://downloads.wordpress.org/plugin/wp-ban.1.69.2.zip) * [Details](https://li.wordpress.org/plugins/wp-ban/#description) * [Reviews](https://li.wordpress.org/plugins/wp-ban/#reviews) * [Installation](https://li.wordpress.org/plugins/wp-ban/#installation) * [Development](https://li.wordpress.org/plugins/wp-ban/#developers) [Support](https://wordpress.org/support/plugin/wp-ban/) ## Description It will display a custom ban message when the banned IP, IP range, host name or referrer url that tries to visit you blog. You can also exclude certain IPs from being banned. There will be statistics recorded on how many times they attempt to visit your blog. It allows wildcard matching too. ### Development * [https://github.com/lesterchan/wp-ban](https://github.com/lesterchan/wp-ban) ### Translations * [http://dev.wp-plugins.org/browser/wp-ban/i18n/](http://dev.wp-plugins.org/browser/wp-ban/i18n/) ### Credits * Plugin icon by [Dave Gandy](http://fontawesome.io) from [Flaticon](http://www.flaticon.com) ### Donations * I spent most of my free time creating, updating, maintaining and supporting these plugins, if you really love my plugins and could spare me a couple of bucks, I will really appreciate it. If not feel free to use it without any obligations. ### Upgrading 1. Deactivate `WP-Ban` Plugin 2. Open `wp-content/plugins` Folder 3. Put/Overwrite: `Folder: wp-ban` 4. Activate `WP-Ban` Plugin ## Screenshots * [[ * Admin – Ban * [[ * Admin – Ban * [[ * Admin – Ban * [[ * Ban – Message ## Installation 1. Open `wp-content/plugins` Folder 2. Put: `Folder: wp-ban` 3. Activate `WP-Ban` Plugin 4. Go to `WP-Admin -> Settings -> Ban` to configure the plugin ## FAQ N/A ## Reviews ![](https://secure.gravatar.com/avatar/8b6506c01fc72e7070ffb1363bfd2bfeacf0c0f74dbdb6b4daf45ad8113bc227? s=60&d=retro&r=g) ### 󠀁[Can’t get it to do anything](https://wordpress.org/support/topic/cant-get-it-to-do-anything/)󠁿 [hugrat](https://profiles.wordpress.org/hugrat/) October 3, 2020 Probably one of those ban plugins that don’t work if you do not have the exact default wordpress login. Bummer.. ![](https://secure.gravatar.com/avatar/ef2d45f2ff1b7a28c5ed7a409582e4c9ce9e7e23d604ac4b5e0469d693044beb? s=60&d=retro&r=g) ### 󠀁[nice tool](https://wordpress.org/support/topic/nice-tool-134/)󠁿 [kapaemtarik](https://profiles.wordpress.org/kapaemtarik/) April 20, 2020 I have been searching for a tool to get rid of robot users and their advertising comments at my site’s comment section. This extension worked. It successfully blocked 48 entry from 8 different ip adress within one day. Thanks for providing it ![](https://secure.gravatar.com/avatar/4c7a5edc5a2e718802c0aa32c7e9bfaf34d0d3f181785ec59c4acddf2e2612fc? s=60&d=retro&r=g) ### 󠀁[It works!](https://wordpress.org/support/topic/it-works-1102/)󠁿 [luckyjo](https://profiles.wordpress.org/luckyjo/) January 30, 2017 Love your hardwork! ![](https://secure.gravatar.com/avatar/caccb026998170c5ca9c907c5bc18442c3e57ca59588122205d20f568a61480f? s=60&d=retro&r=g) ### 󠀁[Doesn’t work, for whatever reason](https://wordpress.org/support/topic/doesnt-work-for-whatever-reason/)󠁿 [jonrolph](https://profiles.wordpress.org/jonrolph/) December 13, 2016 For whatever reasons, I cannot get this plugin to work. I’ve tried banning both an entire IP range, as well as each IP within that range and I am still receiving visitor reports stating that my site is receiving visitors from that range. ![](https://secure.gravatar.com/avatar/bd5de219c7752dc30c13ee98ad6708885952f4d86d840aeec665171660c0a150? s=60&d=retro&r=g) ### 󠀁[Maybe it works, but definitely slows everything down](https://wordpress.org/support/topic/maybe-it-works-but-definitely-slows-everything-down/)󠁿 [d-phrag](https://profiles.wordpress.org/d-phrag/) September 3, 2016 Not sure if this actually works, but it slowed my admin operations to a very annoying speed. I would rather de-install this one. Sorry ![](https://secure.gravatar.com/avatar/182cfdc93ae660e240675acd5a69c9a90cae4ce49fdf1e2bf8da62ea1bb5b805? s=60&d=retro&r=g) ### 󠀁[website broke on update.](https://wordpress.org/support/topic/website-broke-on-update/)󠁿 [wexler](https://profiles.wordpress.org/wexler/) September 3, 2016 Ended up having to remove the plugin since the website broke as a result of a flaw in the most recent update. [ Read all 28 reviews ](https://wordpress.org/support/plugin/wp-ban/reviews/) ## Contributors & Developers “WP-Ban” is open source software. The following people have contributed to this plugin. Contributors * [ Lester Chan ](https://profiles.wordpress.org/gamerz/) “WP-Ban” has been translated into 2 locales. Thank you to [the translators](https://translate.wordpress.org/projects/wp-plugins/wp-ban/contributors) for their contributions. [Translate “WP-Ban” into your language.](https://translate.wordpress.org/projects/wp-plugins/wp-ban) ### Interested in development? [Browse the code](https://plugins.trac.wordpress.org/browser/wp-ban/), check out the [SVN repository](https://plugins.svn.wordpress.org/wp-ban/), or subscribe to the [development log](https://plugins.trac.wordpress.org/log/wp-ban/) by [RSS](https://plugins.trac.wordpress.org/log/wp-ban/?limit=100&mode=stop_on_copy&format=rss). ## Changelog ### Version 1.69.2 * NEW: Don’t allow to access ban-options.php directly ### Version 1.69.1 * NEW: Fixed XSS ### Version 1.69 * NEW: Bump WordPress 4.7 * FIXED: Notices ### Version 1.68 * NEW: Use translate.wordpress.org to translate the plugin * NEW: Use HTML DOCTYPE * FIXED: Remove get_language_attributes() ### Version 1.67 * FIXED: Notices ### Version 1.66 * FIXED: Cannot redeclare get_language_attributes() ### Version 1.65 * NEW: Supports WordPress Multisite Network Activation * NEW: Uses native WordPress uninstall.php ### Version 1.64 * NEW: Added a new ban option ‘reverse proxy’ to allow user to choose whether to check against HTTP_X_FORWARDED_FOR header for IP. Props Tom Adams at dxw. This fixes [CVE-2014-6230](https://security.dxw.com/advisories/vulnerability-in-wp-ban-allows-visitors-to-bypass-the-ip-blacklist-in-some-configurations/) ### Version 1.63 * FIXED: Notices ### Version 1.62 (12-03-2013) * FIXED: Use a different modifier for preg_match() and use preg_quote() to escape regex ### Version 1.61 (11-03-2013) * FIXED: Replace ereg() with preg_match() ### Version 1.60 (23-05-2012) * NEW: AJAX Preview Of Current Banned Message * NEW: Added nonce To Form * FIXED: Don’t Process Ban If Any Of The Conditions Are Empty ### Version 1.50 (01-06-2009) * NEW: Added “Your User Agent” Details * NEW: Uses jQuery Framework * FIXED: Uses $_SERVER[‘PHP_SELF’] With plugin_basename(**FILE**) Instead Of Just $_SERVER[‘REQUEST_URI’] ### Version 1.40 (12-12-2008) * NEW: Works With WordPress 2.7 Only * NEW: Changed Ban Admin Setting Location To ‘WP-Admin -> Settings -> Ban’ * NEW: Right To Left Language Support by Kambiz R. Khojasteh * NEW: Called ban_textdomain() In ban_init() by Kambiz R. Khojasteh * NEW: Use language_attributes() To Get Attributes Of HTML Tag For Default Template by Kambiz R. Khojasteh ### Version 1.31 (16-07-2008) * NEW: Works With WordPress 2.6 * FIXED: Do Not Ban If IP is “unknown” ### Version 1.30 (01-06-2008) * NEW: Uses /wp-ban/ Folder Instead Of /ban/ * NEW: Uses wp-ban.php Instead Of ban.php * NEW: Uses number_format_i18n() * NEW: IPs Listed In Ban Stats Is Now Sorted Numerically * NEW: Banned By User Agents (By: Jorge Garcia de Bustos) * FIXED: “unknown” IPs (By: Jorge Garcia de Bustos) ### Version 1.20 (01-10-2007) * NEW: Ability To Uninstall WP-Ban * NEW: Moved Ban Options From ban.php To ban-options.php ### Version 1.11 (01-06-2007 * NEW: Banned By Referer URL * NEW: Ability To Exclude Specific IPs From Being Banned * NEW: Added Template Variables For User Attempts Count And Total Attempts Count * FIXED: Suppress gethostbyaddr() Error ### Version 1.10 (01-02-2007) * NEW: Works For WordPress 2.1 Only * NEW: Move ban.php To ban Folder * NEW: Localize WP-Ban * NEW: Added Ban Attempts Statistics In ‘WP-Admin -> Manage -> Ban’ * NEW: Move Ban Tab To ‘WP-Admin -> Manage’ * NEW: Added Toggle All Checkboxes * FIXED: Main Administrator Of The Site Cannot Be Banned ### Version 1.00 (02-01-2007) * NEW: Initial Release ## Meta * Version **1.69.2** * Last updated **1 year ago** * Active installations **9,000+** * WordPress version ** 4.3 or higher ** * Tested up to **6.5.8** * Languages * [Chinese (Taiwan)](https://tw.wordpress.org/plugins/wp-ban/), [English (Canada)](https://en-ca.wordpress.org/plugins/wp-ban/), and [English (US)](https://wordpress.org/plugins/wp-ban/). * [Translate into your language](https://translate.wordpress.org/projects/wp-plugins/wp-ban) * Tags * [ban](https://li.wordpress.org/plugins/tags/ban/)[banned](https://li.wordpress.org/plugins/tags/banned/) [denied](https://li.wordpress.org/plugins/tags/denied/)[deny](https://li.wordpress.org/plugins/tags/deny/) [permission](https://li.wordpress.org/plugins/tags/permission/) * [Advanced View](https://li.wordpress.org/plugins/wp-ban/advanced/) ## Ratings 3.7 out of 5 stars. * [ 16 5-star reviews ](https://wordpress.org/support/plugin/wp-ban/reviews/?filter=5) * [ 2 4-star reviews ](https://wordpress.org/support/plugin/wp-ban/reviews/?filter=4) * [ 0 3-star reviews ](https://wordpress.org/support/plugin/wp-ban/reviews/?filter=3) * [ 2 2-star reviews ](https://wordpress.org/support/plugin/wp-ban/reviews/?filter=2) * [ 7 1-star reviews ](https://wordpress.org/support/plugin/wp-ban/reviews/?filter=1) [Your review](https://wordpress.org/support/plugin/wp-ban/reviews/#new-post) [See all reviews](https://wordpress.org/support/plugin/wp-ban/reviews/) ## Contributors * [ Lester Chan ](https://profiles.wordpress.org/gamerz/) ## Support Got something to say? Need help? [View support forum](https://wordpress.org/support/plugin/wp-ban/) ## Donate Would you like to support the advancement of this plugin? [ Donate to this plugin ](https://lesterchan.net/site/donation/)