$pages->findOne() method

Like find() but returns only the first match as a Page object (not PageArray).

This is functionally similar to the get() method except that its default behavior is to filter for access control and hidden/unpublished/etc. states, in the same way that the find() method does. You can add an include=... to your selector string to bypass. This method also accepts an $options array, whereas get() does not.

Available since version 3.0.0.

Example

// Find the newest page using the blog-post template
$blogPost = $pages->findOne("template=blog-post, sort=-created");

Usage

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

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

Arguments

NameType(s)Description
selectorstring, array, Selectors

Selector string, array or Selectors object

options (optional)array, string

See $options for $pages->find()

Return value

Page NullPage

Returns a Page on success, or a NullPage (having id=0) on failure

See Also


$pages methods and properties

API reference based on ProcessWire core version 3.0.236

Latest news

  • ProcessWire Weekly #514
    In the 514th issue of ProcessWire Weekly we'll check out the latest blog post from Ryan, introduce two new third party modules — Page List Versions Counter and Fieldtype Fieldset Panel — and more. Read on!
    Weekly.pw / 16 March 2024
  • Invoices Site Profile
    The new invoices site profile is a free invoicing application developed in ProcessWire. It enables you to create invoices, record payments to them, email invoices to clients, print invoices, and more. This post covers all the details.
    Blog / 15 March 2024
  • Subscribe to weekly ProcessWire news

“I am currently managing a ProcessWire site with 2 million+ pages. It’s admirably fast, and much, much faster than any other CMS we tested.” —Nickie, Web developer