$pages->has() method

Is there any page that matches the given $selector in the system? (with no exclusions)

  • This can be used as an “exists” type of method.
  • Returns ID of first matching page if any exist, or 0 if none exist (returns array if $verbose is true).
  • Like with the get() method, no pages are excluded, so an include=all is not necessary in selector.
  • If you need to quickly check if something exists, this method is preferable to using a count() or get().

When $verbose option is used, an array is returned instead. Verbose return array includes page id, parent_id and templates_id indexes.

Available since version 3.0.153.

Usage

// basic usage
$array = $pages->has($selector);

// usage with all arguments
$array = $pages->has($selector, bool $verbose = false);

Arguments

NameType(s)Description
selectorstring, int, array, Selectors
verbose (optional)bool

Return verbose array with page id, parent_id, templates_id rather than just page id? (default=false)

Return value

array int

See Also


$pages methods and properties

API reference based on ProcessWire core version 3.0.178

Twitter updates

  • Today a new version of FormBuilder has been released in the FormBuilder support board (our 50th version) and it has a lot of interesting new features, which we’ll take a closer look at in this post— More
    11 June 2021
  • ProcessWire 3.0.179 adds great new admin theme customization tools that put you in full control over the Uikit admin styles— More
    28 May 2021
  • ProcessWire updates for week of 21 May 2021— More
    22 May 2021

Latest news

  • ProcessWire Weekly #369
    In the 369th issue of ProcessWire Weekly we're going to check out the latest core updates, showcase some recent forum highlights and tutorials, and more. Read on!
    Weekly.pw / 5 June 2021
  • ProcessWire FormBuilder v50 updates
    Today a new version of FormBuilder has been released in the FormBuilder support board (our 50th version) and it has a lot of interesting new features, which we'll take a closer look at in this post.
    Blog / 11 June 2021
  • 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