Plugin URI: http://shinraholdings.com/plugins/count-children
Donate link: http://shinraholdings.com/donate
Tags: plugin, template, tag, count, page, pages, children, counter, number, return, shortcode
Requires at least: 2.8
Tested up to: 3.5
Stable tag: 1.0.0
Adds a custom shortcode that returns the number of children for a given page. Accepts page ID, name, or slug as input.
This plugin allows you to dynamically return the number of children for a particular page. Inserting
[children page="page-slug"] in a post or page, or
<?php do_shortcode('children page="page-slug" '); ?> anywhere in WordPress' code will return the number of children for that particular page.
Useful for creating dynamic table of contents pages, keeping track of page stats, general bragging, or any place where keeping a running tally might be desirable.
- Download the latest zip file and extract the
- Upload this directory inside your
- Activate 'Count Children' on the 'Plugins' menu in WordPress.
[children page="page-slug"]in a post or page (replacing page-slug with an acutal slug name) to return the number of child pages under that page.
Frequently Asked Questions
How do I add it into my posts?
You must insert the shortcode in location where you want to count to appear: (always replacing page-slug with an acutal slug name)
The shortcode assumes you are giving it slugs, but it can also accept page names or IDs:
[children type="name" page="Parent Page Name"]
[children type="id" page="28"]
It keeps returning 0 pages, why?
Make sure you're using the correct page slug, sometimes they are different from the actual page name and capitalization matters. You can view them by clicking on the All Pages link under Pages.
Also don't literally copy "page-slug," you need to put the parent page you want counted there, that's just a place holder. So to count the number of children in a page called 'Book Reviews' with a slug name of 'book-reviews' you would insert
Are there other shortcodes?
[children] is the primary one, but there is also [countchildren], [childcount], and [pagechildren].
Can I change the shortcode?
Yes, just open
count-children.php and add or change what text you want to trigger the shortcode in the array near the bottom.
Can you add this feature I just thought of?
Can I? Yes. Will I? Yes, if I think it would be a helpful addition. I'm trying to keep things clean and simple, but there's always room for improvement, so let me know if you think a feature is lacking!
- First released version.
- There may still be bugs, but I can't find any.
First release, no upgrade notice (included to make the WordPress readme.txt validator happy).
- This plugin's readme.txt file was generated by the bitacre Readme Generator for WordPress Plugins.
Donations are graciously accepted to support the continued development and maintenance of this and other plugins. We currently accept Paypal and kind words.