$pages->get() method

Returns the first page matching the given selector with no exclusions

Use this method when you need to retrieve a specific page without exclusions for access control or page status.

Example

// Get a page by ID
$p = $pages->get(1234);

// Get a page by path
$p = $pages->get('/about/contact/');

// Get a random 'skyscraper' page by selector string
$p = $pages->get('template=skyscraper, sort=random'); 

Usage

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

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

Arguments

NameType(s)Description
selectorstring, array, Selectors, int

Selector string, array or Selectors object. May also be page path or ID.

options (optional)array

See Pages::find() for extra options that may be specified.

Return value

Page NullPage

Always returns a Page object, but will return NullPage (with id=0) when no match found.

See Also


$pages methods and properties

API reference based on ProcessWire core version 3.0.160

Twitter updates

  • ProcessWire 3.0.160 adds powerful new text-searching operators, bringing a new level of power to page-finding API calls, especially when it comes to search engine type queries. Post also includes a demo search engine where you can test it all out live— More
    19 June 2020
  • Preview of ProcessWire 3.0.160 with auto-enable of two-factor authentication, new version of TfaEmail and TfaTotp, and new selector operators coming next week. More
    12 June 2020
  • New post: ProcessWire 3.0.159 brings some useful and time-saving upgrades to the core two-factor authentication system— More
    5 June 2020

Latest news

  • ProcessWire Weekly #319
    In the 319th issue of ProcessWire Weekly we're going to check out the latest core updates, introduce a couple of new third party modules, and highlight the downright stunning new website of Studio Pixelgold. Read on!
    Weekly.pw / 21 June 2020
  • Powerful new text-searching abilities in 3.0.160
    In ProcessWire 3.0.160 we’ve got some major upgrades and additions to our text-search abilities. This brings a whole new level of power to $pages->find() and similar API calls, especially when it comes to search engine type queries.
    Blog / 19 June 2020
  • Subscribe to weekly ProcessWire news

“To Drupal, or to ProcessWire? The million dollar choice. We decided to make an early switch to PW. And in retrospect, ProcessWire was probably the best decision we made. Thanks are due to ProcessWire and the amazing system and set of modules that are in place.” —Unni Krishnan, Founder of PigtailPundits