$page->findOne() method

Find one descendant page matching given selector

This is the same as Pages::findOne() except that the match is always a descendant of page it is called on.

Available since version 3.0.116.

Example

// Find the most recently modified descendant page
$item = $page->findOne("sort=-modified");

Usage

// basic usage
$page = $page->findOne();

// usage with all arguments
$page = $page->findOne($selector = '', array $options = []);

Arguments

NameType(s)Description
selector (optional)string, array

Selector string or array

options (optional)array

Optional options to modify default bheavior, see options for Pages::find().

Return value

Page NullPage

Returns Page when found, or NullPage when nothing found.

See Also


$page methods and properties

API reference based on ProcessWire core version 3.0.130

Twitter updates

  • New post: Quietly and without interruption this week, the ProcessWire.com website (and all subdomains) moved from a single static server to a load-balanced multi-server environment, giving us even more horsepower and redundancy than before— More
    19 April 2019
  • New post: With ProcessWire 3.0.130, this week we’ll take a detailed look at a few useful new API additions made in the last few weeks, along with examples of each—More
    12 April 2019
  • New post: This week ProcessWire ProMailer has been released, plus we’ve got a nice upgrade in our community support forum, and more— More
    15 March 2019

Latest news

  • ProcessWire Weekly #258
    In the 258th issue of ProcessWire Weekly we'll cover a hosting upgrade for the processwire.com site and it's subdomains, introduce PW Review and Terminal module, and feature the new site of O'Neil Cinema. Read on!
    Weekly.pw / 20 April 2019
  • ProcessWire.com website hosting upgrades
    Quietly and without interruption this week, our whole website moved from a single static server to a load-balanced multi-server environment, giving us even more horsepower and redundancy than before.
    Blog / 19 April 2019
  • Subscribe to weekly ProcessWire news

“Indeed, if ProcessWire can be considered as a CMS in its own right, it also offers all the advantages of a CMF (Content Management Framework). Unlike other solutions, the programmer is not forced to follow the proposed model and can integrate his/her ways of doing things.” —Guy Verville, Spiria Digital Inc.