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.

PageMagic – Page Lists

Description

Create visual hierarchies of site pages. Options to list all pages, subpages, current page siblings. Also able to show page featured image and custom excerpts.

Quick Shortcodes

  • [pagemagic_listall] – hierarchical tree of all pages on site (useful to show sitemap of the site)
  • [pagemagic_subpages] – hierarchical tree of subpages to the current page
  • [pagemagic_siblings] – hierarchical tree of sibling pages to the current page
  • [pagemagic_image_excerpt] – list of pages with featured image and with excerpt

Example Parameters

  • [pagemagic_listall child_of="4" depth="2" exclude="6,7,8"]
  • [pagemagic_image_excerpt child_of="4" exclude="6,7,8" image_width="50" image_height="50"]

Page List Parameters

  • [pagemagic_listall] – list of all pages as the hierarchical list
  • [pagemagic_subpages] – list of subpages to the current page as the hierarchical list; Same as: [pagemagic_listall child_of="current"]
  • [pagemagic_siblings] – list of sibling pages to the current page as the hierarchical list; Same as: [pagemagic_listall child_of="parent"]
  • depth – how many levels in the hierarchy of pages are to be included in the list: [pagemagic_listall depth="3"]; by default depth is unlimited (depth=โ€0″); Displays pages at any depth and arranges them in a flat list: [pagemagic_listall depth="-1"]
  • child_of – displays the sub-pages of a single Page by ID: [pagemagic_listall child_of="4"]
  • exclude – define a comma-separated list of Page IDs to be excluded from the list: [pagemagic_listall exclude="6,7,8"]; You may exclude current page: [pagemagic_listall exclude="current"]
  • exclude_tree – define a comma-separated list of parent Page IDs and all its subpages to be excluded: [pagemagic_listall exclude_tree="7,10"]
  • include – include a comma-separated list of Page IDs into the list: [pagemagic_listall include="6,7,8"]
  • title_li – set the text and style of the Page list’s heading: [pagemagic_listall title_li="<h2>List of pages</h2>"]; by default there is no title (title_li=โ€โ€)
  • authors – only include pages authored by the authors in this comma-separated list of author IDs: [pagemagic_listall authors="2,5"]; by default all authors are included (authors=โ€โ€)
  • number – sets the number of pages to display: [pagemagic_listall number="10"]; by default the number is unlimited (number=โ€โ€)
  • offset – the number of pages to pass over (or displace) before collecting the set of pages: [pagemagic_listall offset="5"]; by default there is no offset (offset=โ€โ€)
  • post_type – list associated with a certain hierarchical Post Type [pagemagic_listall post_type="page"]; by default: (post_type=โ€pageโ€); possible values: page, revision, Hierarchical Custom Post Types (โ€˜postโ€™ is not a Hierarchical Post Type)
  • post_status – a comma-separated list of all post status types: [pagemagic_listall post_status="private"]; by default: (post_status=โ€publishโ€); possible values: publish, private, draft
  • meta_key and meta_value – only include the pages that have this Custom Field Key and this Custom Field Value: [pagemagic_listall meta_key="metakey" meta_value="metaval"]
  • show_date – display creation or last modified date next to each Page: [pagemagic_listall show_date="created"]; possible values: created, modified, updated
  • date_format – the format of the Page date set by the show_date parameter: [pagemagic_listall date_format="l, F j, Y"]; by default use the date format configured in your WordPress options
  • sort_column – sort the list of pages by column: [pagemagic_listall sort_column="menu_order"]; by default: (sort_column=โ€menu_order, post_titleโ€); possible values: post_title, menu_order, post_date (sort by creation time), post_modified, ID, post_author, post_name (sort by page slug)
  • sort_order – the sort order of the list of pages (either ascending or descending): [pagemagic_listall sort_order="desc"]; by default: (sort_order=โ€ascโ€); possible values: asc, desc
  • link_before – sets the text or html that precedes the link text inside link tag: [pagemagic_listall link_before="<span>"]; you may specify html tags only in the HTML tab in your Rich-text editor
  • link_after – sets the text or html that follows the link text inside link tag: [pagemagic_listall link_after="</span>"]; you may specify html tags only in the HTML tab in your Rich-text editor
  • class – the CSS class for list of pages: [pagemagic_listall class="listclass"]; by default the class is empty (class=โ€โ€)
  • columns – for splitting list of pages into columns: [pagemagic_listall class="pagemagic-cols-2"]; available classes: pagemagic-cols-2, pagemagic-cols-3, pagemagic-cols-4, pagemagic-cols-5; works in all modern browsers and IE10+; columns are responsive and become 1 column at less than 768px

