Mark Jaquith

Subpage Listing allows you to take full advantage of WordPress Pages’ hierarchy by generating a navigational tree of the pages below them (subpages).
For example, say you have a parent page called “Parent.” Now, say you have 3 pages under “Parent,” called “Child1,” “Child2,” and “Child3.” Now, say that you have 2 pages under “Child2” called “Grandchild1” and “Grandchild2.”
Subpage Listing would create a navigation tree for “Parent” that looks like this:
<ul>
<li>Child1</li>
<li>Child2
<ul>
<li>Grandchild1</li>
<li>Grandchild2</li>
</ul>
</li>
<li>Child3</li>
</ul>
This allows you to very easily create a complex hierarchical structure that can be browsed.
<h3>Advanced Usage</h3>
Blank pages will automatically be given a navigation tree. This allows you to quickly create “container” pages (all you do is fill in a title, and choose the page’s parent.)
If you would like to insert the navigational tree manually (that is, surrounded by text of your choosing), use the “Subpage Listing” quicktag that will show up on the Write Page screen (sorry, no RTE support at this time). This will insert the tag:  which will be replaced by the listing of the subpages.
Note: when inserting the tag manually, make sure that there is a blank line both above and below the tag, so as to ensure proper handling of your surrounding paragraphs by WordPress.
Version 0.6 was a massive update that added a bunch of new functionality. The ability to show the current page’s parent has been added, as well as the ability to show the current page’s siblings. You can also suppress the showing of children, and show only siblings, parents, or both. To use these features within a post, use this syntax:  The first “parameter” is the depth you want to show. You can set this to 0 to suppress display of children. The second “parameter” is a boolean switch for display of the parent page. The third “parameter” is a boolean switch for display of sibling pages. All are optional, although if you want to set the second “parameter”, you also have to set the first, and if you want to set the third, you have to set all three.
There is also a new function for use in your templates. Many people wanted to show subpages or siblings in their sidebar, so now you can do that. <code><?php txfx_wp_subpages(); ?></code> is the most basic form, but it can take many parameters.
<pre><code><?php txfx_wp_subpages(5, false, false, '<ul>', '</ul>', true); ?> will show 5 pages deep (first parameter), hide the parent (second parameter), hide the siblings (third parameter), wrap the whole thing in '<ul>' and '</ul>' (fourth and fifth parameters), and will echo the result (sixth parameter). These happen to be the default settings, that I have just illustrated.
</code></pre>

Subpage Listing

Allows you to display a list of the child pages of the currently viewed page.

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

Subpage Listing vs Sitemap