Title: List Pages Shortcode
Author: Aaron Harp
Published: <strong>2009-يىلى 4-مارت</strong>
Last modified: 2023-يىلى 21-فېۋرال

---

قىستۇرما ئىزدە

![](https://ps.w.org/list-pages-shortcode/assets/banner-772x250.png?rev=1142967)

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.

![](https://ps.w.org/list-pages-shortcode/assets/icon-256x256.png?rev=1142967)

# List Pages Shortcode

 يازغۇچى [Aaron Harp](https://profiles.wordpress.org/aaron_guitar/)

[چۈشۈر](https://downloads.wordpress.org/plugin/list-pages-shortcode.1.7.7.zip)

 * [تەپسىلاتلار](https://ug.wordpress.org/plugins/list-pages-shortcode/#description)
 * [باھالاشلار](https://ug.wordpress.org/plugins/list-pages-shortcode/#reviews)
 *  [ئورنىتىش](https://ug.wordpress.org/plugins/list-pages-shortcode/#installation)
 * [ئىجادىيەت](https://ug.wordpress.org/plugins/list-pages-shortcode/#developers)

 [قوللاش](https://wordpress.org/support/plugin/list-pages-shortcode/)

## چۈشەندۈرۈش

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 `<ul>`.
 * **exclude_current_page** _(int)_ Exclude the current page. Defaults to `0`.
 * **excerpt** _(int)_ Show the page excerpt. Defaults to `0`.

## ئورنىتىش

 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″]

## باھالاشلار

![](https://secure.gravatar.com/avatar/773ac53bd698849a95cabd96f462f7708afc67ffd987cbaf0ec54ad0224061ea?
s=60&d=retro&r=g)

### 󠀁[Good one for FSE](https://wordpress.org/support/topic/good-one-for-fse/)󠁿

 [Sunny](https://profiles.wordpress.org/frdmsun/) 2023-يىلى 2-ئىيۇن

Used this where the Query block will not work.

![](https://secure.gravatar.com/avatar/0771f018c5c481aecb62b5789070e663f32e747831b01c657b7246e43dc9ed21?
s=60&d=retro&r=g)

### 󠀁[Insdipensable](https://wordpress.org/support/topic/insdipensable-3/)󠁿

 [dmsr](https://profiles.wordpress.org/dmsr/) 2022-يىلى 22-ئىيۇل

Extension installée, très pratique, sur des petits sites pour améliorer la navigation

![](https://secure.gravatar.com/avatar/89b45425e064295d8ca0af8f178b5357fa1e202761a12b68bea93fcbf00b31f1?
s=60&d=retro&r=g)

### 󠀁[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/) 2019-يىلى 6-ئۆكتەبىر

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).

![](https://secure.gravatar.com/avatar/f77bb27216222cb15c71fb66b001961cfc51d7fa9a2bfb72f0af0b1c90f015b3?
s=60&d=retro&r=g)

### 󠀁[Great plugin, Great Support, Recommended](https://wordpress.org/support/topic/great-plugin-great-support-recommended/)󠁿

 [edtorrey](https://profiles.wordpress.org/edtorrey/) 2016-يىلى 3-سېنتەبىر

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.

![](https://secure.gravatar.com/avatar/8ac685e8921cd7f33441b7099600fbe6cc87013ca810162ae2415a8a686bf8bb?
s=60&d=retro&r=g)

### 󠀁[simply works](https://wordpress.org/support/topic/simply-works-92/)󠁿

 [faospark](https://profiles.wordpress.org/faospark/) 2016-يىلى 3-سېنتەبىر

simply works. if one is not really dependent on posts and more on pages.this plugin
does the job

 [ 14 باھالاشنىڭ ھەممىنى ئوقۇش ](https://wordpress.org/support/plugin/list-pages-shortcode/reviews/)

## تۆھپىكار ۋە ئىجادكار

«List Pages Shortcode» كودى ئوچۇق يۇمشاق دېتال. تۆۋەندىكى كىشىلەر بۇ قىستۇرمىغا 
تۆھپە قوشقان.

تۆھپىكار

 *   [ Aaron Harp ](https://profiles.wordpress.org/aaron_guitar/)
 *   [ Ben Huson ](https://profiles.wordpress.org/husobj/)

[«List Pages Shortcode» نى تىلىڭىزغا تەرجىمە قىلىڭ](https://translate.wordpress.org/projects/wp-plugins/list-pages-shortcode)

### ئىجادىيەتكە قىزىقامسىز؟

[كودقا كۆز يۈگۈرتۈپ](https://plugins.trac.wordpress.org/browser/list-pages-shortcode/)،
[SVN خەزىنە](https://plugins.svn.wordpress.org/list-pages-shortcode/) تەكشۈرۈپ ياكى
[RSS](https://plugins.trac.wordpress.org/log/list-pages-shortcode/?limit=100&mode=stop_on_copy&format=rss)
ئارقىلىق [ئىجادىيەت خاتىرىسى](https://plugins.trac.wordpress.org/log/list-pages-shortcode/)
گە مۇشتەرى بولغىلى بولىدۇ.

## ئۆزگىرىش خاتىرىسى

= 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 `<li>` tags if not `<ul>` 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**
 *  ئاخىرقى يېڭىلانغان ۋاقىت **3 يىل بۇرۇن**
 *  ئاكتىپ ئورنىتىش سانى **5,000+**
 *  WordPress نەشرى ** 4.4.0 ياكى يۇقىرى **
 *  **6.1.10** دا سىنالغان
 *  تىل
 * [English (US)](https://wordpress.org/plugins/list-pages-shortcode/)
 * بەلگە
 * [child pages](https://ug.wordpress.org/plugins/tags/child-pages/)[list pages](https://ug.wordpress.org/plugins/tags/list-pages/)
   [pages](https://ug.wordpress.org/plugins/tags/pages/)[shortcodes](https://ug.wordpress.org/plugins/tags/shortcodes/)
 *  [ئالىي كۆرۈنۈش](https://ug.wordpress.org/plugins/list-pages-shortcode/advanced/)

## دەرىجە

 4.9/5 يۇلتۇز

 *  [  12 5-يۇلتۇز باھالاش     ](https://wordpress.org/support/plugin/list-pages-shortcode/reviews/?filter=5)
 *  [  2 4-يۇلتۇز باھالاش     ](https://wordpress.org/support/plugin/list-pages-shortcode/reviews/?filter=4)
 *  [  0 3-يۇلتۇز باھالاش     ](https://wordpress.org/support/plugin/list-pages-shortcode/reviews/?filter=3)
 *  [  0 2-يۇلتۇز باھالاش     ](https://wordpress.org/support/plugin/list-pages-shortcode/reviews/?filter=2)
 *  [  0 1-يۇلتۇز باھالاش     ](https://wordpress.org/support/plugin/list-pages-shortcode/reviews/?filter=1)

[Your review](https://wordpress.org/support/plugin/list-pages-shortcode/reviews/#new-post)

[بارلىق ئىنكاسنى كۆرسەت](https://wordpress.org/support/plugin/list-pages-shortcode/reviews/)

## تۆھپىكار

 *   [ Aaron Harp ](https://profiles.wordpress.org/aaron_guitar/)
 *   [ Ben Huson ](https://profiles.wordpress.org/husobj/)

## قوللاش

چۈشەندۈرۈشىڭىز بارمۇ؟ ياردەم لازىممۇ؟

 [قوللاش مۇنبىرىنى كۆرسەت](https://wordpress.org/support/plugin/list-pages-shortcode/)

## ئىئانە

بۇ قىستۇرمىنىڭ ياخشىلىنىشىنى قوللامسىز؟

 [ بۇ قىستۇرمىغا ئىئانە قىلىش ](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&currency_code=USD&lc=US&bn=PP%2dDonationsBF&charset=UTF%2d8)