Title: List Pages Shortcode
Author: Aaron Harp
Published: Març 4, 2009
Last modified: Febrer 21, 2023
---
Search plugins
This plugin **hasn’t been tested with the latest 3 major releases of WordPress**.
It may no longer be maintained or supported and may have compatibility issues when
used with more recent versions of WordPress.
# List Pages Shortcode
By [Aaron Harp](https://profiles.wordpress.org/aaron_guitar/)
[Download](https://downloads.wordpress.org/plugin/list-pages-shortcode.1.7.7.zip)
* [Details](https://bal.wordpress.org/plugins/list-pages-shortcode/#description)
* [Reviews](https://bal.wordpress.org/plugins/list-pages-shortcode/#reviews)
* [Installation](https://bal.wordpress.org/plugins/list-pages-shortcode/#installation)
* [Development](https://bal.wordpress.org/plugins/list-pages-shortcode/#developers)
[Support](https://wordpress.org/support/plugin/list-pages-shortcode/)
## Description
Introduces the [list-pages], [sibling-pages] and [child-pages] [shortcodes](https://codex.wordpress.org/Shortcode_API)
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()`](https://codex.wordpress.org/Template_Tags/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](https://wordpress.org/plugins/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()](https://codex.wordpress.org/Template_Tags/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()](https://codex.wordpress.org/Template_Tags/wp_list_pages)
arguments, you can also specify:
* **list_type** _(string)_ List tag. Defaults to ``.
* **exclude_current_page** _(int)_ Exclude the current page. Defaults to `0`.
* **excerpt** _(int)_ Show the page excerpt. Defaults to `0`.
## Installation
1. Download and unzip the most recent version of this plugin
2. Upload the list-pages-shortcode folder to /path-to-wordpress/wp-content/plugins/
3. Login to your WP Admin panel, click Plugins, and activate “List Pages Shortcode”
## FAQ
### How do I include a page excerpt?
Firstly you will need to add support for excerpt for your pages. You can either
you this by using the [add_post_type_support()](https://codex.wordpress.org/Function_Reference/add_post_type_support)
function or using a plugin like [Page Excerpt](https://wordpress.org/extend/plugins/page-excerpt/).
You can also use the ‘list_pages_shortcode_excerpt’ filter to return or customize
the excerpt for specific pages. The following example:
You can then include the excerpt via your shortcode.
[list-pages excerpt=”1″]
## Reviews
### [Good one for FSE](https://wordpress.org/support/topic/good-one-for-fse/)
[Sunny](https://profiles.wordpress.org/frdmsun/) Juny 2, 2023
Used this where the Query block will not work.
### [Insdipensable](https://wordpress.org/support/topic/insdipensable-3/)
[dmsr](https://profiles.wordpress.org/dmsr/) Juliol 22, 2022
Extension installée, très pratique, sur des petits sites pour améliorer la navigation
### [Version 1.7.4 is working well](https://wordpress.org/support/topic/version-1-7-4-is-working-well/)
[ABCDiamond](https://profiles.wordpress.org/abcdiamond/) Octubre 6, 2019
Your plugin is working well. Ande I see that you are still supporting this, as you
answered someones support question just a few weeks ago. I am using your Version
1.7.4, with WordPress 5.2.3 But you might like to know that some users might be
warned about it, like this: Wordfence found the following new issues on “my website”
Alert generated at Saturday 5th of October 2019 at 07:54:45 PM Medium Severity Problems:*
The Plugin “List Pages Shortcode” appears to be abandoned (updated 28 March 2017,
tested to WP 4.4.19).
### [Great plugin, Great Support, Recommended](https://wordpress.org/support/topic/great-plugin-great-support-recommended/)
[edtorrey](https://profiles.wordpress.org/edtorrey/) Setembre 3, 2016
Using Webaware’s List Pages on several PHP.x web sites. Support for a broken update
was excellent with a very rapid resolution. Very much appreciated because we use
the code in many places.
### [simply works](https://wordpress.org/support/topic/simply-works-92/)
[faospark](https://profiles.wordpress.org/faospark/) Setembre 3, 2016
simply works. if one is not really dependent on posts and more on pages.this plugin
does the job
[ Read all 14 reviews ](https://wordpress.org/support/plugin/list-pages-shortcode/reviews/)
## Contributors & Developers
“List Pages Shortcode” is open source software. The following people have contributed
to this plugin.
Contributors
* [ Aaron Harp ](https://profiles.wordpress.org/aaron_guitar/)
* [ Ben Huson ](https://profiles.wordpress.org/husobj/)
[Translate “List Pages Shortcode” into your language.](https://translate.wordpress.org/projects/wp-plugins/list-pages-shortcode)
### Interested in development?
[Browse the code](https://plugins.trac.wordpress.org/browser/list-pages-shortcode/),
check out the [SVN repository](https://plugins.svn.wordpress.org/list-pages-shortcode/),
or subscribe to the [development log](https://plugins.trac.wordpress.org/log/list-pages-shortcode/)
by [RSS](https://plugins.trac.wordpress.org/log/list-pages-shortcode/?limit=100&mode=stop_on_copy&format=rss).
## Changelog
= 1.7.7=
* Fix sort order validation to allow for multiple sort columns.
#### 1.7.6
* Security Update: Validate all shortcode attributes and escape output.
#### 1.7.5
* Security Update: Sanitize HTML attributes before outputting.
#### 1.7.4
* Fix fatal error: validate_list_type() needs to be public!
#### 1.7.3
* Use PHP7 constructors.
* Validate list type and convert `- ` tags if not `
` list type.
* Checked WordPress 4.4.2 compatibility.
#### 1.7.2
* Add short code arguments to the shortcode_list_pages_before/after actions.
* Checked WordPress 4.2 compatibility.
#### 1.7.1
* When no list type specified don’t wrap in list tags.
* Update List_Pages_Shortcode_Walker_Page class with changes made to the WordPress
Walker_Page class.
* Checked WordPress 3.9 compatibility.
#### 1.7
* Add ‘list-pages-shortcode’ class to all lists.
#### 1.6
* Add default arg values to start_el() Walker method. Props eceleste.
* Added `shortcode_list_pages_before` action.
* Added `shortcode_list_pages_after` action.
* Added `list_pages_shortcode_item` filter.
* Allow specifying of `post_type`.
#### 1.5
* Added support for showing excerpt `[list-pages excerpt="1"]`.
* Allow filtering of excerpt output using ‘list_pages_shortcode_excerpt’ filter.
* Added support for outputting as ordered list `[list-pages list_type="ol"]`.
* Allow HTML in ‘title_li’ attribute.
#### 1.4
* Added support for ‘post_status’.
#### 1.3
* Added ‘shortcode_list_pages_attributes’ filter. Useful if you need to tweak any
attributes based on context or current post type.
* Allow ‘child_of’ to be overridden by shortcode parameter.
#### 1.2
* Added shortcode support for ‘exclude_current_page’ parameter.
* Added support for extra wp_list_pages() parameters: include, sort_order, meta_key,
meta_value and offset.
#### 1.1
* Added ‘shortcode_list_pages’ filter.
* Added [sibling-pages] shortcode.
#### 1.0
* First release.
## Meta
* Version **1.7.7**
* Last updated **3 anys ago**
* Active installations **5.000+**
* WordPress version ** 4.4.0 or higher **
* Tested up to **6.1.10**
* Language
* [English (US)](https://wordpress.org/plugins/list-pages-shortcode/)
* Tags
* [child pages](https://bal.wordpress.org/plugins/tags/child-pages/)[list pages](https://bal.wordpress.org/plugins/tags/list-pages/)
[pages](https://bal.wordpress.org/plugins/tags/pages/)[shortcodes](https://bal.wordpress.org/plugins/tags/shortcodes/)
* [Advanced View](https://bal.wordpress.org/plugins/list-pages-shortcode/advanced/)
## Ratings
4.9 out of 5 stars.
* [ 12 5-star reviews ](https://wordpress.org/support/plugin/list-pages-shortcode/reviews/?filter=5)
* [ 2 4-star reviews ](https://wordpress.org/support/plugin/list-pages-shortcode/reviews/?filter=4)
* [ 0 3-star reviews ](https://wordpress.org/support/plugin/list-pages-shortcode/reviews/?filter=3)
* [ 0 2-star reviews ](https://wordpress.org/support/plugin/list-pages-shortcode/reviews/?filter=2)
* [ 0 1-star reviews ](https://wordpress.org/support/plugin/list-pages-shortcode/reviews/?filter=1)
[Your review](https://wordpress.org/support/plugin/list-pages-shortcode/reviews/#new-post)
[See all reviews](https://wordpress.org/support/plugin/list-pages-shortcode/reviews/)
## Contributors
* [ Aaron Harp ](https://profiles.wordpress.org/aaron_guitar/)
* [ Ben Huson ](https://profiles.wordpress.org/husobj/)
## Support
Got something to say? Need help?
[View support forum](https://wordpress.org/support/plugin/list-pages-shortcode/)
## Donate
Would you like to support the advancement of this plugin?
[ Donate to this plugin ](https://www.paypal.com/cgi-bin/webscr?cmd=_donations&business=aaron%40freshwebs%2enet&item_name=Fotobook%20Donation&no_shipping=0&no_note=1&tax=0¤cy_code=USD&lc=US&bn=PP%2dDonationsBF&charset=UTF%2d8)