Description
This plugin allows page authors to easily list any child pages of a given page by simply using a new [childpages]
shortcode. A basic list of the children to the page you’re editing will be returned with the shortcode [childpages]
. More-complex versions of the shortcode, as described in the Usage section, give you additional control over the output results.
Usage
The basic shortcode to get a page list is [childpages]
. Wherever you have a need to drop of a list of child pages for the page you’re currently authoring, just enter that code in either the Visual or HTML editor. The list that results will not be shown with a title, will be one level deep, will not exclude any child pages or authors, and will be sorted by page order and then by title.
To list the child pages with a title, use the enclosing form of the shortcode, like this:
[childpages]List Title[/childpages]
The text between the opening and closing shortcodes will be the title of the resulting list. It is being passed to the title_li
attribute in the wp_list_pages()
template tag.
To change the defaults used to format the list, pass the appropriate parameters in your shortcode, like this:
[childpages depth=2 sort_column=ID]
The parameters you provide are passed to wp_list_pages()
. The following parameters are supported; usage details for these parameters can be found in the WordPress Codex.
depth
child_of
exclude
echo
authors
sort_column
For more information, visit the plugin’s home page at http://scottierocket.com/wordpress-stuff/sr-childpages.
Installation
To start using the [childpages]
shortcode, install it by uploading the sr-childpages folder to your wp-content/plugins directory and then activate the plugin through the ‘Plugins’ menu in WordPress. Then just start using the shortcode in your pages!
FAQ
- Why did you do this?
-
Because none of the other plugins I’ve found that enabled similar functionality were exactly what I wanted. They either didn’t give me the control I wanted over things like sort order, or used comment tags that weren’t visible in the Visual editor, or both.
Reviews
There are no reviews for this plugin.
Contributors & Developers
“SR-ChildPages” is open source software. The following people have contributed to this plugin.
ContributorsTranslate “SR-ChildPages” into your language.
Interested in development?
Browse the code, check out the SVN repository, or subscribe to the development log by RSS.