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). Any valid WP_Query orderby value works.
  • displayimage: Show featured image (yes|no). 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.

Built by DK New Media, visit MarTech to keep up on this plugin and other marketing tools to help you grow your online presence!

스크린샷

  • View of the shortcode.
  • View of the output.

설치

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

FAQ

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.

후기

모든 2 평가 읽기

기여자 & 개발자

“List Child Pages Shortcode”(은)는 오픈 소스 소프트웨어입니다. 다음의 사람들이 이 플러그인에 기여하였습니다.

기여자

자국어로 “List Child Pages Shortcode”(을)를 번역하세요.

개발에 관심이 있으십니까?

코드 탐색하기는, SVN 저장소를 확인하시거나, 개발 기록RSS로 구독하세요.

변경이력

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