﻿=== WCS Custom Permalinks Hotfix ===

Contributors:		LukeAmerica2020
Plugin URI:		http://wpcodesnippets.info/blog/wcs-custom-permalinks-hotfix.html
Tags:			permalinks, permalinks bug, permalinks not working, canonical redirect, categories, tags, pagination, hotfix, wp code snippets, wpCodeSnippets.info, Luke America, LukeAmerica2020, broken permalinks, broken pagination, 404 page, 404 error, Concentric / XO Communications
Author URI:		http://wpCodeSnippets.INFO
Author:			WP Code Snippets (Luke America)
Donate link:		http://wpcodesnippets.info/site-info/support-our-efforts.html
Requires at least:	3.0.0
Tested up to:		3.1.2
Stable tag:		1.1

After upgrading to WordPress 3.1.x, many installations suffer broken permalinks for categories and tags. This hotfix repairs the problem.

== Description ==

This plugin is a hotfix for permalink issues encountered with WordPress installations after upgrading to 3.1.x. **It fixes** the 404 error (or blank page) for menu/dropdown categories and tags. **It fixes** pagination for search results, categories, and tags. And, **it fixes** RSS feeds for categories and tags.

Before using it, be sure that your issues are not caused by plugins that modify category links, tag links, and/or canonical redirection ... by deactivating them. More details are available under *Installation* (above) and at Dashboard->WCS-Permalinks (after activation).

== Installation ==

**Plug-in Usage:**

Install and activate the plug-in. No configuration is needed.

**Standard WordPress installation procedure:**

1. Download the ZIP file to your local computer.
1. Unzip the file's contents.
1. Login as an administrator to your WordPress website.
1. Upload the `wcs-custom-permalinks-hotfix` directory to your `/wp-content/plugins/` directory.
1. Activate the plugin through the WordPress Dashboard->Plugins menu.
1. Visit your home page.
1. Refresh your browser (F5).
1. Verify that the menu/dropdown categories and tags are working.

**Depending on your specific Web browser settings, you may need to:**

1. Clear your browser's cache.
1. Visit your home page.
1. Refresh your browser (F5).
1. And, then test your menus/dropdowns with categories and tags.


**If you're ALSO using a blog cache plug-in, add these steps:**

1. Clear your entire blog cache (with that plug-in's admin panel).
1. Clear your browser's cache.
1. Visit your home page.
1. Refresh your browser twice (F5).
1. Verify that the menu/dropdown categories and tags are working.

**Additional Considerations:**

1. If your WordPress installation resides on a Concentric/XO Communications shared hosting platform, there is an additional issue with permalinks. In this case, visit our [Plug-in Landing Page](http://wpcodesnippets.info/blog/wcs-custom-permalinks-hotfix.html "Plug-in Landing Page") for specific instructions.
1. For additional information regarding your .htaccess file, visit our [Plug-in Landing Page](http://wpcodesnippets.info/blog/wcs-custom-permalinks-hotfix.html "Plug-in Landing Page").

== Changelog ==

= 1.1 =
* 2011-05-07
* added additional details to this readme.txt file and to the dashboard (Dashboard->WCS-Permalinks) information page

= 1.0 =
* 2011-05-05
* official public plugin release

= 0.9.7 =
* 2011-04-11 *(cut/paste prototype functions)*
* added fixes for RSS feeds for categories & tags

= 0.9.5 =
* 2011-04-09 *(cut/paste prototype functions)*
* added hotfix bypass to retain XML-RPC Support

= 0.9.3 =
* 2011-04-08 *(cut/paste prototype functions)*
* added support for multi-sites that use subdirectories

= 0.9.1 =
* 2011-04-05 *(cut/paste prototype functions)*
* added fixes to pagination for searches, categories, & tags

= 0.9.0 =
* 2011-03-23 *(cut/paste prototype function)*
* prototype release at our website


== Upgrade Notice ==

= 1.1 =
Added additional details to the readme.txt file and to the dashboard (Dashboard->WCS-Permalinks) information page.

= 1.0 =
After prototype testing by hundreds of bloggers, you can now implement this hotfix as a plug-in.

== Additional Information ==

* View [details for this plug-in](http://wpcodesnippets.info/blog/wcs-custom-permalinks-hotfix.html "Plug-in Landing Page") at our web site.

* View the full [source code](http://wpcodesnippets.info/blog/how-to-fix-the-wp-3-1-custom-permalinks-bug.html "Source Code Details") explanation for the prototype of this plug-in along with user comments.

* Visit our web site, [wpCodeSnippets.INFO](http://wpcodesnippets.INFO "WP Code Snippets"), for lots of WordPress tips, tweaks, shortcodes, and plugins.

* This plug-in is released under the GNU General Public License (GPL2). No external services are required and there are no additional features to purchase.

== Donations ==

Did you find this plug-in useful? A small [donation](https://www.paypal.com/cgi-bin/webscr?cmd=_donations&currency_code=USD&business=LukeAmerica2020%40gmail.com&item_name=WP%20Code%20Snippets%20donation&amount=0.00&image_url=http://wpcodesnippets.info/files/paypal_header.png "Support Future Development") will support our continued WordPress development efforts. Enter any amount.


== Frequently Asked Questions ==

= Will this plug-in work on multi-sites? =

Yes. Just use Network Activate. Visit your Dashboard. Click *Network Admin* at the top right. Click *Plugins* in the sidebar menu. Locate *WCS Custom Permalinks Hotfix* in the list. Then, click *Network Activate*.

= Will this plug-in absolutely fix my broken permalinks? =

A few hundred bloggers installed the prototype from our website. It fixed the problem for about 85% of these folks.

= What do I do if this doesn't work for my installation? =

View our [development article](http://wpcodesnippets.info/blog/how-to-fix-the-wp-3-1-custom-permalinks-bug.html "Source Code Details") which offers alternative measures both in the article content and visitor comments (including correct .htaccess code). OR, explore these [additional instructions](http://wpcodesnippets.info/blog/wcs-custom-permalinks-hotfix.html "Plug-in Landing Page"). As a last resort, de-activate the plug-in.

= Other questions? =

Leave [questions, comments, and suggestions](http://wpcodesnippets.info/blog/wcs-custom-permalinks-hotfix.html "Plug-in Landing Page") at our web site's plug-in landing page.

= What languages are available? =
Currently, only English is available. Future updates may include additional languages (for the Dashboard information page).

= Can I help? =
Sure! We're in regular need of testers. We have several plug-in prototypes under development at our website. In addition, I could always use help with translations for internationalization.

Visit our website: [wpCodeSnippets.INFO](http://wpcodesnippets.INFO "Visit Our Website").

== Screenshots ==

1. This is a screen shot of the Dashboard information page added by this plug-in.
