This plugin lets you turn WordPress into a proper easily navigable CMS. Having a site made up mostly of pages in the form of a tree (an information site for example) was always a pain until I wrote this to help me out. I have had lots of feedback about it over the last few months and more and more people are finding ways they can use it to improve the navigation and usability of their sites
I wanted to show some sort of hierarchy in the pages inside WordPress. I decided to call one of my pages “articles” and have my articles use it as their parent.
Logically you would expect to see a list of the child pages on the articles page along with a pretty picture and some intro text. This doesn’t seem possible natively with WordPress so I decided to make it happen.
Adding the hook [sb_child_list] to any post or page will by default show an unordered list showing the children and links to them. If you prefer to style it yourself then don’t worry because you can do that too using the templating system on the settings page.
There is also add another tag, [sb_parent], that allows you to provide a back to parent link from any child. This enables you (in the articles example) to add a “click here to read more on this subject” link. It is also template based so it can say anything or look however you see fit
You can also use this shortcode: [sb_cat_list category=CatName] which does what it says on the tin, simply give it a category name and it will show the posts in that category for you with optional ‘limit’ argument
The plugin creates a widget for use also. This works if there is a sub page present. Much like a sub pages widget or similar.
I have added a shortcode for sibling navigation. You can use [sb_sibling_next] and [sb_sibling_prev] to show links to next and previous pages ordered by menu order followed by post title order. Handy indeed! You can use the argument orderby to select a field and order to choose ASC or DESC.
There is a simple templating system to allow multiple templates for [sb_child_list] and [sb_cat_list] with the argument ‘template’ ([sb_child_list template=”2″]). Also added excerpt support and support for the SB Uploader Plugin custom fields (custom field called post_image will show if necessary).
To round it all up.. Shortcode listings:
[sb_child_list] <– Arguments allowed are: ‘template’, ‘nest_level’, ‘orderby’ and ‘order’ (order and orderby allow the arguments specified in this list: https://codex.wordpress.org/Class_Reference/WP_Query#Order_.26_Orderby_Parameters)
This section describes how to install the plugin and get it working.
- Activate the plugin through the ‘Plugins’ menu in WordPress
[sb_child_list] in a parent page and optionally [sb_parent] to any child pages. Now with [sb_cat_list] for category items
- In the settings menu under
SB Child List, you will find lots of lovely config options
Contributors and Developers
“SB Child List” is open source software. The following people have contributed to this plugin.Contributors
0.1: Basic functionality.
0.5: Admin Page added.
0.9: Templating and nest limiting.
1.0: Added backlink from child to parent.
1.1: Added sb_cl_cat_list functionality
1.2: Now using get_permalink for the child list. Means the guid field is no longer relied on and links always work
1.3: Added post_thumb to the templating system. Uses the WP Post Thumbnail system. Contributed by a plugin user.
1.4: Fixed post_thumb option whereby the function didn’t exist on some installs. Uses the get_the_post_thumb function to operate
1.5: Updated sb_parent permalink from guid to get_permalink
1.6: Added templating for the shortcodes (multiple instances of the shortcode in different formats now possible) and support for the_excerpt and SB Uploader output (custom fields called post_image and post_image2 will be recognised)
1.7: Forced page excerpt support in case it wasn’t already added. Added tooltip for post_excerpt
1.8: Added ability to sort a child list by any field in the wp_posts table by adding order=”field_name” to the shortcode
1.9: Added child list widget to show sub pages of current page or any other page of your choice.
2.0: Fixed widget title issue whereby the title was being changed to 1,2,3 depending on the template used.
2.1: Child list and widget now shows ancestors if there are no children. Added parent link option to widget
2.2: Fixed issue with siblings showing in normal child list and then repeating themselves breaking the site.
2.3: Added two new shortcodes sb_sibling_next and sb_sibling_prev. Kind of like next and previous navigation for posts. Uses menu order for display followed by alphabetical post titles.
2.4: Added sb_grandparent so that you can feature one more level of parentage as a link back. Added getText format on “Back to” text for localisation.
2.5: When [post_class] is used and the item relates to the current page then a classname will be added: ‘current_page_item sb_cl_current_page’ to allow you to style individual rows using CSS making the current page stand out perhaps.
2.6: Added custom excerpt function so that when using [post_excerpt] in the template if you don’t enter a manual one it will generate it from the post body as WordPress does normally.
2.7: Minor update, added support for qTranslate
2.8: Minor update, added support for excerpt more tag if used.
2.9: Minor Update, added order parameter to sb_cat_list shortcode. Default ordering to post title.
3.0: Minor update. Added ability to fix the parent ID of a child using parent_id=”” in sb_child_list shortcode
3.1: Minor update. Added template settings shortcode [post_thumb_url] and removed the default link to large image around [post_thumb]. Allows you to set up your own link around the thumb to go wherever you like.. be it larger image or the post itself
3.2: Bug Fix update. [post_image] didn’t work from my 3.1 update because of the logic using the incorrect post ID. Sorted now.
3.3: Minor update. Added new option to turn off the siblings list on the lowest level. This means that when you get to the bottom of the page tree the child list will disappear if this option is utilised
3.4: Minor update. Fix to the child list widget templating system. It wasn’t working for anything but template 1. Now rectified.
3.5: Minor update. Added ability to order the child list using both order and sort options. orderby allows you to order on a specific field and order is ASC or DESC
3.6: Minor update. Added the ability to add thumb_size=”whatever” to the shortcode which will cause the post_thumb template tag to return the size you wanted rather than the thumbnail size for the site
3.7: Minor update. Fixed Array to string conversion error when using [post_thumb_url] in the template system.
3.8: Minor update. Added custom fields [custom_field:field_slug] where field_slug is the meta_key of your custom field
3.9: Minor update. Added ability for sb_child_list shortcode to now accept a category. This means you can show child pages in sub groups accordingly using [sb_child_list category=”cat_name”]. Also removed SQL query for child list in favour of query_posts function.
4.0: Minor update. Fixed a variable bug in the custom fields system which cropped up in 3.9
4.1: Minor update. Another typo causing some people’s systems to show incorrect child content. This has been resolved with the people who have been in touch but please let me know if it needs more work. Also added ‘limit’ argument to the sb_child_list shortcode. It defaults to -1 (all posts)
4.2: Minor update. Fixed a bug whereby an empty list would show (including triggering the widget not to hide) even if there are no child posts.
4.3: Major update. Fixed a default argument issue for anyone not declaring their own orders within the shortcodes. Would cause the query to fail and list to likely to be empty.
4.4: Minor Update. Replaced mysql_real_escape_string for esc_sql to work around errors in newer versions of PHP
4.5: Minor Update. Changed old style constructor in the widget code and updated to modern Widgets API