RC Site Map Plugin

This plugin adds a shortcode that will list a hierarchical site map or list of a particular type of post such as page, post or custom post types with clickable links to view each listed entry. The shortcode is registered using the name: rc_sitemap. The shortcode will by default render an unordered list of the entries with a default class of "rc_sitemap_list". The optional heading that it outputs has the default class of rc_sitemap_heading.

Overview of shortcode

Site map (rc_sitemap)

This shortcode is used to get and render a list of published posts like a site map. The attributes are as follows:

• post_type – defaults to ‚page‘. You can use ‚post‘, ‚page‘ or any post type name.
• orderby – defaults to ‚menu_order‘. Comma-separated list of options to sort by: accepts ‚post_author‘, ‚post_date‘, ‚post_title‘, ‚post_name‘, ‚post_modified‘, ‚post_modified_gmt‘, ‚menu_order‘, ‚post_parent‘, ‚ID‘, ‚rand‘, or ‚comment_count‘.
• order – defaults to ‚ASC‘.
• heading_text – defaults to empty, show no heading.
• heading_tag – defaults to h2. Note, do not include greater than / less than characters, only the alphanumeric characters e.g. p, h1, h2, h3 etc.
• heading_class – defaults to 'rc_sitemap_heading'. CSS Class added to the heading element.
• child_of – defaults to empty. Display only the sub-pages of a single page by ID. Default 0 (all pages). Note, only works for hierarchical post types.
• depth – defaults to empty. Number of levels in the hierarchy of pages to include in the generated list. Accepts -1 (any depth), 0 (all pages), 1 (top-level pages only), and n (pages to the given n depth).
• exclude – defaults to empty. Comma-separated list of post IDs to exclude.
• include – defaults to empty. Comma-separated list of post IDs to include.
• wrapper – defaults to 'ul'. Wrapping element of the list. Note, do not include greater than / less than characters, only the alphanumeric characters e.g. ul, p etc.
• wrapper_class – defaults to 'rc_sitemap_list'. CSS Class added to the wrapping element of the list.

Example usage:

The most basic shortcode will render a list of page post type entries as an unordered HTML list in ascending order with no list heading:

The following is an example of a more advanced usage with custom settings applied via the various additional attributes: