pagemash/README.txt

=== pageMash > pageManagement ===
Contributors: JoelStarnes
Tags: order pages, ajax, re-order, drag-and-drop, admin,
Requires at least: 2.0
Tested up to: 2.4-bleeding
Stable tag: 0.1.2

Organise your page order with this simple drag-and-drop Ajax interface.

== Description ==

Customise the order your pages are listed in with a simple Ajax drag-and-drop administrative interface with an option to toggle the page visibility. Great tool to quickly re-arrange your menus.

If you want to see an example of the admin page check out: http://joelstarnes.co.uk/pagemash/example

== Installation ==

1. Download Plugin
1. Unzip & Upload to `/wp-content/plugins/`
1. Activate in 'Plugins' admin menu
1. {Edit your Template}

In most cases the plugin should work straight out the box, since most templates will include something similar to: `wp_list_pages('depth=1&title_li=);`


However to achieve full functionality including the 'exclude pages' feature you should replace the wp_list_pages() function with the following php code:

 `if(function_exists('pageMash_exclude_pages'))`
 `{$exclude_pages=pageMash_exclude_pages();} else{$exclude_pages='';}`
 `wp_list_pages('depth=1&title_li=&exclude='.$exclude_pages);`


You can place the code wherever you would like your page listings to appear;
usually either the header.php or sidebar.php file found in: `wp-content\themes\theme_name`

== Frequently Asked Questions ==

If you have any questions or comments,
please drop me an email: joel@joelstarnes.co.uk


= Can I use this with the 'Pages' sidebar widget? =
Yes. Go into the wordpress admin; Presentation > Widgets and drag the pages widget to the sidebar, then go to it's settings by clicking the icon on the right and ensure that 'sort by' value is set to 'page order'.
Note however that the exclude pages feature will not work, so disable this in the top of the pagemash.php file by setting '$excludePagesFeature = false;'.

== Screenshots ==

1. Admin Interface.

2. If you are having problems using the pages widget; goto [Admin > Presentation > Widgets] and check that the 'sort by' value is set to 'page order'.

== Localization ==

Currently only available in english.

== Limitations==

The plugin will currently only handle top level pages.

==Change Log==

0.1.0 > Initial Release

0.1.1 > Removed version check [line72] since some hosts will not allow external includes.

0.1.2 > Fixed CSS&JS headers to only display on pageMash admin


==Road Map==

For the next majour release I hope to support children pages and allow these to be sorted and moved between different parents in a nested list fashion.