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

webvitaly

Code moved to <a href="https://wordpress.org/plugins/page-list/">Page-list plugin</a> Please, delete Sitemap plugin and install <a href="https://wordpress.org/plugins/page-list/" title="List of pages">Page-list plugin</a> instead. Don’t be afraid, the functionality of these plugins is the same.
<ul>
<li><a href="https://1.envato.market/70ANO" title="Advanced iFrame Pro" rel="nofollow ugc">Advanced iFrame Pro</a></li>
<li><a href="http://web-profile.net/wordpress/plugins/page-list/" title="Plugin page" rel="nofollow ugc">Page-list</a></li>
<li><a href="https://wordpress.org/plugins/page-list/other_notes/">all Page-list params</a></li>
<li><a href="http://web-profile.net/donate/" title="Support the development" rel="nofollow ugc">Donate</a></li>
<li><a href="https://github.com/webvitalii/page-list" title="Fork" rel="nofollow ugc">GitHub</a></li>
</ul>
<h4>shortcodes:</h4>
<ul>
<li>[pagelist] – hierarchical tree of all pages on site (useful to show sitemap of the site);</li>
<li>[subpages] – hierarchical tree of subpages to the current page;</li>
<li>[siblings] – hierarchical tree of sibling pages to the current page;</li>
<li>[pagelist_ext] – list of pages with featured image and with excerpt;</li>
</ul>
<h4>examples with aditional parameters:</h4>
<ul>
<li><code>[pagelist child_of="4" depth="2" exclude="6,7,8"]</code></li>
<li><code>[pagelist_ext child_of="4" exclude="6,7,8" image_width="50" image_height="50"]</code></li>
<li><a href="https://wordpress.org/plugins/page-list/other_notes/">all Page-list params</a></li>
</ul>
<h4>Parameters for [pagelist], [subpages] and [siblings]:</h4>
<ul>
<li>[pagelist] – by default shows list of all pages as the hierarchical list;</li>
<li>[subpages] – by default shows list of subpages to the current page as the hierarchical list;</li>
<li>[siblings] – by default shows list of sibling pages to the current page as the hierarchical list;</li>
<li>depth – means how many levels in the hierarchy of pages are to be included in the list, by default depth is unlimited (depth=0), but you can specify it like this: <code>[pagelist depth="3"]</code>; If you want to show flat list of pages (not hierarchical tree) you can use this shortcode: <code>[pagelist depth="-1"]</code>;</li>
<li>child_of – if you want to show subpages of the specific page you can use this shortcode: <code>[pagelist child_of="4"]</code> where <code>4</code> is the ID of the specific page; If you want to show subpages of the current page you can use this shortcodes: <code>[subpages]</code> or <code>[pagelist child_of="current"]</code> or <code>[pagelist child_of="this"]</code>; If you want to show sibling pages of the current page you can use this shortcodes: <code>[siblings]</code> or <code>[pagelist child_of="parent"]</code>;</li>
<li>exclude – if you want to exclude some pages from the list you can use this shortcode: <code>[pagelist exclude="6,7,8"]</code> where <code>exclude</code> parameter accepts comma-separated list of Page IDs; You may exclude current page with this shortcode: <code>[pagelist exclude="current"]</code>;</li>
<li>exclude_tree – if you want to exclude the tree of pages from the list you can use this shortcode: <code>[pagelist exclude_tree="7,10"]</code> where <code>exclude_tree</code> parameter accepts comma-separated list of Page IDs (all this pages and their subpages will be excluded);</li>
<li>include – if you want to include certain pages into the list of pages you can use this shortcode: <code>[pagelist include="6,7,8"]</code> where <code>include</code> parameter accepts comma-separated list of Page IDs;</li>
<li>title_li – if you want to specify the title of the list of pages you can use this shortcode: <code>[pagelist title_li="<h2>List of pages</h2>"]</code>; by default there is no title (title_li=””);</li>
<li>number – if you want to specify the number of pages to be included into list of pages you can use this shortcode: <code>[pagelist number="10"]</code>; by default the number is unlimited (number=””);</li>
<li>offset – if you want to pass over (or displace) some pages you can use this shortcode: <code>[pagelist offset="5"]</code>; by default there is no offset (offset=””);</li>
<li>meta_key – if you want to include the pages that have this Custom Field Key you can use this shortcode: <code>[pagelist meta_key="metakey" meta_value="metaval"]</code>;</li>
<li>show_date – if you want to show the date of the page you can use this shortcode: <code>[pagelist show_date="created"]</code>; you can use this values for <code>show_date</code> parameter: created, modified, updated;</li>
<li>menu_order – if you want to specify the column by what to sort you can use this shortcode: <code>[pagelist sort_column="menu_order"]</code>; by default order columns are <code>menu_order</code> and <code>post_title</code> (sort_column=”menu_order, post_title”); you can use this values for <code>sort_column</code> parameter: post_title, menu_order, post_date (sort by creation time), post_modified (sort by last modified time), ID, post_author (sort by the page author’s numeric ID), post_name (sort by page slug);</li>
<li>sort_order – if you want to change the sort order of the list of pages (either ascending or descending) you can use this shortcode: <code>[pagelist sort_order="desc"]</code>; by default sort_order is <code>asc</code> (sort_order=”asc”); you can use this values for <code>sort_order</code> parameter: asc, desc;</li>
<li>link_before – if you want to specify the text or html that precedes the link text inside the link tag you can use this shortcode: <code>[pagelist link_before=""]</code>; you may specify html tags only in the <code>HTML</code> tab in your Rich-text editor;</li>
<li>link_after – if you want to specify the text or html that follows the link text inside the link tag you can use this shortcode: <code>[pagelist link_after=""]</code>; you may specify html tags only in the <code>HTML</code> tab in your Rich-text editor;</li>
<li>class – if you want to specify the CSS class for list of pages you can use this shortcode: <code>[pagelist class="listclass"]</code>; by default the class is empty (class=””);</li>
</ul>
<h4>Parameters for [pagelist_ext]:</h4>
<ul>
<li>[pagelist_ext] – by default shows list of subpages to current page; but if there is no subpages than all pages will be shown;</li>
<li>show_image – show or hide featured image <code>[pagelist_ext show_image="0"]</code>; “show_image” have higher priority than “show_first_image”; by default: show_image=”1″;</li>
<li>show_first_image – show or hide first image from content if there is no featured image <code>[pagelist_ext show_first_image="1"]</code>; by default: show_first_image=”0″;</li>
<li>show_title – show or hide title <code>[pagelist_ext show_title="0"]</code>; by default: show_title=”1″;</li>
<li>show_content – show or hide content <code>[pagelist_ext show_content="0"]</code>; by default: show_content=”1″;</li>
<li>more_tag – if you want to output all content before and after more tag use this shortcode: <code>[pagelist_ext more_tag="0"]</code>; this parameter does not add “more-link” to the end of content, it just cut content before more-tag; “more_tag” parameter have higher priority than “limit_content”; by default the more_tag is enabled (more_tag=”1″) and showing only content before more tag;</li>
<li>limit_content – content is limited by “more-tag” if it is exist or by “limit_content” parameter <code>[pagelist_ext limit_content="100"]</code>; by default: limit_content=”250″;</li>
<li>image_width – width of the image <code>[pagelist_ext image_width="80"]</code>; by default: image_width=”50″;</li>
<li>image_height – height of the image <code>[pagelist_ext image_height="80"]</code>; by default: image_height=”50″;</li>
<li>child_of – if you want to show subpages of the specific page you can use this shortcode: <code>[pagelist_ext child_of="4"]</code> where <code>4</code> is the ID of the specific page; by default it shows subpages to the current page;</li>
<li>parent – if you want to show subpages of the specific page only you can use this shortcode: <code>[pagelist_ext parent="4"]</code> where <code>4</code> is the ID of the specific page and the depth will be only one level; by default parent=”-1″ and depth is unlimited;</li>
<li>sort_order – if you want to change the sort order of the list of pages (either ascending or descending) you can use this shortcode: <code>[pagelist_ext sort_order="desc"]</code>; by default: sort_order=”asc”; you can use this values for <code>sort_order</code> parameter: asc, desc;</li>
<li>sort_column – if you want to specify the column by what to sort you can use this shortcode: <code>[pagelist_ext sort_column="menu_order"]</code>; by default order columns are <code>sort_column</code> and <code>post_title</code> (sort_column=”menu_order, post_title”); you can use this values for <code>sort_column</code> parameter: post_title, menu_order, post_date (sort by creation time), post_modified (sort by last modified time), ID, post_author (sort by the page author’s numeric ID), post_name (sort by page slug);</li>
<li>hierarchical – display subpages below their parent page <code>[pagelist_ext hierarchical="0"]</code>; by default: hierarchical=”1″;</li>
<li>exclude – if you want to exclude some pages from the list you can use this shortcode: <code>[pagelist_ext exclude="6,7,8"]</code> where <code>exclude</code> parameter accepts comma-separated list of Page IDs;</li>
<li>exclude_tree – if you want to exclude the tree of pages from the list you can use this shortcode: <code>[pagelist_ext exclude_tree="7,10"]</code> where <code>exclude_tree</code> parameter accepts comma-separated list of Page IDs (all this pages and their subpages will be excluded);</li>
<li>include – if you want to include certain pages into the list of pages you can use this shortcode: <code>[pagelist_ext include="6,7,8"]</code> where <code>include</code> parameter accepts comma-separated list of Page IDs;</li>
<li>meta_key – if you want to include the pages that have this Custom Field Key you can use this shortcode: <code>[pagelist_ext meta_key="metakey" meta_value="metaval"]</code>;</li>
<li>authors – only include the pages written by the given author(s) <code>[pagelist_ext authors="6,7,8"]</code>;</li>
<li>number – if you want to specify the number of pages to be included into list of pages you can use this shortcode: <code>[pagelist_ext number="10"]</code>; by default the number is unlimited (number=””);</li>
<li>offset – if you want to pass over (or displace) some pages you can use this shortcode: <code>[pagelist_ext offset="5"]</code>; by default there is no offset (offset=””);</li>
<li>post_type – <code>[pagelist_ext post_type="page"]</code>;</li>
<li>post_status – <code>[pagelist_ext post_status="publish"]</code>;</li>
<li>class – if you want to specify the CSS class for list of pages you can use this shortcode: <code>[pagelist_ext class="listclass"]</code>; by default the class is empty (class=””);</li>
<li>strip_tags – if you want to output the content with tags use this shortcode: <code>[pagelist_ext strip_tags="0"]</code>; by default the strip_tags is enabled (strip_tags=”1″);</li>
<li>strip_shortcodes – if you want to output the content with shortcode use this shortcode: <code>[pagelist_ext strip_shortcodes="0"]</code>; by default the strip_shortcodes is enabled (strip_shortcodes=”1″) and all registered shortcodes are removed;</li>
<li>show_child_count – if you want to show child count you can use this shortcode: <code>[pagelist_ext show_child_count="1"]</code>; by default the child_count is disabled (show_child_count=”0″); If show_child_count=”1″, but count of subpages=0, than child count is not showing;</li>
<li>child_count_template – if you want to specify the template of child_count you can use this shortcode: <code>[pagelist_ext show_child_count="1" child_count_template="Subpages: %child_count%"]</code>; by default child_count_template=”Subpages: %child_count%”;</li>
<li>show_meta_key – if you want to show meta key you can use this shortcode: <code>[pagelist_ext show_meta_key="your_meta_key"]</code>; by default the show_meta_key is empty (show_meta_key=””); If show_meta_key is enabled, but meta_value is empty, than meta_key is not showing;</li>
<li>meta_template – if you want to specify the template of meta you can use this shortcode: <code>[pagelist_ext show_meta_key="your_meta_key" meta_template="Meta: %meta%"]</code>; by default meta_template=”%meta%”;</li>
</ul>

Sitemap

[pagelist], [subpages], [siblings] and [pagelist_ext] shortcodes

Subpages in Context vs Sitemap