=== Multi-level Navigation Plugin ===
Contributors: ryanhellyer
Donate link: http://pixopoint.com/premium_support/
Tags: dropdown, menu, flyout, navigation, suckerfish
Requires at least: 2.3
Tested up to: 2.7.1
Stable tag: 2.0

Description: Adds a CSS based dropdown/flyout/slider menu to your WordPress blog. Visit the <a href="http://pixopoint.com/multi-level-navigation/">Multi-level Navigation Plugin page</a> for more information about the plugin, our navigation <a href="http://pixopoint.com/forum/index.php?board=4.0">support board</a> for help with adding the menu to your theme or the <a href="http://pixopoint.com/generator/">PixoPoint Template Generator</a> to obtain a customizable pre-supported (no theme editing neccessary) theme. Paid premium support for this plugin is available via the <a href="http://pixopoint.com/premium-support/">PixoPoint Premium Support service</a>.

== Description ==

Adds an SEO friendly, accessible dropdown/flyout/slider menu to your WordPress blog. Visit the <a href="http://pixopoint.com/multi-level-navigation/">Multi-level Navigation Plugin page</a> for more information about the plugin, or the <a href="http://pixopoint.com/forum/index.php?board=4.0">PixoPoint forum</a> for help with adding the menu to your theme.

= Live Demo =

To see a live demo of the plugin in action, please visit the <a href="http://pixopoint.com/?mln=on">PixoPoint demo</a> or see examples of other sites in the plugins' <a href="http://pixopoint.com/forum/index.php?topic=357.0">Live Examples forum topic</a>.

= Features =

The plugin produces W3C valid XHTML and CSS. The options page allows you to choose from a range of options including:

* What content will be displayed in the menu<br />
* Animation speed (how fast the dropdowns appear)<br />
* Mouseover delay<br />
* Hide delay<br />
* Add a second menu<br />
* Hover sensitivity<br />
* Keyboard accessibility<br />

= Changing the look of your menu =

You can style the menu by copy and pasting the code from the <a href="http://pixopoint.com/suckerfish_css/">Suckerfish CSS Generator page</a>.

The PixoPoint Multi-level Navigation Plugin can be implemented into any theme design, however the easiest way to set it up is to use a theme exported from the <a href="http://pixopoint.com/generator/">PixoPoint Template Generator</a>. Themes from the template generator integrate flawlessly with the plugin and do not require any theme editing. Simply activate your theme, then activate the plugin and the new menu will appear instantly. Visit the <a href="http://pixopoint.com/generator/">PixoPoint Template Generator</a> to get your own pre-supported theme.

Special thanks to <a href="http://transientmonkey.com/">malcalevak</a> who was a massive help with optomising the code for this plugin.

== Installation ==

After you've downloaded and extracted the files:

1.  Upload the complete `multi-level-navigation-plugin` folder to the `/wp-content/plugins/` directory<br />
2.  Activate the plugin through the 'Plugins' menu in WordPress<br />
3a. Either: Add `&lt;?php if (function_exists('pixopoint_menu')) {pixopoint_menu();} ?&gt;` to your theme wherever you want the menu to appear (usually your header.php file)<br />
3b. Or: Create a theme with the <a href="http://pixopoint.com/generator/">PixoPoint template generator</a> which features built in support for the plugin<br />
4.  Copy the CSS from the <a href="http://pixopoint.com/suckerfish_css/">Multi-level menu CSS Generator page</a><br />
5.  Visit the "Multi-level Navigation" page in your WordPress options menu<br />

= Easy installation =
The easiest way to setup the PixoPoint Multi-level Navigation Plugin is to use it with a theme specifically designed to support the plugin. All themes exported from the <a href="http://pixopoint.com/generator/">PixoPoint Template Generator</a> (which have dropdown menus) support this by default. Simply activate your theme, then activate the plugin and the new menu will appear instantly. Visit the <a href="http://pixopoint.com/generator/">PixoPoint Template Generator</a> to get your own pre-supported theme.

If you don't take this route then read on for simple instructions on how to integrate it into other themes ...

= Premium Support =
For direct help via the plugin (and CSS generator) author, please sign up for the <a href="http://pixopoint.com/premium-support/">PixoPoint Premium Support service</a>.

The <a href="http://pixopoint.com/premium-support/">PixoPoint Premium Support</a> option is ideal if you have insufficient time to fix any problems you may have or simply don't know much about coding. You will receive not only techinical support and access to the latest PixoPoint betas but they will also install the plugin and set it up on your site if needed. Customisations of the plugin are also done for some premium members, although we recommend asking first via the <a href="http://pixopoint.com/contact/">PixoPoint Contact Form</a> for such requests as some customisations may require extra payment depending on their complexity.

