=== Category Order ===
Tags: categories, structure, order
Contributors: coppit

This plugin allows the blog administrator to set an explicit ordering,
spacing, and indentation of categories in the category list that appears in
the sidebar. The administrator specifies the ordering in the new "Category
Order" management page. There is also an option for placing the category post
count inside the link, and an option to "fold" subcategories until the parent
category is selected.

The plugin overrides any ordering or indentation of categories created by the
list_cats() Wordpress function. It works by dissecting the normal <ul> or
<br/> formatted list that Wordpress creates, then reconstructing a custom <ul>
or <br/> formatted list based on the new custom ordering and indentation.
Note that it overrides any parent-child relationship between categories.
Since the plugin modifies the display only, you can revert to the default
ordering by simply disabling the plugin.

Note that category slugs need not be unique, and some permalink styles use
slugs instead of IDs to represent categories. This means that Category Order
will be unable to tell such categories apart. The plugin will detect this
situation and ask you to either change your permalink style or disambiguate
your slugs.

The latest version can be found at http://www.coppit.org/code/

This plugin is designed for Wordpress 2.

== Installation ==

1. Upload the 'category-order' folder to your plugins folder, usually
   'wp-content/plugins/'
2. Activate the plugin in the plugin screen.
3. Go to 'Category Order' under the 'Manage' menu to change the ordering and
   indenting.

== Known Bugs ==

The plugin is sensitive to the HTML generated by WordPress. If the plugin
fails for you, it is likely that your category list HTML is somewhat different
than what the plugin expects. In this case, the plugin should automatically
detect a problem and display a yellow message at the top of the webpage.
Follow the instructions in that message to help me fix the problem.

If the plugin fails to display the message, but you still think there is
something wrong, please do the following:

1. Disable the plugin
2. Reload your blog in your web browser
3. View the source of your blog
4. Email the HTML snippet for the category list to the me

There is an apparent incompatibility between this plugin and the Opt-in Front
Page plugin (http://www.semiologic.com/software/opt-in-front/). I have
contacted the author and hope to resolve the issue soon. This plugin is also
incompatible with the Fold Category List plugin, but this functionality is now
part of Category Order so Fold Category List is unnecessary.

== License ==

This code is distributed under the terms of the GPL.

== Credits ==

The primary author is David Coppit <http://www.coppit.org>.

The functionality of this plugin is based primarily on the "Explicit Category
Order" plugin originally developed by pericat
(http://wordpress.org/support/topic/24026) and then modified by Thad Buzolich
(http://www.buzolich.com/techtips/category-order/). The primary difference
between their plugins and this one is that theirs uses a textual specification
language for the ordering, whereas this one uses a more intuitive GUI
interface. See the changelog for other differences.

pericat's filename: perisort.php
Buzolich's filename: categoryOrder.php
My filenames: category-order.php, category-order-management.php, plus .gifs
