benknight

<p>This is a simple plugin that was born out of working on several projects with sectional navigations.  For example, consider the following common navigation tree structure:</p>
<ul>
<li>Home</li>
<li>Item</li>
<li>About Us
<ul>
<li>Sub-item #1</li>
<li>Sub-item #2</li>
</ul>
</li>
<li>Item</li>
<li>Item</li>
</ul>
<p>Then, whenever on the “About Us” page or any of its sub-items, it would output that peice of the navigation:</p>
<ul>
<li>About Us
<ul>
<li>Sub-item #1</li>
<li>Sub-item #2</li>
</ul>
</li>
</ul>
<p>This is particularly useful for websites that have a top horizontal navigation which shows top-level items and want to show a vertical subnavigation in the sidebar.</p>
<p>This plugin works by parsing the output of the <code>wp_nav_menu</code> function as XML and analyzing the CSS class hooks (current-menu-ancestor, current-menu-item, and current-menu-parent).  Because it uses PHP’s SimpleXML library it therefore requires PHP 5+.  It uses the theme’s registered menu locations.</p>
<p>This plugin also exposes the <code>section_subnav()</code> function for theme developers to use as a template tag to manually place a subnav inside the theme.  Here is the usage:</p>
<pre><code><?php

    section_subnav( array( // defaults
        'before_widget' => '<nav id="section-subnav" class="widget widget_section-subnav">',
        'after_widget' => "</nav>",
        'before_title' => '<h3 class="section-subnav-title widget-title">',
        'after_title' => '</h3>',
        'echo' => true
    ));

?>
</code></pre>
<p>It returns false when there is no subnavigation.</p>
<p>This function also provides the <code>section_subnav_args</code> filter hook for writing less code and easier integration with other plugins and child themes.</p>


Section Subnav

Adds a widget and template function for displaying subnavigation based on the current navigation state.

Section Subnav vs Custom Menu Wizard Widget