mher list Subpages
mher list Subpages

mher list Subpages

Michael H.E. Roth

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.

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.

1.0.1

Minor Bugfix

1.0.0

  • Initial release

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

Reviews

0 out of 5 stars

  • Version: 1.0.1
  • Last updated: 1 month ago
  • Active installations: 0
  • WordPress version: 6.5
  • Tested up to: 6.6.2
  • PHP version: 8.0