$fields->getNumPages() method

Return a count of pages containing populated values for the given field

Usage

// basic usage
$int = $fields->getNumPages(Field $field);

// usage with all arguments
$int = $fields->getNumPages(Field $field, array $options = []);

Arguments

NameType(s)Description
fieldField
options (optional)array

Optionally specify one of the following options:

  • template (template|int|string): Specify a Template object, ID or name to isolate returned rows specific to pages using that template.
  • page (Page|int|string): Specify a Page object, ID or path to isolate returned rows specific to that page.
  • getPageIDs (bool): Specify boolean true to make it return an array of matching Page IDs rather than a count.

Return value

int array

Returns array only if getPageIDs option set, otherwise returns count of pages.

Exceptions

Method can throw exceptions on error:

  • WireException - If given option for page or template doesn't resolve to actual page/template.


$fields methods and properties

API reference based on ProcessWire core version 3.0.244

Latest news

  • ProcessWire 3.0.244 new main/master version
    ProcessWire 3.0.244 is our newest main/master/stable version. It's been more than a year in the making and is packed with tons of new features, issue fixes, optimizations and more. This post covers all the details.
    Blog / 18 January 2025
  • Subscribe to weekly ProcessWire news

“ProcessWire is like a breath of fresh air. So powerful yet simple to build with and customise, and web editors love it too.” —Margaret Chatwin, Web developer