RC Site Map Plugin

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

No, this plugin does not make an XML site map file for use with search engines. This plugin renders lists of posts (page, post or custom post types) into standard page / post content to be viewed by people visiting your website. I don't see a list of posts / pages on my site, I only see text like this: [rc_sitemap] Check that the plugin has been correctly uploaded, installed and activated. If not then the text of the shortcode will not be processed and will simply display on the site.

By default the wrapping element of the rendered list is a <ul> tag which has a default class of rc_sitemap_list. It is possible to change the wrapping element via the wrapper attribute of the shortcode, however, the listed items are always wrapped in <li> elements so you should really only change the wrapper to use either <ol> (via wrapper="ol") to create an ordered list or set it to an empty value (via wrapper="") to render no wrapping element. Using any other wrapping element will technically work but would render an invalid HTML structure and may not display nicely in web browsers. The optional heading_text attribute can be used to provide a heading for the list using either the default h2 tag or a custom element using the accompanying heading_tag attribute (e.g. heading_text="Hello World!" heading_tag="h1"). The heading has a default class of rc_sitemap_heading which can be changed using the heading_class attribute. The plugin doesn't provide any default CSS styling but simply adds these default classes to the rendered HTML output, so you can either add styles using the standard rc_sitemap_list and rc_sitemap_heading classes or add your own using the attributes outlined above. Note: multiple CSS classes can be added to the above elements by separating them with spaces (e.g. wrapper_class="my_first_class my_second_class my_third_class"). In addition to the elements and classes specified above, each of the rendered list items and inner hyperlink have some default classes that are added as part of the plugin's use of wp_list_pages to retrieve the list of entries: page_item - This class is added to each li list element. page-item-$ID - This is a unique class added to each li list element, the $ID part would be the unique ID that represents that entry in WordPress, e.g. page-item-123. current_page_item - This class is added to the li list element that is a link to the current page (basically the page you have this shortcode on). current_page_parent - This class is added to the li list element that is a link to the hierarchical parent of the current page (basically the parent of the page you have this shortcode on). current_page_ancestor - This class is added to the li list elements that are hierarchical ancestors of the current page. If necessary the above default classes can be overridden from within your theme by specifying them in some custom CSS. My custom post type won't show up For custom post types to be listed by this plugin they currently have to be hierarchical, e.g. in the 'register_post_type' function for setting up the CPT it would have hierarchical' => true and 'capability_type' => 'page'. A future update should enable all kinds of CPTs but for now this is required for CPTs to work with this plugin.