Angelo Mandato

Painless Analytics

<p>This simple plugin adds an HTML (Not XML) sitemap of your pages (not posts) by using the shortcode <code>[html_sitemap]</code>. This plugin can display a sitemap with specific depths, from a specific parent page and include/exclude specific pages by ID. The sitemap uses the unordered HTML list tags <code><ul></code> and <code><li></code>.</p>
<p>New for 2.0 is the <strong>HTML Sitemap Block</strong>, now you can add a HTML Sitemap using the WordPress Block Editor.</p>
<p>Attributes include <code>sort_column</code>, <code>sort_order</code>, <code>exclude</code>, <code>include</code>, <code>depth</code>, <code>child_of</code>, <code>meta_key</code>, <code>meta_value</code>, <code>authors</code>, <code>number</code>,  <code>offset</code>, <code>post_type</code>,  and <code>post_status</code> parameters from the <a href="https://codex.wordpress.org/Function_Reference/wp_list_pages" rel="nofollow ugc"><code>wp_list_pages</code></a> function. In addition you can also set <code>class</code>, <code>id</code>, and <code>ordered_list_type</code> to further customize the html page sitemap.</p>
<p><strong>This plugin is perfect for those who use WordPress as a CMS.</strong></p>
<h3>Block / Shortcode Tag Attribute Options</h3>
<p>The following wp_list_pages tag attribute options are supported:</p>
<ul>
<li><code>authors</code> — Comma-separated list of author IDs. Default empty (all authors).</li>
<li><code>child_of</code> — ID of child page, ‘CURRENT’, or ‘PARENT’. The value ‘CURRENT’ will use the current page ID. The value ‘PARENT’ will use the current page parent ID.</li>
<li><code>depth</code> — -1 (any depth), 0 (all pages), 1 (top-level pages only), 2 (top-level and 2nd level pages only), etc.</li>
<li><code>date_format</code> — e.g. ‘l, F j, Y’. See <a href="https://wordpress.org/documentation/article/customize-date-and-time-format/" rel="ugc">WordPress Date Format</a></li>
<li><code>exclude</code> — Comma-separated list of page IDs to exclude.</li>
<li><code>include</code> — Comma-separated list of page IDs to include.</li>
<li><code>item_spacing</code> — Whether to preserve whitespace within the menu’s HTML. Accepts ‘preserve’ or ‘discard’.</li>
<li><code>meta_key</code> — Limits output to pages having a specific custom field key. </li>
<li><code>meta_value</code> — Limits output to pages having a specific custom field value.</li>
<li><code>number</code> — Limits the number of links displayed (SQL LIMIT).</li>
<li><code>offset</code> — Skips a specific number of pages before displaying the list.</li>
<li><code>post_type</code> — Post type to query for. Default ‘page’</li>
<li><code>post_status</code> — Comma-separated list or array of post statuses to include. Default ‘publish’</li>
<li><code>show_date</code> — Whether to display the page publish or modified date for each page. Accepts ‘modified’ or any other value. An empty value hides the date.</li>
<li><code>sort_column</code> — Comma-separated list of column names to sort the pages by. Accepts ‘post_author’, ‘post_date’, ‘post_title’, ‘post_name’, ‘post_modified’, ‘post_modified_gmt’, ‘menu_order’, ‘post_parent’, ‘ID’, ‘rand’, or ‘comment_count’. Default ‘post_title’.</li>
<li><code>sort_order</code> — ‘ASC’ or ‘DESC’. Default ‘ASC’.</li>
</ul>
<p>Please see documentation for the <a href="https://codex.wordpress.org/Function_Reference/wp_list_pages" rel="nofollow ugc"><code>wp_list_pages</code></a> function for reference.</p>
<h3>Demos</h3>
<ul>
<li><a href="https://playground.wordpress.net/?blueprint-url=https%3A%2F%2Fraw.githubusercontent.com%2Fmandato-wordpress%2Fhtml-sitemap%2Frefs%2Fheads%2Fmain%2F.github%2Fblueprints%2Fblueprint-block.json" rel="nofollow ugc">Demo of the HTML Sitemap Block</a></li>
<li><a href="https://playground.wordpress.net/?blueprint-url=https%3A%2F%2Fraw.githubusercontent.com%2Fmandato-wordpress%2Fhtml-sitemap%2Frefs%2Fheads%2Fmain%2F.github%2Fblueprints%2Fblueprint-shortcode.json" rel="nofollow ugc">Demo of the HTML Sitemap shortcode</a></li>
</ul>
<p>In addition the following tag attributes are available exclusively for this plugin:</p>
<ul>
<li><code>class</code> — Specify class values for the initial HTML Page Sitemap <code><ul></code> list tag.</li>
<li><code>id</code> — Specify ID values for the initial HTML Page Sitemap <code><ul></code> list tag.</li>
<li><code>ordered_list_type</code> — Specify the ordered list type. Accepts ”, ‘1’, ‘A’, ‘a’, ‘I’, and ‘i’. Default empty value will display an unordered list.</li>
</ul>
<p>The <code>ordered_list_type</code> attribute options in more detail:</p>
<ul>
<li><code>ordered_list_type=""</code> — The list items will be unordered</li>
<li><code>ordered_list_type="1"</code> — The list items will be numbered with numbers</li>
<li><code>ordered_list_type="A"</code> — The list items will be numbered with uppercase letters</li>
<li><code>ordered_list_type="a"</code> — The list items will be numbered with lowercase letters</li>
<li><code>ordered_list_type="I"</code> — The list items will be numbered with uppercase roman numbers</li>
<li><code>ordered_list_type="i"</code> — The list items will be numbered with lowercase roman numbers</li>
</ul>
<p>Note: This plugin only works with Hierarchical Custom Post Types such as <code>pages</code>. This plugin will not work if your post type is not hierarchical. Not setting an ordered_list_type will use an unordered list (default).</p>
<h4>Examples</h4>
<p>First example shows how to add a sitemap for the entire site.</p>
<pre><code>[html_sitemap]
</code></pre>
<p>Example shortcode will add a sitemap to a page displaying a depth limit of 3 and exclude page ID 708.</p>
<pre><code>[html_sitemap depth=3 exclude=708]
</code></pre>
<p>Example shortcode will add a sitemap to a page displaying only children and grandchildren of the current page.</p>
<pre><code>[html_sitemap depth=2 child_of=CURRENT]
</code></pre>
<p>Example shortcode will add a sitemap to a page displaying children and grandchildren of the parent page (would include the curent page as well).</p>
<pre><code>[html_sitemap depth=2 child_of=PARENT]
</code></pre>
<p>Example shortcode will add a sitemap displaying the page modified date with the pages sorted by the menu order number.</p>
<pre><code>[html_sitemap show_date=modified sort_column=menu_order]
</code></pre>
<p>Example shortcode excluding multiple pages with ids 708, 1024 and 42.</p>
<pre><code>[html_sitemap exclude="708,1024,42"]
</code></pre>
<p>Example shortcode will add a class attribute to the <code><ul></code> tag.</p>
<pre><code>[html_sitemap class="custom-class"]
</code></pre>
<p>Example shortcode will add an id attribute to the <code><ul></code> tag.</p>
<pre><code>[html_sitemap id="custom-element-id"]
</code></pre>
<p>Example shortcode will display an ordered list using lowercase letters with a depth of 1.</p>
<pre><code>[html_sitemap ordered_list_type="a" depth=1]
</code></pre>
<p>Example shortcode with roman numbering in capitalization, with custom field “featured-list” and custom value “yes”</p>
<pre><code>[html_sitemap ordered_list_type="I" meta_key=featured-list meta_value=yes sort_column=post_date]
</code></pre>
<p>For the latest information visit the website.</p>
<p><a href="http://www.pluginspodcast.com/plugins/html-page-sitemap/" rel="nofollow ugc">http://www.pluginspodcast.com/plugins/html-page-sitemap/</a></p>
<h3>Contributors</h3>
<p><a href="https://angelo.mandato.com" rel="nofollow ugc">Angelo Mandato</a>, founder of <a href="https://www.painlessanalytics.com" rel="nofollow ugc">Painless Analytics</a> and <a href="https://www.frontpup.com" rel="nofollow ugc">FrontPup</a> – Plugin author</p>