= Free support =

If you follow all of the instructions here, activate the plugin and find the menu is appearing on your site but looks  messed up, then the problem is probably caused by a clash between your themes CSS and plugins CSS. These problems can usually be remedied by removing the wrapper tags which surround the menu in your theme. For example, most themes will have some HTML such as <div id="nav"><?php wp_list_pages(); ?></div> which contains the existing themes menu. By placing the pixopoint_menu() function between those DIV tags, the menu will often interact with that DIV tag. The solution is to either remove the DIV tag or to alter it's CSS so that it doesn't interact with the menu.

If you require further help with the plugin, please visit the <a href="http://pixopoint.com/multi-level-navigation/">PixoPoint Multi-level Navigation Plugin page</a> or the <a href="http://pixopoint.com/forum/">PixoPoint support forum</a>.

Please read the following tips to help have questions answered faster.<br />

* Where is your CSS?<br />
* What modifications have you made to the CSS?<br />
* What browsers are you having problems with?<br />
* What is the URL for your site?<br />
* Provide a link to the problem. Most problems can not be answered without actually seeing your site. If you don't want to install the plugin on your live site and don't have a test site to show us, then view the source code in your browser when you do have the plugin installed, save it to an HTML file and upload that somewhere so that we can see what the page looks like.<br />
* Do not bother providing us with HTML and/or CSS code snippets (without a link). There is very little we can do without seeing the entire page as most problems are caused by an obscure piece of CSS somewhere else on the page.<br />
* Let us know if you have modified the CSS. If it is modified beyond what is available in the CSS generator we are unlikely to offer support for free. Rummaging through other peoples code is too time consuming sorry.<br />
* If you didn't paste your CSS into the WP plugins settings page, let us know which exact file it is in. Searching through a dozen CSS files in your theme trying to find your menu code is not fun.<br />

== Frequently Asked Questions ==

= How do I get a fully customised version? =

Leave a message on the PixoPoint <a href="http://pixopoint.com/contact/">Contact Page</a> with your requirements and we will get back to you ASAP with pricing information.
Alternatively you can sign up for our <a href="http://pixopoint.com/premium-support/">Premium Support</a> option which gives you access to our new dropdown, flyout and
slider menu CSS generator, plus access to our premium support forum.

= Why can't the plugin do X, Y or Z? =

It probably can, we just haven't supplied instructions on how to do it. If you have any requests, then please leave them in the <a href="http://pixopoint.com/forum/index.php?board=4.0">PixoPoint dropdown menu support board</a>. We often update the plugin with new functionality and we're far more likely to include the functionality you want if we know there is a demand for it already.

= Why should I use this plugin? =

If you are having trouble making your posts easily accessible to your users without them having to rifle endlessly through pages of posts.

If you have been using a menu which requires Javascript to work, then this plugin will allow more of your visitors to access your site.

If you want to have an easy way to style your dropdown menu. This plugin is 100% compatible with the code generated on the <a href="http://pixopoint.com/suckerfish_css/">Suckerfish Dropdown CSS Generator page</a>.

= Does it work for WordPress version x.x.x? =

We have only tested this plugin on WordPress 2.3+, however it should (in theory) work in WordPress 2.0+. Please let us know if you successfully test it on another version of WordPress.
If you are using a newer version of WordPress than the latest version supported then we suggest trying the plugin anyway. It shouldn't (in theory) break anything other than the plugin itself which you can just delete if it doesn't work.


== Credits ==

Thanks to the following (in no particular order) for help with the development of this plugin:<br />

