Description
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:
[rc_sitemap]
The following is an example of a more advanced usage with custom settings applied via the various additional attributes:
[rc_sitemap post_type="your_cpt_name" orderby="date" order="DESC" heading_text="My CPT Title" heading_tag="h1" heading_class="my_custom_heading_class" wrapper="ul" wrapper_class="my_custom_wrapper_class"]