=== Banhammer Pro === Plugin Name: Banhammer Pro Plugin URI: https://plugin-planet.com/banhammer-pro/ Description: Monitor traffic and ban unwanted visitors. Tags: ban, block, bots, users Author: Jeff Starr Author URI: https://plugin-planet.com/ Donate link: https://monzillamedia.com/donate.html Contributors: specialk Requires at least: 4.5 Tested up to: 5.0 Stable tag: 1.3 Version: 1.3 Requires PHP: 5.2 Text Domain: banhammer-pro Domain Path: /languages License: The Banhammer Pro license is comprised of two parts (see "License" section below for details) Monitor traffic and ban unwanted visitors. == Description == > Protect your site from enemy hordes! Banhammer Pro gives you complete control over who and what may access your site. Visit the Armory to monitor traffic and review suspicious visitors. If you find some user or bot that is causing problems, you can ban them with a click. Or, if you just want to keep an eye on someone, you can flag them with a warning. Any banned users will be denied access to your site, until you restore access via the Tower. Banhammer Pro gives you many advanced features not available in the free version. https://youtu.be/0t4qBH0TuW0 **GDPR** Banhammer collects user data. The collected data is temporary and automatically deleted every day, or at whatever time interval you specify in the plugin settings. The only time that any data is "remembered" is when you block/ban something. For each person/thing that you block, the plugin stores a minimal amount of data that can be deleted at any time. So this plugin does _not_ do anything to make your site _less_ compliant with GDPR. I have done my best to ensure that this plugin is 100% GDPR compliant, but I'm not a lawyer so can't guarantee anything. To determine if your site is GDPR compliant, please consult an attorney. > Works perfectly with or without Gutenberg Block Editor **Features** Visit the [Banhammer Pro Homepage](https://plugin-planet.com/banhammer-pro/) for features, screenshots, and details. For complete documentation, visit the Help tab on any Banhammer screen in the WP Admin Area. **Getting Started** The Quick Start Guide is highly recommended: * [Banhammer Pro Quick-Start Guide](https://plugin-planet.com/banhammer-pro-quick-start/) **Documentation** Banhammer Pro documentation: * [Banhammer Pro Settings](https://plugin-planet.com/banhammer-pro-settings/) * [Banhammer Pro Armory](https://plugin-planet.com/banhammer-pro-armory/) * [Banhammer Pro Tower](https://plugin-planet.com/banhammer-pro-tower/) **Resources** Further resources and information: * [Banhammer Pro Docs](https://plugin-planet.com/docs/banhammer/) * [Banhammer Pro Forum](https://plugin-planet.com/forum/banhammer/) * [Banhammer Pro Tutorials](https://plugin-planet.com/category/tuts+banhammer-pro/) * [Banhammer Pro FAQs](https://plugin-planet.com/banhammer-pro-faqs/) **Stay Current** Stay current with Banhammer Pro! * [Banhammer Pro News](https://plugin-planet.com/category/news+banhammer-pro/) * [Grab the News Feed](https://plugin-planet.com/category/news/feed/) * [Grab the Tutorials Feed](https://plugin-planet.com/category/tuts/feed/) **Getting Help** There are two channels for getting help: * [Ask a question in the Banhammer Pro Forum](https://plugin-planet.com/forum/banhammer/) ([login required](https://plugin-planet.com/wp/wp-login.php)) * [Send an email via the contact form](https://plugin-planet.com/banhammer-pro/#contact) The contact form is best for direct support, bug reports, and feedback. **Downloads** * [Log in to your account for current downloads](https://plugin-planet.com/wp/wp-login.php) To learn more about Banhammer Pro, visit [Plugin-Planet.com](https://plugin-planet.com/banhammer-pro/). For complete documentation, visit the Help tab on any Banhammer screen in the WP Admin Area. == Installation == **Important: PHP Requirement** Before installing, make sure your server has either `cURL` or `file_get_contents()` enabled. Banhammer requires at least one of these functions to do its thing. **Installation** 1. Upload the plugin and activate via the WP Plugins screen 2. Visit Banhammer Pro > License to enter your license Done. Banhammer Pro is now ready for use. For complete documentation, visit the Help tab on any Banhammer screen in the WP Admin Area. [More info on installing WP plugins](http://codex.wordpress.org/Managing_Plugins#Installing_Plugins). **Usage** 1. Configure the plugin settings as desired 2. Visit the Armory to monitor traffic and ban/warn any unwanted visitors 3. Visit the Tower to manage any banned/warned targets Also check out the [Banhammer Pro Quick Start Guide](https://plugin-planet.com/banhammer-pro-quick-start/). For complete documentation, visit the Help tab on any Banhammer screen in the WP Admin Area. **Caching Plugins** Banhammer works with any type of caching plugin where "page caching" is not enabled. There are many types of cache plugins. They provide all sorts of different caching mechanisms and features. All caching features work great with Banhammer except for “page caching”. With page caching, the required WP `init` hook may not be fired, which means that plugins like Banhammer are not able to log and ban requests dynamically. Fortunately, some of the most popular caching plugins provide settings that enable full compatibility with Banhammer. For a complete list, check out [this article](https://plugin-planet.com/blackhole-pro-cache-plugins/). Note: that article was written for [Blackhole Pro](https://plugin-planet.com/blackhole-pro/), but the compatibility list and general info apply also to Banhammer. **With great power..** Please be careful not to ban any important IP addresses. Before banning some target, verify the IP and host name. Verifying the IP address is important because you do not want to accidentally ban major search engines and services. A good way to verify any IP address is to do a reverse lookup. The result should match the host name. For an example of how to verify a bot, check out [this article](https://perishablepress.com/spoofed-search-engine-bot/) at Perishable Press. _Pro Tip: In the Armory, you can click on the IP Address or Host Name to do a quick whois lookup._ **Important! Don’t ban yourself!** Please be careful not to ban yourself when using Banhammer. The Basic Settings are powerful; use them wisely. Here are some things that can help mitigate any accidents: * Be mindful when monitoring traffic; always know your own IP address and WP username. * Disable the setting "Login Page", so you always have access to the Login Page. * Enable the setting "Ignore Users", so you always can access the Tower, and your own visits will not be logged in the Armory. **Whoops! How do I get back in?** It's almost inevitable. Worst-case scenario say you accidentally ban yourself. As site admin, it is easy to restore access. Follow these steps: 1. [Download the Banhammer Unlock plugin](https://plugin-planet.com/wp/addons/banhammer-unlock.zip) 2. Upload the Unlock plugin to your server at: `/wp-content/mu-plugins/` 3. If the mu-plugins directory does not exist, go ahead and create it 4. After uploading the plugin, Banhammer will be disabled, so you can log in and restore access via the Tower 5. Once you have restored access, delete the Banhammer Unlock plugin from the server 6. After deleting the Unlock plugin, Banhammer once again will be enabled Alternately, if you banned yourself by IP address, you can bypass the ban by using a trustworthy proxy service to log in to your site. **Restore Default Options** To restore default plugin options, visit "Reset Options" in the plugin settings. **Uninstalling** This plugin cleans up after itself. All plugin options and collected data will be removed from your database when the plugin is uninstalled via the Plugins screen. **License Information** * [Download purchased plugin](https://plugin-planet.com/download-purchased-plugin/) * [Install purchased plugin](https://plugin-planet.com/install-plugin/) * [Upgrade purchased plugin](https://plugin-planet.com/upgrade-plugin/) * [Get plugin license key](https://plugin-planet.com/get-license-key/) * [Activate plugin license](https://plugin-planet.com/activate-deactivate-plugin-license/) * [Transfer plugin license](https://plugin-planet.com/transfer-plugin-license/) * [Manage licensed domains](https://plugin-planet.com/manage-license/) * [Download purchase receipt](https://plugin-planet.com/download-purchase-receipt/) * [Troubleshooting license activation](https://plugin-planet.com/troubleshooting-license-activation/) **License for Sound Effects** Audio used in plugin * [Explosion sound by steveygos93](https://freesound.org/s/80401/): [Attribution 3.0 Unported (CC BY 3.0)](https://creativecommons.org/licenses/by/3.0/) * [Inception Horn sound by Kubatko](https://freesound.org/s/196584/): [CC0 1.0 Universal (CC0 1.0)](https://creativecommons.org/publicdomain/zero/1.0/) * [Shield Guard sound by nekoninja](https://freesound.org/s/370203/): [CC0 1.0 Universal (CC0 1.0)](https://creativecommons.org/publicdomain/zero/1.0/) * [Lettuce Chopping sound by danloss](https://freesound.org/s/412531/): [CC0 1.0 Universal (CC0 1.0)](https://creativecommons.org/publicdomain/zero/1.0/) Audio used in promos * [War Drum Loop by limetoe](https://freesound.org/s/274223/): [CC0 1.0 Universal (CC0 1.0)](https://creativecommons.org/publicdomain/zero/1.0/) * [Warrior Drums by Sclolex](https://freesound.org/s/209546/): [CC0 1.0 Universal (CC0 1.0)](https://creativecommons.org/publicdomain/zero/1.0/) **Whois Lookups** Banhammer Pro uses [ipapi.co](https://ipapi.co/) for the Geo/IP lookups. Their service is free and awesome :) **Like the plugin?** If you like Banhammer Pro, please take a moment to [give a 5-star rating](https://wordpress.org/support/plugin/banhammer/reviews/?rate=5#new-post). It helps to keep development and support going strong. Thank you! == Upgrade Notice == Upgrades: Your purchase of Banhammer Pro includes free lifetime upgrades, which include new features, bug fixes, and other improvements. When an upgrade is available, WordPress will notify you in the Admin Area. When you see that there is an update available, just click "Update" and WordPress will perform the upgrade automatically. Note that you can [download the latest version of Banhammer Pro at Plugin Planet](https://plugin-planet.com/download-purchased-plugin/) anytime at your convenience. __Note:__ uninstalling the plugin from the WP Plugins screen results in the removal of all options and data from the WP database. _For complete documentation, visit the Help tab on any Banhammer screen in the WP Admin Area._ == Frequently Asked Questions == **FAQs** FAQs available online: * [Banhammer Pro FAQs](https://plugin-planet.com/banhammer-pro-faqs/) **Questions? Feedback? Bugs?** There are two channels for getting help: * [Ask a question in the Banhammer Pro Forum](https://plugin-planet.com/forum/banhammer/) ([login required](https://plugin-planet.com/wp/wp-login.php)) * [Send an email via the contact form](https://plugin-planet.com/banhammer-pro/#contact) The contact form is best for direct support, bug reports, and feedback. == Screenshots == Screenshots and more available at [Plugin-Planet.com](https://plugin-planet.com/banhammer-pro/#screenshots). == License == License: The Banhammer Pro license is comprised of two parts: * Part 1: Its PHP code is licensed under the GPL (v2 or later), like WordPress. More info @ http://www.gnu.org/licenses/ * Part 2: Everything else (e.g., CSS, HTML, JavaScript, images, design) is licensed according to the purchased license. More info @ https://plugin-planet.com/banhammer-pro/ Without prior written consent from Monzilla Media, you must NOT directly or indirectly: license, sub-license, sell, resell, or provide for free any aspect or component of Part 2. Further license information is available in the plugin directory, /license/, and online @ https://plugin-planet.com/wp/files/banhammer-pro/license.txt Upgrades: Your purchase of Banhammer Pro includes free lifetime upgrades, which include new features, bug fixes, and other improvements. Copyright 2018 Monzilla Media. All rights reserved. == Thank You == Thank You to Jennifer Starr for her insight and help with testing and usability. == Check out my other plugins! == Free WordPress plugins: * [Banhammer](https://wordpress.org/plugins/banhammer/) * [Host Header Injection Fix](https://wordpress.org/plugins/host-header-injection-fix/) * [Blackhole for Bad Bots](https://wordpress.org/plugins/blackhole-bad-bots/) * [BBQ: Block Bad Queries](https://wordpress.org/plugins/block-bad-queries/) * [Contact Coldform](https://wordpress.org/plugins/contact-coldform/) * [Dashboard Widgets Suite](https://wordpress.org/plugins/dashboard-widgets-suite/) * [GA Google Analytics](https://wordpress.org/plugins/ga-google-analytics/) * [Head Meta Data](https://wordpress.org/plugins/head-meta-data/) * [Show Support Ribbon](https://wordpress.org/plugins/show-support-ribbon/) * [Simple Ajax Chat](https://wordpress.org/plugins/simple-ajax-chat/) * [Simple Basic Contact Form](https://wordpress.org/plugins/simple-basic-contact-form/) * [Simple Blog Stats](https://wordpress.org/plugins/simple-blog-stats/) * [Simple Custom Content](https://wordpress.org/plugins/simple-custom-content/) * [Simple Feed Stats](https://wordpress.org/plugins/simple-feed-stats/) * [User Submitted Posts](https://wordpress.org/plugins/user-submitted-posts/) * [Theme Switcha](https://wordpress.org/plugins/theme-switcha/) * [Prismatic](https://wordpress.org/plugins/prismatic/) * [AddMySite](https://perishablepress.com/addmysite-plugin-for-wordpress/) Premium WordPress plugins: * [Banhammer Pro](https://plugin-planet.com/banhammer-pro/) - Monitor traffic and ban bad users and bots * [BBQ Pro](https://plugin-planet.com/bbq-pro/) - Fastest firewall plugin for WordPress * [Blackhole Pro](https://plugin-planet.com/blackhole-pro/) - Block bad bots in a virtual black hole * [SES Pro](https://plugin-planet.com/ses-pro/) - Ajax-powered email signup forms * [USP Pro](https://plugin-planet.com/usp-pro/) - Advanced front-end forms More awesome plugins on the way :) == Changelog == **1.3 (2018/11/18)** * Fixes bug with cron not working * Fixes bug with `banhammer-process_` query args * Replaces `geoip.tools` lookup service with [ipapi.co](https://ipapi.co/) * Tests on WordPress 5.0 (beta) **1.2 (2018/08/22)** * Replaces `freegeoip.net` with [geoip.tools](https://geoip.tools/) for Geo Lookups * Adds `rel="noopener noreferrer"` to all [blank-target links](https://perishablepress.com/wordpress-blank-target-vulnerability/) * Updates contextual Help tab with better infos * Updates `WPSimpleNonce` to support older versions of PHP * Updates GDPR blurb and donate link * Regenerates default translation template * Further tests on WP 4.9 and 5.0 (alpha) **1.1 (2018/05/10)** * Adds feature to manually add targets * Strengthens security protocols in Banhammer core * Improves support for caching plugins * Adds automatic import of Tower data from free version * Updates default set of whitelisted user agents * Updates default set of whitelisted IP addresses * Changes "Previous" to "Prev" on Armory nav button * Replaces ip-api.com with whatismyipaddress.com * Adds filter hook, `banhammer_armory_mask` * Lightens color of target select menu * Adds sound effects to bulk actions * Generates new translation template * Updates plugin image files * Tests on WordPress 5.0 **1.0 (2018/01/31)** * Initial release