=== 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¤cy_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.