mher list Subpages

Description

Lists the subpages of the current page with multiple options, including defining your own templates for the listings

Configurable Settings

  • Default Fallback image in case the subpage does not have a featured image and on shortcode level no fallback image has been set
  • Custom html-templates for listing the subpages
    • accessable via number or name
    • placeholders to use in the templates
      • {{ url }} – url of the subpage
      • {{ title }} – title of the subpage
      • {{ img }} – html-code for the featured image of the subpage
      • {{ img_url }} – just the url of the featured image of the subpage
      • {{ blocks }} – the via name selected blocks of the subpage
    • For security reasons no javascript is allowed in the user defined templates and will be silently removed after rendering.

Shortcode Options

  • template= – either the number or the name of the custom template
  • blocks_named= – fetches and renders all blocks of the corresponding subpage and replaces {{ blocks }} in the selected template – default for blocks_named: teaser – to make sure no blocks are used, use the dash, like: blocks=-
  • image_id= – id of an image in the media library to be used as a fallback image in case a subpage does not have a featured image
  • image_size= – any registered image size possible – default: thumbnail
  • list= – a comma-separated list of page-ids that should be listed INSTEAD of the subpages of the current page (combinable with include= and exclude= even though this does not make much sense)
  • exclude= – a comma-separated list of page-ids that should NOT be listed
  • prepend= – a comma-separated list of page-ids that should be listed before the subpages (combinable with exclude= and append= and even list=, although this makes little sense)
  • append= – a comma-separated list of page-ids that should be listed after the subpages (combinable with exclude= and prepend= and even list=, although this makes little sense)

Subpages, that do not have blocks, i.e. “classic” pages, and subpages that do not have blocks with the given name, will be shown without content.

Screenshots

  • The Options Configuration Page
  • The Default Output in the Frontend

Installation

Starting with mher list Subpages is very simple and if you’ve ever installed a plugin you know the drill:

Install mher list Subpages from within WordPress

  1. Visit the plugins page within your dashboard and select ‘Add New’
  2. Seach for ‘mher list Subpages’
  3. Select install
  4. Continue with ‘After Installation’ below

Install mher list Subpages manually

  1. Upload the ‘mher-list-subpages’ folder to the /wp-content/plugins/ directory
  2. Continue with ‘After Installation’ below

After Installation

  1. Activate mher list Subpages from your Plugins page
  2. Use the shortcode [mher_subpages] in your pages (with subpages)
  3. Visit the Configuration Page to set up options

FAQ

How can I avoid that any blocks are shown?

There are actually two ways to accomplish this: a) explicitly set blocks_named=- b) create your own template and don’t use the {{ blocks }} placeholder

Why does the sequence not reflect the sequence of the pages in my menu?

You have to change the sequence of the pages within their parent page to match the sequence of your menu.

How can I change the sequence?

Currently only by changing the sequence of the pages within their parent page.

Reviews

There are no reviews for this plugin.

Contributors & Developers

“mher list Subpages” is open source software. The following people have contributed to this plugin.

Contributors

“mher list Subpages” has been translated into 1 locale. Thank you to the translators for their contributions.

Translate “mher list Subpages” into your language.

Interested in development?

Browse the code, check out the SVN repository, or subscribe to the development log by RSS.

Changelog

1.0.1

Minor Bugfix

1.0.0

  • Initial release