=== Permalink Finder Plugin ===
Tags: permalinks, move, migrate, 301, 404, redirect, PageRank, seo,sitemap, robots.txt, crossdomain.xml, apple-touch-icon.png, favicon.ico
Requires at least: 3.0
Stable tag: 2.0
Tested up to: 3.5
Contributors: Keith Graham
Donate link: Donate link: http://www.blogseye.com/buy-the-book/
Never get a 404 page not found again. If you have restructured or moved your blog, this plugin will find the right post or page every time.
== Description ==
The Permalink Finder Plugin detects when Wordpress cannot find a permalink. Before it generates the 404 error the plugin tries to locate any posts with similar words. It does this by searching through the database trying to find any of the word values from the bad link. It takes the best match and then, rather than issuing a 404 error, it sends back a redirect to the correct page.
Users will see the page that they are looking for, and search engine spiders will see the 301 redirect and update their databases so that the page appears correctly in searches.
This is especially useful where Wordpress removes words like "the" and "a" from the permalink during conversions from Blogger.com accounts. It is also useful for migrations that formerly used extensions such as html and shtml, when Wordpress does not.
The configuration panel allows a user to select how the plugin finds a missing page. The plugin counts the number of words that match to a post. By default, a two word match is sufficient to cause a redirect to the found page. False positives are possible, especially if the user selects a one word match. Increasing the number of words, however makes it unlikely that the plugin will ever find a match. You may eliminate numbers from the search. You may specify that a list of common English words like "the", "and", "who", "you", etc., not be considered in finding the correct permalink.
Optionally, the plugin will redirect hits on index.html, index.htm, and index.shtml to the blog home page. This is useful when a website previously used a non-php home page.
If WordPress detects a 404 error on robots.txt, sitemap.xml, crossdomain.xml, favicon.ico, or apple-touch-icon.png it will provide a default version.
The plugin will also optionally keep track of the last few 404's or redirects. This is useful to find out what pages are missing or named badly that keep causing 404 errors or forcing redirects.
== Installation ==
1. Download the plugin.
2. Upload the plugin to your wp-content/plugins directory.
3. Activate the plugin.
4. Change any options in the Permalink Finder settings.
The plugin can be tested by adding or deleting words from a working permalink in your browser address area. Even if you mangle the permalink it should find a valid link and almost always it will find the correct link.
== Changelog ==
= 1.0 =
* initial release
= 1.1 =
* added ability select degree of matching on bad urls.
* added the ability to redirect index.htm, index.html and index.shtml to blog home page.
* fixed a stupid name in the install directory - should be "permalink-finder" no s.
= 1.11 =
* 10/26/2009 Fixed index option to work on PHP4 on some servers.
= 1.20 =
* 11/04/2009 Added a short log of fixed and unfixed permalinks.
= 1.21 =
* 11/24/2009 Fixed a bug in recording the permalinks that caused a 500 error. Formatted the urls as links in the report.
= 1.30 =
* 01/10/2010 added uninstall procedure. Add links to 404 area of report.
= 1.40 =
* 02/23/2010 Fixed errors setting and unsetting variables.
= 1.50 =
* 04/29/2010 Changed redirect method for to make the plugin compatible with future versions of Wordpress.
= 1.60 =
* 01/14/2011 Cleaned up code. Added support for MU. Used wordpress functions to sanitize urls and find alternate encodings.
* This revision changed the way the plugin works, so please let me know if you experience any problems.
= 1.70 =
* Due to many suggestions for features: Added code to strip “GET” parameters like UTM tags. Added code to optionally strip numbers, common words, and short words.
= 2.00 =
* Rewrote entire plugin to be more compatible with new versions of WordPress. Simplified the code and added extra steps to sanitize data and increase security. Added support for default robots.txt, sitemap.xml, crossdomain.xml, favicon.ico, or apple-touch-icon.png files. Added metaphone search. Ignores 404 errors on wp-login and wp-signup from trolls. Sanitizes data so there is less chance of options and logs being reset.
== Support ==
This plugin is free and I expect nothing in return. Please rate the plugin at: http://wordpress.org/extend/plugins/permalink-finder/
If you wish to support my programming, buy my book:
Error Message Eyes: A Programmer's Guide to the Digital Soul
Other plugins:
Stop Spammers Plugin
Open in New Window Plugin
Kindle This - publish blog to user's Kindle
Stop Spammer Registrations Plugin
No Right Click Images Plugin
Collapse Page and Category Plugin
Custom Post Type List Widget