HTML Page Sitemap (Block and Shortcode)

I felt the need to post a quick review for this plugin since it got a couple low ratings due to only including pages. The plugin clearly states it is for listing all of your pages only. It is not a normal XML sitemap. I'm giving it 5 stars because it is simple and does what I wanted. I simply wanted a page that listed all of my site's pages. This did it quickly and minimally. 

I do have one suggestion for the author. Rename the plugin. Instead of HTML Page Sitemap, perhaps it should be Simple Page List. Or, something that does not include "sitemap" since that word is what caused the couple low reviews, I think.

Simple

Adds an HTML (Not XML) sitemap of your pages (not posts) by using the HTML Sitemap Block or [html_sitemap] shortcode, perfect for those who use WordPr …

Jenst

<p>Place a shortcode into a post or a page (page recommended) and your sitemap will apear as a list with page numbers.</p>
<h4>Shortcode simple example</h4>
<p>[wp_sitemap]</p>
<h4>Features</h4>
<ul>
<li>Support for both posts and pages</li>
<li>Support for page numbers and option to place it on top or bottom</li>
<li>Support for include and exclude pages / posts</li>
<li>Support for disable posts / pages</li>
<li>Support for order by and sort order</li>
<li>No data added to the database</li>
<li>No settings page added into admin</li>
<li>Sitemap settings are added through a shortcode added in a page</li>
<li>WordPress built in functions are used to make a very small code</li>
</ul>
<h4>Shortcode advanced example</h4>
<p>[wp_sitemap pages=”false” exclude=”9,21,34″]</p>
<h4>Parameters</h4>
<p>exclude</p>
<ul>
<li>(string) Define a comma-separated list of Page IDs to be excluded from the list (example: ‘exclude=3,7,31’). There is no default value.</li>
</ul>
<p>include</p>
<ul>
<li>(string) Only include certain Pages or Posts in the sitemap. Like exclude, this parameter takes a comma-separated list of Page IDs. There is no default value.</li>
</ul>
<p>posts</p>
<ul>
<li>(string) Include Posts. Valid values:
<ul>
<li>true – Posts are included. (Default)</li>
<li>false – Posts are not included.</li>
</ul>
</li>
</ul>
<p>pages</p>
<ul>
<li>(string) Include Pages. Valid values:
<ul>
<li>true – Pages are included. (Default)</li>
<li>false – Pages are not included.</li>
</ul>
</li>
</ul>
<p>sort_column</p>
<ul>
<li>(string) Sorts the list of Posts and Pages in a number of different ways. The default setting is sort newest first by Post / Page date.
<ul>
<li>‘post_date’ – Published Post / Page date. (Default)</li>
<li>‘post_title’ – The Post or Page title.</li>
<li>‘post_modified’ – The updated Post or Page date.</li>
<li>‘comment_count’ – The number of comments on a Post or Page.</li>
<li>Other fields in the Posts table.</li>
</ul>
</li>
</ul>
<p>sort_order</p>
<ul>
<li>(string) Change the sort order of the list of Pages (either ascending or descending). The default is ascending. Valid values:
<ul>
<li>‘ASC’ – Sort from lowest to highest.</li>
<li>‘DESC’ – Sort from highest to lowest. (Default)</li>
</ul>
</li>
</ul>
<p>paging_position</p>
<ul>
<li>(string) The position of the page numbers. Valid values:
<ul>
<li>‘top’ – Add page numbers above the sitemap list</li>
<li>‘bottom’ – Add the page numbers below the sitemap list (Default)</li>
<li>‘both’ – Add page numbers above and below the sitemap list</li>
</ul>
</li>
</ul>
<p>post_count</p>
<ul>
<li>(string) Sets the number of Pages and Posts to display. The default is 50.</li>
</ul>
<h4>Shortcode default settings</h4>
<p>If you don’t know what this means, just ignore this section.</p>
<ul>
<li>exclude => 0</li>
<li>include => 0</li>
<li>posts => “true”</li>
<li>pages => “true”</li>
<li>sort_column => “post_date”</li>
<li>sort_order => “DESC”</li>
<li>paging_position => “bottom”</li>
<li>post_count => 50</li>
</ul>


WP Sitemap

A HTML sitemap with both post and pages. Easy to implement, just add a shortcode tag in a page.

HTML Page Sitemap (Block and Shortcode) vs WP Sitemap