=== Worst Offenders ===
Contributors: ear1grey
Donate link: http://boakes.org/
Tags: comments, spam
Requires at least: 2.5
Tested up to: 2.5
Stable tag: 3.0.alpha2

Worst Offenders works cooperatively with other anti-spam plugins: its primary purpose is identifying and deleting the comments that are 100% definitely spam so that any false-positives can be easily found.

== Description ==

NOTE: Worst Offenders for Wordpress 2.5 is currently a pre-alpha release for developer feedback only.

If you use any anti-spam tool you will no doubt be delighted that spam can be automatically identified, but less happy that you now have to either trawl through the spam to check for false positives, or just give up and hope for the best - this is where Worst Offenders can help: it analyses messages already marked as spam and uses several techniques to identify messages with common sources, subjects and content - those which are definitely spam.  These _Worst Offenders_ can be deleted en-masse, hopefully leaving just a handful of messages that can be checked by hand.

== Installation ==

1. Upload the wo3 Folder to to the `/wp-content/plugins/` directory
1. Activate the plugin through the 'Plugins' menu in WordPress
1. Check out the WorstOffenders tab under the main Comments tab.

== Frequently Asked Questions ==

= How are the worst offenders identified =

A series of litmus tests has been defined, each test looks for different clues that may (when seen together) make it obvious that a message really is spam.  for example, the IP test looks for multiple messages that come from the same IP address.

= What litmus tests are there? =

1. IP Address - multiple messages from one source.
1. MD5 - multiple messages where the body text has the same MD5 hash
1. Link Count - messages that contain more than n Links.
1. Domain - Messages advertising the same URL
1. Email - multiple messages from one email address.
1. Name length - messages where the author name has more than 5 words

= Can more litmus tests be devised? =

Yes, the test system is plugabble.

== Screenshots ==

1. This screen shot description corresponds to screenshot-1.(png|jpg|jpeg|gif). Note that the screenshot is taken from
the directory of the stable readme.txt, so in this case, `/tags/4.3/screenshot-1.png` (or jpg, jpeg, gif)

== To do ==
Switch to using wp_cache wherever options were used
Improve count function to remove duplicates

