Title: Section Subnav
Author: benknight
Published: <strong>august 30, 2011</strong>
Last modified: august 30, 2011

---

Search plugins

This plugin **hasn’t been tested with the latest 3 major releases of WordPress**.
It may no longer be maintained or supported and may have compatibility issues when
used with more recent versions of WordPress.

![](https://s.w.org/plugins/geopattern-icon/section-subnav.svg)

# Section Subnav

 By [benknight](https://profiles.wordpress.org/benknight/)

[Download](https://downloads.wordpress.org/plugin/section-subnav.0.9.zip)

 * [Details](https://fao.wordpress.org/plugins/section-subnav/#description)
 * [Reviews](https://fao.wordpress.org/plugins/section-subnav/#reviews)
 *  [Installation](https://fao.wordpress.org/plugins/section-subnav/#installation)
 * [Development](https://fao.wordpress.org/plugins/section-subnav/#developers)

 [Support](https://wordpress.org/support/plugin/section-subnav/)

## Description

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:

 * Home
 * Item
 * About Us
    - Sub-item #1
    - Sub-item #2
 * Item
 * Item

Then, whenever on the “About Us” page or any of its sub-items, it would output that
peice of the navigation:

 * About Us
    - Sub-item #1
    - Sub-item #2

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.

This plugin works by parsing the output of the `wp_nav_menu` 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.

This plugin also exposes the `section_subnav()` function for theme developers to
use as a template tag to manually place a subnav inside the theme. Here is the usage:

    ```
    <?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
        ));

    ?>
    ```

It returns false when there is no subnavigation.

This function also provides the `section_subnav_args` filter hook for writing less
code and easier integration with other plugins and child themes.

## Installation

This section describes how to install the plugin and get it working.

 1. Upload `section-subnav` to the `/wp-content/plugins/` directory
 2. Activate the plugin through the ‘Plugins’ menu in WordPress
 3. Add the widget to a sidebar or use the `section_subnav()` function in one of your
    theme templates.

## Reviews

![](https://secure.gravatar.com/avatar/6955650dfc2336dd1f5601c9089ff5bc39b5d5c20f848724cce25ffdf64aee8b?
s=60&d=retro&r=g)

### 󠀁[Excellent Plugin](https://wordpress.org/support/topic/excellent-plugin-3523/)󠁿

 [raygulick](https://profiles.wordpress.org/raygulick/) desember 5, 2017

There is nothing else like it among wordpress.org plugins. You should update it 
to keep it current.

 [ Read all 3 reviews ](https://wordpress.org/support/plugin/section-subnav/reviews/)

## Contributors & Developers

“Section Subnav” is open source software. The following people have contributed 
to this plugin.

Contributors

 *   [ benknight ](https://profiles.wordpress.org/benknight/)

[Translate “Section Subnav” into your language.](https://translate.wordpress.org/projects/wp-plugins/section-subnav)

### Interested in development?

[Browse the code](https://plugins.trac.wordpress.org/browser/section-subnav/), check
out the [SVN repository](https://plugins.svn.wordpress.org/section-subnav/), or 
subscribe to the [development log](https://plugins.trac.wordpress.org/log/section-subnav/)
by [RSS](https://plugins.trac.wordpress.org/log/section-subnav/?limit=100&mode=stop_on_copy&format=rss).

## Changelog

#### 0.9

 * Initial release.

## Meta

 *  Version **0.9**
 *  Last updated **15 ár ago**
 *  Active installations **60+**
 *  WordPress version ** 3.1 or higher **
 *  Tested up to **3.2.1**
 *  Language
 * [English (US)](https://wordpress.org/plugins/section-subnav/)
 * Tags
 * [menu](https://fao.wordpress.org/plugins/tags/menu/)[navigation](https://fao.wordpress.org/plugins/tags/navigation/)
   [widget](https://fao.wordpress.org/plugins/tags/widget/)
 *  [Advanced View](https://fao.wordpress.org/plugins/section-subnav/advanced/)

## Ratings

 5 out of 5 stars.

 *  [  3 5-star reviews     ](https://wordpress.org/support/plugin/section-subnav/reviews/?filter=5)
 *  [  0 4-star reviews     ](https://wordpress.org/support/plugin/section-subnav/reviews/?filter=4)
 *  [  0 3-star reviews     ](https://wordpress.org/support/plugin/section-subnav/reviews/?filter=3)
 *  [  0 2-star reviews     ](https://wordpress.org/support/plugin/section-subnav/reviews/?filter=2)
 *  [  0 1-star reviews     ](https://wordpress.org/support/plugin/section-subnav/reviews/?filter=1)

[Your review](https://wordpress.org/support/plugin/section-subnav/reviews/#new-post)

[See all reviews](https://wordpress.org/support/plugin/section-subnav/reviews/)

## Contributors

 *   [ benknight ](https://profiles.wordpress.org/benknight/)

## Support

Got something to say? Need help?

 [View support forum](https://wordpress.org/support/plugin/section-subnav/)

## Donate

Would you like to support the advancement of this plugin?

 [ Donate to this plugin ](https://www.paypal.com/cgi-bin/webscr?cmd=_donations&business=NYCGJ7YCGUTAQ&lc=US&item_name=Benjamin%20Knight&item_number=section%2dsubnav&currency_code=USD&bn=PP%2dDonationsBF%3abtn_donateCC_LG%2egif%3aNonHosted)