brendaegeland

A common web design pattern is to have a primary navigation with the top level pages, and then a separate 
navigation element on each page that shows only those pages related to a common top-most page. This widget helps 
to build those secondary navigation elements.
If your page structure was like this:
<ul>
<li>Home</li>
<li>About</li>
<li>— Our History</li>
<li>— Our Staff</li>
<li>— — Employment Opportunities</li>
<li>Services</li>
<li>— Widget Development</li>
<li>— Gadget Deployment</li>
<li>Contact Us</li>
</ul>
and you added the widget with its default settings to a sidebar, it would create a list like this:
<ul>
<li>About</li>
<li>Our History</li>
<li>Our Staff</li>
<li>— Employment Opportunities</li>
</ul>
on any of the pages in the About subtree. Notice that the top-most ancestor, About, is included as the first element of the list.
<h4>Options</h4>
<ol>
<li>Title. The widget title. If left blank, it defaults to the title of the top ancestor page.</li>
<li>Show Title. Maybe you don’t want a title. Just turn it off here.</li>
<li>Top Page. You can select one of your pages to be the top page, or you can choose Default, which determines the top-most ancestor of the page being displayed.</li>
<li>Menu Class. Gets applied to the outermost <ul> element.</li>
<li>Before Links. HTML to be inserted before links in the list.</li>
<li>After Links. HTML to be inserted after links in the list.</li>
</ol>

Subpages in Context

Lists pages and subpages for a given page, or the top ancestor of the current page and all of the ancestor's descendants

Bill Erickson

This widget will dynamically list a section’s subpages. When on a page, it will find the section’s top level page and list its children.
It can also include the current page’s subpages in listing.
You can customize the listing with the following filters: 
be_subpages_widget_args – modifies the arguments passed to wp_list_pages 
be_subpages_widget_display_override – determine when the widget is displayed 
be_subpages_widget_override_post – change the current post 
be_subpages_widget_parents – customize the hierarchy used in querying subpages 
be_subpages_widget_title – customize the widget title 
be_subpages_page_title – customize the page title 
be_subpages_widget_class – customize the classes applied to pages
Contributors: 
– <a href="https://profiles.wordpress.org/billerickson" rel="nofollow ugc">billerickson</a> 
– <a href="https://profiles.wordpress.org/scil/" rel="nofollow ugc">scil</a> 
– <a href="https://github.com/jb510" rel="nofollow ugc">jb510</a> 
– <a href="https://github.com/fabiancz" rel="nofollow ugc">fabiancz</a>
<a href="http://www.billerickson.net/contributions/plugins/" rel="nofollow ugc">View all plugins by Bill Erickson</a>

BE Subpages Widget

Prefect plugin.  I was using a custom-coded shortcode to do this, but was having trouble getting the children/grandchildren page lists to appear outside of the parent list's li element.  The default in this plugin to not nest subpages is perfect for the style I need to set up.  Thanks!



Subpages in Context vs BE Subpages Widget