Title: List Child Pages Shortcode
Author: Douglas Karr
Published: <strong>2018 年 7 月 12 日</strong>
Last modified: 2026 年 9 月 18 日

---

搜索插件

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

![](https://ps.w.org/list-child-pages-shortcode/assets/icon.svg?rev=3702752)

# List Child Pages Shortcode

 作者：[Douglas Karr](https://profiles.wordpress.org/douglaskarr/)

[下载](https://downloads.wordpress.org/plugin/list-child-pages-shortcode.1.5.1.zip)

 * [详情](https://cn.wordpress.org/plugins/list-child-pages-shortcode/#description)
 * [评价](https://cn.wordpress.org/plugins/list-child-pages-shortcode/#reviews)
 *  [安装](https://cn.wordpress.org/plugins/list-child-pages-shortcode/#installation)
 * [开发进展](https://cn.wordpress.org/plugins/list-child-pages-shortcode/#developers)

 [支持](https://wordpress.org/support/plugin/list-child-pages-shortcode/)

## 描述

I could not find an easy plugin that enabled me to use a shortcode that would enable
me to publish a list of child pages under a parent page. So, I built one.

#### Usage

The shortcode is `[listchildpages]...[/listchildpages]`. It accepts several attributes:

 * **ifempty**: Message or HTML to show if no child pages exist.
 * **order**: `ASC` or `DESC`. Default: `DESC`.
 * **orderby**: Field to order by. Default: `publish_date` (maps to `date`). Also
   accepts `published` (maps to `date`), `title`, `name`, `modified`, `menu_order`,`
   ID`, `rand`, `type`, and `author`.
 * **displayimage**: Show featured image (`yes|no`). Also accepts `y`, `true`, `
   1`, and `on`. Default: `no`.
 * **align**: CSS class to apply to the image (`alignleft`, `alignright`, etc.).
 * **ulclass, liclass, aclass**: CSS classes for the list, list items, and links.
 * **parent**: ID, slug/path, or `current` to choose the parent page. Default: `
   current`.
 * **size**: Image size for thumbnails (`thumbnail`, `medium`, `large`, `full`, 
   or custom size). Default: `thumbnail`.

Examples:

Example 1: Order the child pages by publish date in descending order:
 [listchildpages
aclass=”” ifempty=”No child pages” orderby=”publish_date” order=”desc” displayimage
=”no”]

### Here are our child pages:

    ```
    [/listchildpages]
    ```

Example 2: Order the child pages by title in ascending order with the page’s featured
image aligned left:
 [listchildpages orderby=”title” order=”asc” displayimage=”yes”
align=”alignleft”]

### Here are our child pages:

    ```
    [/listchildpages]
    ```

Example 3: Target a specific parent page by ID and use medium-sized images:
 [listchildpages
parent=”123″ displayimage=”yes” size=”medium”]

### Resources

    ```
    [/listchildpages]
    ```

Example 4: Target a parent page by slug and show full-size featured images:
 [listchildpages
parent=”about/company” displayimage=”yes” size=”full”]

### Team Sections

    ```
    [/listchildpages]
    ```

Example 5: Explicitly set the parent as the current page and use large images:
 [
listchildpages parent=”current” displayimage=”yes” size=”large”]

### Subpages

    ```
    [/listchildpages]
    ```

The shortcode accepts all of the Order and Orderby Parameters listed within the 
[WordPress class reference](https://codex.wordpress.org/Class_Reference/WP_Query#Order_.26_Orderby_Parameters).

Built by [DK New Media](http://www.dknewmedia.com), visit [MarTech](https://martech.zone)
to keep up on this plugin and other marketing tools to help you grow your online
presence!

## 屏幕截图

[⌊View of the shortcode.⌉⌊View of the shortcode.⌉[

View of the shortcode.

[⌊View of the output.⌉⌊View of the output.⌉[

View of the output.

## 安装

 1. Activate the plugin through the ‘Plugins’ menu in WordPress.

## 常见问题

### How can I add a description for each child page?

Edit the child page and you’ll find an excerpt section where you can enter a description
that will be published on the list.

### How can I enable featured images on my site?

Within your functions.php file, look for the add_theme_support post-thumbnails line
and add page to the array. Or if you don’t have that line, you can just add it:

    ```
    add_theme_support( 'post-thumbnails', array( 'post', 'page' ) );
    ```

### How can I modify the output?

There are additional class fields for the unordered list tag (ulclass), list item
tag (liclass), and the anchor tag (aclass). You can modify the output utilizing 
your theme’s CSS.

### What happens if I deactivate or uninstall the plugin?

Nothing in the database is stored or removed. The plugin has no settings, options,
custom tables, or uninstall routine. Deactivate or delete it and your pages, excerpts,
and featured images stay as they are. Shortcodes left in content will simply stop
rendering until the plugin is activated again.

## 评价

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

### 󠀁[Excellent Plugin – Shortcodes with lots of options](https://wordpress.org/support/topic/excellent-plugin-shortcodes-with-lots-of-options/)󠁿

 [niallflynn](https://profiles.wordpress.org/wordpressdublin/) 2020 年 7 月 22 日

Really handy plugin. Examples are very handy too.

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

### 󠀁[Awesome. Someone finally brought this useful feature back](https://wordpress.org/support/topic/awesome-someone-finally-brought-this-useful-feature-back/)󠁿

 [jaffray](https://profiles.wordpress.org/jaffray/) 2018 年 8 月 14 日 1 回复

All the previous plugins that solved this challenge are all dead or not maintained.

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

### 󠀁[Great Shortcode!](https://wordpress.org/support/topic/great-shortcode-2/)󠁿

 [Douglas Karr](https://profiles.wordpress.org/douglaskarr/) 2018 年 8 月 8 日

Would love to see this shortcode actually added to the core platform.

 [ 阅读所有2条评价 ](https://wordpress.org/support/plugin/list-child-pages-shortcode/reviews/)

## 贡献者及开发者

「List Child Pages Shortcode」是开源软件。 以下人员对此插件做出了贡献。

贡献者

 *   [ Douglas Karr ](https://profiles.wordpress.org/douglaskarr/)

[帮助将「List Child Pages Shortcode」翻译成简体中文。](https://translate.wordpress.org/projects/wp-plugins/list-child-pages-shortcode)

### 对开发感兴趣吗?

您可以[浏览代码](https://plugins.trac.wordpress.org/browser/list-child-pages-shortcode/)，
查看[SVN仓库](https://plugins.svn.wordpress.org/list-child-pages-shortcode/)，或
通过[RSS](https://plugins.trac.wordpress.org/log/list-child-pages-shortcode/?limit=100&mode=stop_on_copy&format=rss)
订阅[开发日志](https://plugins.trac.wordpress.org/log/list-child-pages-shortcode/)。

## 更新日志

#### 1.5.1

 * Align Version and Stable tag so WordPress.org serves the current code.
 * Declare compatibility with WordPress 7.1.
 * Raise minimum WordPress version to 3.1 (required by current APIs).
 * Match the text domain to the plugin slug for translations.
 * Keep default empty-state HTML out of the translatable string.
 * Accept additional `orderby` values (`rand`, `type`, `author`) and the `published`
   alias.
 * Accept `on` as a truthy `displayimage` value.
 * Query child page IDs so the shortcode does not take over the main Loop. Default
   markup is unchanged.

#### 1.4.1

 * Updated keywords for plugin

#### 1.4.0

 * Added `parent` attribute to target a specific parent page by ID or slug.
 * Added `size` attribute to choose featured image size.
 * Hardened shortcode sanitization and escaping for security.
 * Backward-compatible with previous versions.

#### 1.3.2

 * Tested in latest versions of WordPress

#### 1.3.1

 * Tested in latest versions of WordPress

#### 1.3.0

 * Added an option to display the featured image for the page.
 * Added class outputs for the ul and li tags in addition to the anchor text.

#### 1.2.2

 * Corrected an undeclared variable error.

#### 1.2.1

 * Added documentation on where you can see all of the order and orderby parameters.

#### 1.2.0

 * Added another shortcode option for the order. Default is DESC.

#### 1.1.0

 * Added another shortcode option for the orderby. Default is publish_date.

#### 1.0.0

 * Initial Release

## 额外信息

 *  版本 **1.5.1**
 *  最后更新：**4 周前**
 *  活跃安装数量 **600+**
 *  WordPress 版本 ** 3.1 或更高版本 **
 *  已测试的最高版本为 **7.1.3**
 *  PHP 版本 ** 7.4 或更高版本 **
 *  语言
 * [English (US)](https://wordpress.org/plugins/list-child-pages-shortcode/)
 * 标签
 * [child page](https://cn.wordpress.org/plugins/tags/child-page/)[page](https://cn.wordpress.org/plugins/tags/page/)
   [parent page](https://cn.wordpress.org/plugins/tags/parent-page/)[shortcode](https://cn.wordpress.org/plugins/tags/shortcode/)
 *  [高级视图](https://cn.wordpress.org/plugins/list-child-pages-shortcode/advanced/)

## 评级

 5 星（最高 5 星）。

 *  [  3 条 5 星评价     ](https://wordpress.org/support/plugin/list-child-pages-shortcode/reviews/?filter=5)
 *  [  0 条 4 星评价     ](https://wordpress.org/support/plugin/list-child-pages-shortcode/reviews/?filter=4)
 *  [  0 条 3 星评价     ](https://wordpress.org/support/plugin/list-child-pages-shortcode/reviews/?filter=3)
 *  [  0 条 2 星评价     ](https://wordpress.org/support/plugin/list-child-pages-shortcode/reviews/?filter=2)
 *  [  0 条 1 星评价     ](https://wordpress.org/support/plugin/list-child-pages-shortcode/reviews/?filter=1)

[您的评价](https://wordpress.org/support/plugin/list-child-pages-shortcode/reviews/#new-post)

[查看全部评论](https://wordpress.org/support/plugin/list-child-pages-shortcode/reviews/)

## 贡献者

 *   [ Douglas Karr ](https://profiles.wordpress.org/douglaskarr/)

## 支持

有话要说吗？是否需要帮助？

 [查看支持论坛](https://wordpress.org/support/plugin/list-child-pages-shortcode/)

## 捐助

您愿意支持这个插件的发展吗?

 [ 捐助此插件 ](https://dknewmedia.com)