WordPress.org

Plugin Directory

List Pages Shortcode

Introduces the [list-pages], [sibling-pages] and [child-pages] shortcodes for easily displaying a list of pages within a post or page.

Introduces the [list-pages], [sibling-pages] and [child-pages] shortcodes for easily displaying a list of pages within a post or page. Both shortcodes accept all parameters that you can pass to the wp_list_pages() function with the addition of a class parameter.

Example Usage

List pages sorted by title

[list-pages sort_column="post_title"]

List pages but exclude certain IDs and set the class of the list to "my-page-list"

[list-pages exclude="17,38" class="my-page-list"]

Show excerpt (for pages excerpt support will need adding manually or via the Page Excerpt plugin)

[list-pages excerpt="1"]

List the current page's children, but only show the top level

[child-pages depth="1"]

List the current page's siblings and their subpages

[sibling-pages depth="2"]

Default Arguments

The default values are the same as for the wp_list_pages() function except for title_li which defaults to nothing. If a class is not specified, a default class of either "list-pages", "sibling-pages" or "child-pages" is given to the UL tag. In addition, the echo parameter has no effect.

In addition to the wp_list_pages() arguments, you can also specify:

  • list_type (string) List tag. Defaults to <ul>.
  • exclude_current_page (int) Exclude the current page. Defaults to 0.
  • excerpt (int) Show the page excerpt. Defaults to 0.

Requires: 3.5 or higher
Compatible up to: 4.2.2
Last Updated: 2015-4-23
Active Installs: 10,000+

Ratings

4.8 out of 5 stars

Support

1 of 3 support threads in the last two months have been resolved.

Got something to say? Need help?

Compatibility

+
=
Not enough data

0 people say it works.
0 people say it's broken.

100,1,1
100,1,1
100,2,2
100,3,3
100,3,3
100,1,1
100,1,1
100,1,1 100,1,1
100,2,2
100,2,2 100,3,3 100,1,1
100,1,1
100,1,1
0,1,0 100,2,2
100,1,1
100,7,7
100,2,2
100,6,6
100,4,4
100,1,1
100,2,2 100,6,6 100,1,1
100,2,2 100,3,3
100,2,2
100,3,3 100,1,1
100,2,2 100,1,1
50,2,1 100,1,1
100,3,3
100,1,1
100,2,2 100,1,1
100,1,1
100,1,1
100,1,1
100,1,1
100,1,1
100,2,2
100,1,1