* <a href="http://www.samburdge.co.uk/author/admin/">Sam Burdge</a> - Wrote article explaining how to remove title attributes<br />
* <a href="http://www.designfederation.net/">Klaus Kinski</a> - Found Sam Burdge's article about title attributes</br />
* <a href="http://www.simplemachines.org/community/index.php?action=profile;u=6160">metallica48423</a> - Pointed out mouseover delay was WAY too long</br />
* <a href="http://www.mindf.org/">haggis</a> - haschildren code improvement</br />
* <a href="http://www.mattermedia.com/">EddieB</a> - Tips for documentation<br />
* <a href="http://cubegames.net/">Ryan McCue</a> - Help with SVN update<br />
* <a href="http://www.vcsvu.nl/">vcsvu</a> - Code contribution (improvements to exclude pages feature)<br />
* <a href="http://nv1962.net/">nv1962</a> - Bug reporting<br />
* <a href="http://test.gruenejugend-sh.de/">fabs</a> - Bug reporting<br />
* <a href="http://www.mattermedia.com/">Eddie</a> - Gave tip on how to make custom code option more understandable for non-coders<br />
* <a href="http://www.wp-fun.co.uk/">Andrew Rickman</a> - Helped integrate a drag and drop widget style interface for testing purposes<br />
* <a href="http://wpengineer.com/how-to-improve-wordpress-plugins/">Frank Bültge</a> - Wrote a article explaining how to add action links to the plugin page<br />
* <a href="http://www.santosj.name/general/wordpress-27-plugin-uninstall-methods/">Jacob Santos</a> - Wrote an article about the uninstallation of WordPress plugins<br />
* <a href="http://blog.peter-ryan.co.uk/">Peter Ryan</a> - created the suckerfish hover delay script<br />
* <a href="http://www.barelyfitz.com/projects/tabber/">Patrick Fitzgerald</a> - creation of the tabber.js script used<br />
* <a href="http://be.twixt.us/jquery/suckerFish.php">Myles Angell</a> - creation of the suckerfish jQuery script used during development<br />
* <a href="http://transientmonkey.com/">malcalevak</a> - Massive help with coding<br />
* Ande - Reported W3C validation bug<br />
* Kevin M. Russell - helped with the style.php bug<br />
* <a href="http://access-bydesign.com/">Clive Loseby</a> - discovered strict doctype validation error<br />
* <a href="http://www.fether.net/">Paula</a> - Feature suggestions and donation<br />
* <a href="http://www.marucchi.com/">Karim  A. Marucchi</a> - Bug reporting, feature suggestions and donations</br />
* <a href="http://www.acooldryplacephotography.com/">Mark Gooding</a> - created a new version featuring a custom menu option. Although this menu system hasn't been used directly in this plugin, an almost identical system has since been installed based on the concept that Mark created.<br />
* <a href="http://www.veterinaryparasite.com/">BigAlReturns</a> - helped programming the pages and categories exclusions<br />
* <a href="http://wordpressgarage.com/">Miriam Schwab</a> - brought lack of WP dropdown plugins to my attention<br />
* <a href="http://wpcandy.com/author/admin/">Michael Castilla</a><br />
* <a href="http://cjbonline.org/">CjB</a> - Bug reporting<br />
* <a href="http://www.clearvisionpartners.com/">Troy</a> - Beta testing feedback<br />
* <a href="http://www.michaelmitchell.co.nz/">Michael Mitchell</a> - programming assistance<br />
* <a href="http://www.carroll.org.uk/">Matthew Carroll</a> - designed code for accessible keyboard dropdown<br />
* <a href="http://chrislaing.net/">Chris Laing</a> - Beta feedback<br />
* <a href="http://jquery.com/">John Resig</a> - jQuery Javascript plugin<br />
* <a href="http://users.tpg.com.au/j_birch/plugins/superfish/">Joel Birch</a> - jQuery menu widget<br />
* <a href="http://brandonaaron.net">Brandon Aaron</a> - jQuery bgiframe plugin<br />
* <a href="http://cherne.net/brian/resources/jquery.hoverIntent.html">Brian Cherne</a> - jQuery Hover Intent plugin<br />
* <a href="http://abundantharvest.biz/">Karynn</a> - Bug reporting</br />


== History ==

