=== Plugin Name ===
Contributors: Victoria Scales
Tags: traffic, visit, monitor, firewall, block, filter, reject, stop, limit, hits
Requires at least: 3.0
Tested up to: 3.0.4
Donate link: http://www.amazon.co.uk/wishlist/2FRM957UJWLZ2
Stable tag: trunk

VSF Simple Block plugin. Allows you to select IP addresses, Hosts or Browser summary keywords via the simple block admin page to filter hits with.  Acts as a sort of software firewall.  

== Description ==
Simple Block does what it says really.  It's effectively a software firewall of sorts.  Enter an IP Address (or an IP range) or a host or a browser summary or a regular expression for host into the block rules table and save it.  Then watch as visitors that match those entries are bounced and cannot access your site.

Block Rules:
IP address is an exact match.  
IP range is an exact match to the specified range.  
Host is a like match, so if you enter for example google, anything that has google in the host anywhere will be blocked.  
Browser summary works just like Host.  Add in a value like spider and any hit on your website that contains spider in the browser summary anywhere will be blocked.
Regular Expression on host is a pattern matching to a host value.  See http://dev.mysql.com/doc/refman/5.1/en/regexp.html for examples of regexp in mysql.

In the settings page enter a bounce address of your chosing which will be used to "forward" the users on to if they match a record in the block table.

Filter Rules:
There is also a filter table which is read before the bounce address.  Values in this allow hits from users that match in exactly the same way as the block table.  Because this is queried before the block table any matches will be allowed through.

Block Records:
Is a list of all hits that have been bounced and also a single reason why.  for example if you have a block record for browser summary - bot - and the google bot arrives on your site, you will get a record that the google bot has been bounced. (I don't recommend blocking the google bot)

Also:
Auto block is not (coded) enabled yet.  Work in progress.
Import and Export does work, but hasn't been used a lot yet.

Please note that this plugin has the ability to block you if misused!  Please be very careful when using this plugin.  This plugin requires database rights to create tables and also create and run a stored procedure.  Without those database rights this plugin will not be able to function.

== Installation ==

1. Download and extract it
2. Copy vsf-simple-block folder to the "/wp-content/plugins/" directory
3. Activate the plugin through the 'Plugins' menu in WordPress
4. Done

== Frequently Asked Questions ==

= I'm getting an error during export / import =

Go to the plugin website and post a comment on the simple block page with as much information as possible please.

== Screenshots ==

1. Image of the admin page block records table
2. Image of the admin page filter rules table
3. Image of the admin page block rules table

== Changelog ==

= 0.2 =
Added spider trap information and page to the project.

= 0.1 =
First and stable version.