Subpages in Context, a WordPress Plugin

WordPress widget to list pages and subpages for a given page, or the top ancestor of the current page and all of the ancestor's descendants.

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:

• Home
• About
• -- Our History
• -- Our Staff
• -- -- Employment Opportunities
• Services
• -- Widget Development
• -- Gadget Deployment
• Contact Us

and you added the widget with its default settings to a sidebar, it would create a list like this:

• About
• Our History
• Our Staff
• -- Employment Opportunities

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, unless you turn off that option.

Options

• Title. The widget title. If left blank, it defaults to the title of the top ancestor page.
• Show Title. Maybe you don't want a title. Just turn it off here.
• 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.
• Include top-most page as first item in list? If you don't want the top-most page to be the first item in the list, turn off this option.
• Menu Class. Gets applied to the outermost <ul> element.
• Before Links. HTML to be inserted before links in the list.
• After Links. HTML to be inserted after links in the list.