* Version S1.0: Initial plugin design<br />
* Version S1.01: Improved CSS styling<br />
* Version S1.02: Added Single function to improve usability<br />
* Version S1.03: Added four new functions to enable users to display a range of different types of content in the navigation bar<br />
* Version S1.04: Added one new function to enable users to display a different type of content in the navigation bar<br />
* Version S1.05: Bug fixed thanks to Cj B (http://cjbonline.org/)<br />
* Version S1.1 Beta: Initial Beta version featuring user customisable design<br />
* Version S1.1.1 Beta: Corrected folder name<br />
* Version S1.1.2 Beta: Removed menu from wp_footer<br />
* Version S1.1.3 Beta: Major bugfix due to incorrect function names<br />
* Version S1.1.4 Beta: Re-included suckerfish2, suckerfish3, suckerfish4 and suckerfish5 functions from version 1.0.4<br />
* Version S1.2 Beta: Added many new options<br />
* Version S1.3 Beta: Major recode. Replaced built in plugin style generator with the Suckerfish Dropdown Generator.<br />
* Version S1.4 Beta: Major code addition. Added selection boxes to admin panel to allow control over what appears in the dropdown menu directly via the admin panel.<br />
* Version S1.5 Beta: Added keyboard accessibility support.<br />
* Version S1.6 Beta: Moved style information from HTML to a dynamically generated external CSS file<br />
* Version S1.6.1: New stable release. Minor change: added monthly/yearly options for archives<br />
* Version S1.6.2: Major bug fix. An error in the Javascript file was corrected.<br />
* Version S1.6.3: Major bug fix. 'Category' option was not working, now fixed<br />
* Version S1.6.4: Minor bug fix.<br />
* Version S1.6.6: Minor bug fix. Superceded by the Multi-level Navigation Plugin.
* Version 0.95 Beta: Upgrade from 'Ryans Suckerfish Dropdown Menu'<br />
* Version 0.96 Beta: Fixed the "There is a new version of ..." bug<br />
* Version 0.97 Beta: Corrected 'Custom 1' bug<br />
* Version 0.98 Beta: Added inline CSS option<br />
* Version 0.99 RC: Final test version before stable release<br />
* Version 1.0: Official release to WordPress plugins repository<br />
* Version 1.0.1: Corrected VERY MAJOR bug which prevented menu from functioning in IE6 - how did nobody notice this?<br />
* Version 1.0.2: Removed random file from plugin and confirmed support for WordPress 2.6<br />
* Version 1.0.3: Stupid WP repository packed a wobbly and wouldn't upload the images folder so resorted to releasing new version<br />
* Version 1.0.4: Fixed W3C validation error<br />
* Version 1.0.5: Refixed infernal IE Javascript bug<br />
* Version 1.0.6: Refixed infernal IE Javascript bug AGAIN!!!!<br />
* Version 1.0.7: custom: Custom plugin for WebFadds.com; introduces categories to blogroll<br />
* Version 1.0.8: Minor bug fix. Final version in 1.0.x line before massive upgrade<br />
* Version 1.1.0 Alpha: Code improvements<br />
* Version 1.2 Beta: Added categories to blogroll. No negative reports during testing, so now released as beta.<br Version 1.2.1 Beta: Added support for a new suckerfish jQuery script to replace the buggy and bloated Superfish one.<br />
* Version 1.2.2 Beta: Added non categories to blogroll.<br />
* Version 1.2.3 Beta: Changed labels for blogroll to 'links'.<br />
* Version 1.2.4 Beta: Added Suckerfish jQuery script and removed Superfish jQuery script.<br />
* Version 1.2.5 Beta: Removed Suckerfish jQuery script.<br />
* Version 1.2.6 Beta: Readded Superfish script - removing it was a stupid idea.<br />
* Version 1.2.7 Beta: Added include/exclude featured.<br />
* Version 1.3 Beta: Redesigned admin interface.<br />
* Version 1.3.1 Beta: Added backward compatibility for newly renamed functions.<br />
* Version 1.3.2 Beta: Added support for changing wp-content/plugins in WP. Broke support for EP 2.5.x and older.<br />
* Version 1.3.3 Beta: Major rebuild by malcalevak.<br />
* Version 1.3.4 Beta: Major code rework.<br />
* Version 1.3.5 Beta: Added support for themes developed specifically for the Multi-level Navigation Plugin.<br />
* Version 1.3.6 Beta: Added option in admin panel to allow users to change between their own themes CSS and the plugin CSS (for themes designed for the Multi-level Navigation Plugin.<br />
* Version 1.4 Alpha: Total rewrite of the admin page<br />
* Version 1.4.1 Alpha: Rearranged admin page content<br />
* Version 1.4.2 Alpha: Rearranged admin page content again<br />
* Version 1.4.3 Alpha: Rearranged admin page content again  ... hopefully the last time!<br />
* Version 1.4.4 Alpha: Stripped out admin page code from the index.php file and moved to includes<br />
* Version 1.4.5 Alpha: Added more/better information on the admin page about how to receive support<br />
* Version 1.4.6 Alpha: Added support for hover delay<br />
* Version 1.4.7 Alpha: Improved the admin page menu<br />
* Version 1.4.8 Alpha: Moved all CSS to an external file. Idea courtesy of malcalevak<br />
* Version 1.4.9 Alpha: Added uninstaller<br />
* Version 1.4.10 Alpha: Fixed script issues so that plugin actually works.<br />
* Version 1.4.11 Alpha: Removed need to tick enable animations box<br />
* Version 1.4.12 Alpha: Added improved keyboard accessibility script which uses Query. Script courtesy of malcalevak<br />
* Version 1.4.13 Alpha: Moved clauses for the Superfish script into the settings file on advice from malcalevak<br />
* Version 1.4.14 Alpha: Modified suckerfish script to support second menu<br />
* Version 1.5.0 Beta: Tested, tested, tested and only bug found was that the delay script doesn't work on the second menu<br />
* Version 1.5.1 Beta: Fixed IE menu bug<br />
* Version 1.5.2 Beta: Added test widget system<br />
* Version 1.5.1 Beta: Added uninstall link in plugin page<br />
* Version 1.5.2 Beta: Removed uninstall link in plugin page - security issues<br />
* Version 1.5.3 Beta: Added initial test code for drag and drop of menu items (not activated yet though)<br />
* Version 1.5.4 Beta: Changed function calls to avoid the term 'suckerfish' which seems to confuse users who don't know what a suckerfish is<br />
* Version 1.5.5 Beta: Add 'recommended plugins' section<br />
* Version 1.5.6 Beta: Added custom code tip, idea courtesy of eddieb<br />
* Version 1.5.7 Beta: Added FAQ section in admin panel<br />
* Version 1.5.8 Beta: Added conditional to change HTML output depending on if theme or plugin CSS is used - don't want theme CSS overlaying the plugin CSS<br />
* Version 1.5.9 Beta: Added mousein delay and sensitivity options<br />
* Version 1.5.10 Beta: Improved sensitivity option<br />
* Version 1.5.11 Beta: Added warning that keyboard navigation doesn't work. Removed shadow option as that should be controlled by the CSS, not by a script<br />
* Version 1.5.12 Beta: Added 'maintenance mode' which allows the menu to be accessed only when ?mln=on is added to the URL. Should be useful for testing purposes.<br />
* Version 1.5.13 Beta: File name changes. Simplified index.php file code<br />
* Version 1.5.14 Beta: New maintenance mode controls: Control inline CSS, disable CSS, Superfish speed and keyboard accessibility<br />
* Version 1.5.15 Beta: Added test CSS file, controllable when in maintenance mode. Useful for check if bugs are caused by poor CSS<br />
* Version 1.5.16 Beta: Fixed test CSS bug<br />
* Version 1.5.17 Beta: Removed maintenance mode controls which stored information in database to avoid any potential security risks<br />
* Version 1.6 RC1: No changes, simply changed label to RC1 ready for official release<br />
* Version 1.6 RC2: Improved IE6 support<br />
* Version 1.6: Official release. Replaces the 1.0.x line which is no longer supported<br />
* Version 1.6.1: Critical update. Backwards compatibility bug fixed<br />
* Version 1.6.2: Bug fix, added background images back in.<br />
* Version 1.6.3: Bug fix, recent Posts dropdown was not working<br />
* Version 1.6.4: Added support for two more custom code boxes<br />
* Version 1.6.5: Added missing options from uninstall script (wasn't totally uninstalling)<br />
* Version 1.6.6: Added pages_excludechildren() and pagesdropdown_excludechildren() functions - not yet fully implemented<br />
* Version 1.6.7: Added version number as variable (so is consistent across the whole plugin - was often incorrect in some files in previous versions)<br />
* Version 1.7: Added localization support (untested)<br />
* Version 1.7.1: Added PO file<br />
* Version 1.7.2: Fixed bug which prevented Links menu item from appearing<br />
* Version 1.7.3: Added Category order option to admin panel<br />
* Version 1.7.4: Fixed IE problem<br />
* Version 1.7.5: Correcting error in subversion upload<br />
* Version 1.7.6: Fixed another IE problem<br />
* Version 1.7.7: Fixed Include/Exclude Pages and Categories feature<br />
* Version 1.8: Added localization support, including Spanish language<br />
* Version 1.8.1: Added improved Suckerfish script - works with class instead of ID now<br />
* Version 1.9: Added option to modify URL's for links in single dropdowns and added option to modify the page and category depths<br />
* Version 1.9.1 Alpha: Changed stylesheets' header<br />
* Version 1.9.2 Alpha: Changed PHP generated javascript' header<br />
* Version 1.9.3: No reports on Alpha release so changes added to core<br />
* Version 1.9.4: Added support for hide_empty=0 so that empty categories are still displayed and updated Spanish language files<br />
* Version 1.9.5: Added bugstomp_home.php script to attempt to correct for upgrading bug and confirmed 2.7.1 support<br />
* Version 1.9.6: Added option to show or not show empty categories<br />
* Version 1.9.7: Fixed hover delay bug<br />
* Version 1.9.8: Added ability to control hover delay time (was fixed at 600 ms previously)<br />
* Version 2.0: Added upgrade fix for hover delay time and added support for removing the title attribute from the menus<br />