[More info] about parameters (https://developer.wordpress.org/reference/functions/get_pages/#parameters) for [pagemagic_listall].

Parameters for Page List Excerpts

  • [pagemagic_image_excerpt] – by default shows list of subpages to current page; but if there is no subpages than all pages will be shown
  • show_image – show or hide featured image [pagemagic_image_excerpt show_image="0"]; โ€œshow_imageโ€ have higher priority than โ€œshow_first_imageโ€; by default: show_image=โ€1″
  • show_first_image – show or hide first image from content if there is no featured image [pagemagic_image_excerpt show_first_image="1"]; by default: show_first_image=โ€0″
  • show_title – show or hide title [pagemagic_image_excerpt show_title="0"]; by default: show_title=โ€1″
  • show_content – show or hide content [pagemagic_image_excerpt show_content="0"]; by default: show_content=โ€1″
  • more_tag – output all content before and after more tag: [pagemagic_image_excerpt more_tag="0"]; this parameter does not add โ€œmore-linkโ€ to the end of content, it just cut content before more-tag; โ€œmore_tagโ€ parameter have higher priority than โ€œlimit_contentโ€; by default the more_tag is enabled (more_tag=โ€1″) and showing only content before more tag
  • limit_content – content is limited by โ€œmore-tagโ€ if it is exist or by โ€œlimit_contentโ€ parameter [pagemagic_image_excerpt limit_content="100"]; by default: limit_content=โ€250″
  • image_width – width of the image [pagemagic_image_excerpt image_width="80"]; by default: image_width=โ€50″
  • image_height – height of the image [pagemagic_image_excerpt image_height="80"]; by default: image_height=โ€50″
  • child_of – displays the sub-pages of a single Page by ID: [pagemagic_image_excerpt child_of="4"]; by default it shows subpages to the current page
  • parent – list those pages that have the provided single page only ID as parent: [pagemagic_image_excerpt parent="4"]; by default parent=โ€-1″ and depth is unlimited
  • sort_column – sort the list of pages by column: [pagemagic_image_excerpt sort_column="menu_order"]; by default: (sort_column=โ€menu_order, post_titleโ€); possible values: post_title, menu_order, post_date (sort by creation time), post_modified, ID, post_author, post_name (sort by page slug)
  • sort_order – the sort order of the list of pages (either ascending or descending): [pagemagic_image_excerpt sort_order="desc"]; by default: (sort_order=โ€ascโ€); possible values: asc, desc;* hierarchical – display subpages below their parent page [pagemagic_image_excerpt hierarchical="0"]; by default: hierarchical=โ€1″
  • hierarchical – display subpages below their parent page [pagemagic_image_excerpt hierarchical="0"]; by default: hierarchical=โ€1″
  • exclude – define a comma-separated list of Page IDs to be excluded from the list: [pagemagic_image_excerpt exclude="6,7,8"]
  • exclude_tree – define a comma-separated list of parent Page IDs and all its subpages to be excluded: [pagemagic_image_excerpt exclude_tree="7,10"]
  • include – include a comma-separated list of Page IDs into the list: [pagemagic_image_excerpt include="6,7,8"]
  • meta_key and meta_value – only include the pages that have this Custom Field Key and this Custom Field Value: [pagemagic_image_excerpt meta_key="metakey" meta_value="metaval"]
  • authors – only include the pages written by the given author(s) [pagemagic_image_excerpt authors="6,7,8"]
  • number – sets the number of pages to display: [pagemagic_image_excerpt number="10"]; by default the number is unlimited (number=โ€โ€)
  • offset – the number of pages to pass over (or displace) before collecting the set of pages: [pagemagic_image_excerpt offset="5"]; by default there is no offset (offset=โ€โ€)
  • post_type – list associated with a certain hierarchical Post Type [pagemagic_image_excerpt post_type="page"]; by default: (post_type=โ€pageโ€); possible values: page, revision, Hierarchical Custom Post Types (โ€˜postโ€™ is not a Hierarchical Post Type)
  • post_status – a comma-separated list of all post status types: [pagemagic_image_excerpt post_status="private"]; by default: (post_status=โ€publishโ€); possible values: publish, private, draft
  • class – the CSS class for list of pages: [pagemagic_image_excerpt class="listclass"]; by default the class is empty (class=โ€โ€)
  • strip_tags – strip tags or not: [pagemagic_image_excerpt strip_tags="0"]; by default the tags are stripped (strip_tags=โ€1″)
  • strip_shortcodes – strip registered shortcodes or not: [pagemagic_image_excerpt strip_shortcodes="0"]; by default shortcodes are stripped (strip_shortcodes=โ€1″) and all registered shortcodes are removed
  • show_child_count – show count of subpages: [pagemagic_image_excerpt show_child_count="1"]; by default the child_count is disabled (show_child_count=โ€0″); If show_child_count=โ€1″, but count of subpages=0, than child count is not shown
  • child_count_template – the template of child_count: [pagemagic_image_excerpt show_child_count="1" child_count_template="Subpages: %child_count%"]; by default child_count_template=โ€Subpages: %child_count%โ€
  • show_meta_key – show or hide meta key: [pagemagic_image_excerpt show_meta_key="your_meta_key"]; by default the show_meta_key is empty (show_meta_key=โ€โ€); If show_meta_key is enabled, but meta_value is empty, than meta_key is not shown
  • meta_template – the template of meta: [pagemagic_image_excerpt show_meta_key="your_meta_key" meta_template="Meta: %meta%"]; by default meta_template=โ€%meta%โ€
  • columns – for splitting list of pages into columns: [pagemagic_image_excerpt class="pagemagic-cols-2"]; available classes: pagemagic-cols-2, pagemagic-cols-3, pagemagic-cols-4, pagemagic-cols-5; works in all modern browsers and IE10+; columns are responsive and become 1 column at less than 768px

[More info] about parameters (https://developer.wordpress.org/reference/functions/get_pages/#parameters) for [pagemagic_image_excerpt].

Screenshots

  • Page Magic Custom Excerpt Meta Box
  • Page Magic [pagemagic_listall] Shortcode
  • Page Magic [pagemagic_listall] Preview
  • Page Magic [pagemagic_image_excerpt] Preview

Installation

  1. Install and activate the plugin on the Plugins page.
  2. Add shortcodes to pages: [pagemagic_listall], [pagemagic_subpages], [pagemagic_this_siblings], [pagemagic_image_excerpt]
  3. Use the Page Magic Custom Excerpt meta box in the page builder to set a custom excerpt.

FAQ

What’s the difference between [pagemagic_listall], [pagemagic_subpages] and [pagemagic_siblings]?

Shortcodes [pagemagic_listall], [pagemagic_subpages] and [pagemagic_siblings] accept the same parameters. The only difference is that [pagemagic_subpages] and [pagemagic_siblings] do not accept child_of parameter, because [pagemagic_subpages] shows subpages to the current page and [pagemagic_siblings] shows subpages to the parent page.

How do I create a sitemap.xml file?

To create a sitemap.xml file you can use XML-Sitemaps.com.

What do I do if I need to change the plugin’s code?

When you changed the plugin’s code you should also change the plugin’s version to โ€˜100โ€™ (for example) to avoid updates, which could override and delete your code.

Reviews

July 1, 2020
There are similar plugin, but I really like this one because it allows you to create a custom page excerpt instead of using whatever wordpress automatically pulls.
July 1, 2020
Works great, exactly what I was looking for to list all of my site’s pages
Read all 7 reviews

Contributors & Developers

“PageMagic – Page Lists” is open source software. The following people have contributed to this plugin.

Contributors

Changelog

1.0.0

  • Initial release