=== Dropdown Menus ===
Contributors: sanchothefat
Tags: menus, dropdowns
Requires at least: 3.0
Tested up to: 3.2.1
Stable tag: 0.2

Display your WordPress menus as dropdowns.

== Description ==

Sometimes for mobile design or more generally small-screen design it can be beneficial to save space by using a dropdown for your navigation.

This plugin provides a way to display your custom menus as dropdowns either using a widget or a function call.

= Usage =

If you are using the plugin with a theme you can use the function `dropdown_menu()` in place of calls to `wp_nav_menu()`.

The `dropdown_menu()` function takes the same arguments as `wp_nav_menu()` with the addition of two extras:

`<?php
dropdown_menu( array(

    // indent_string is a string that gets output before the title of a
    // sub-menu item. It is repeated twice for sub-sub-menu items and so on
    'indent_string' => '- ',

    // indent_after is an optional string to output after the indent_string
    // if the item is a sub-menu item
    'indent_after' => ''

) );
?>`

You can extend and alter the output of the dropdowns using the output filters available in the code.

There are also plenty of styling hooks like in the standard list type menus with the addition of classes for targetting items at a certain depth in the menu (`.menu-item-depth-1` for example) aswell the usual `.current-menu-item` and `.current-menu-ancestor` classes.

= Can I make sure this plugin is available to my theme? =

If your theme requires this plugin to be available it will work as a simple include. Just place the plugin into your theme directory and include dropdown-menus.php from your functions.php file.

If you place the plugin folder into your theme's directory you would use the following code in your functions.php file:

`<?php
include( 'dropdown-menus/dropdown-menus.php' );
?>`


== Changelog ==

= 0.2 =
* Removed optgroup tags altogether as nested optgroups are invalid markup
* Added class name for targetting items by depth
* Added configurable indentation text to indicate visually the depth of an item in the menu
* Added extra filters to provide fine-grained control for developers