$page->numChildren() method

Return number of all children, optionally with conditions

Use this over the $page->numChildren property when you want to specify a selector, or when you want the result to include only visible children. See the options for the $selector argument.

When you want to retrieve all children with no exclusions or conditions, use the $page->numChildren property instead.

Example

// Find how many children were modified in the last week
$qty = $page->numChildren("modified>='-1 WEEK'");

Usage

// basic usage
$int = $page->numChildren();

// usage with all arguments
$int = $page->numChildren($selector = null);

Arguments

NameType(s)Description
selector (optional)bool, string, array
  • When not specified, result includes all children without conditions, same as $page->numChildren property.
  • When a string or array, a selector is assumed and quantity will be counted based on selector.
  • When boolean true, number includes only visible children (excludes unpublished, hidden, no-access, etc.)
  • When boolean false, number includes all children without conditions, including unpublished, hidden, no-access, etc.

Return value

int

Number of children

See Also


$page methods and properties

API reference based on ProcessWire core version 3.0.148

Twitter updates

  • ProcessWire 3.0.153 (dev) focuses on comments field updates, significant refactoring/improvements to ProcessWire’s core Template class and PagesLoader class (which is used by the pages API variable), and we introduce a useful new pages API method— More
    20 March 2020
  • ProcessWire 3.0.152 core updates— This week we have some major improvements to our core date/time Inputfield, as well as a new ability to specify your own custom classes for Page objects— More
    6 March 2020
  • This week we’ve got a couple of really useful API-side improvements to the core in 3.0.151, including predefined image settings and static language translation improvements— More
    21 February 2020

Latest news

  • ProcessWire Weekly #306
    In the 306th issue of ProcessWire Weekly we'll check out ProcessWire 3.0.153, introduce a new third party module called Image Crop Ratios, highlight some recent module updates, and more. Read on!
    Weekly.pw / 21 March 2020
  • ProcessWire 3.0.153 core updates
    This latest version of the core on the dev branch focuses on comments field updates, significant refactoring/improvements to ProcessWire’s core Template class and PagesLoader class (which is used by the $pages API variable), and we introduce a useful new $pages API method.
    Blog / 20 March 2020
  • Subscribe to weekly ProcessWire news

“…building with ProcessWire was a breeze, I really love all the flexibility the system provides. I can’t imagine using any other CMS in the future.” —Thomas Aull