$page->isChanged() method

Has the Page changed since it was loaded?

To check if only a specific property on the page has changed, specify the property/field name as the first argument. This method assumes that change tracking is enabled for the Page (as it is by default). Pages that are new (i.e. don't yet exist in the database) always return true.

Examples

// Check if page has any changes
if($page->isChanged()) {
  // There are changes to this page
  $changes = $page->getChanges();
}
// When page is about to be saved, update summary when body has changed
$this->addHookBefore('Pages::saveReady', function($event) {
  $page = $event->arguments('page');
  if($page->isChanged('body')) {
    // get first 300 chars from body
    $summary = substr($page->body, 0, 300);
    // truncate to position of last period
    $period = strrpos($summary, '.');
    if($period) $summary = substr($summary, 0, $period);
    // populate to the page, so that summary is also saved
    $page->summary = $summary;
  }
});

Usage

// basic usage
$bool = $page->isChanged();

// usage with all arguments
$bool = $page->isChanged(string $what = '');

Arguments

NameType(s)Description
what (optional)string

If specified, only checks the given property for changes rather than the whole page.

Return value

bool

True if property has changed, false if not.

See Also


$page methods and properties

API reference based on ProcessWire core version 3.0.137

Twitter updates

  • ProcessWire 3.0.144 and 3.0.145 add improved field template context override settings and include a new Inputfields API, along with numerous other issue fixes, optimizations and improvements to the core. More
    8 November 2019
  • ProcessWire 3.0.144 core updates: Upgraded overrides section in the field editor, a new Inputfields JS API, and more— More
    1 November 2019
  • ProcessWire 3.0.143 core updates — 26 commits and 18 resolved issue reports, plus some other useful improvements and additions. More here: More
    25 October 2019

Latest news

  • ProcessWire Weekly #288
    In the 288th issue of ProcessWire Weekly we'll cover the latest core updates, introduce WireMailSendGrid, host a new weekly poll, and showcase a new site of the week. Read on!
    Weekly.pw / 16 November 2019
  • ProcessWire 3.0.145 core updates
    ProcessWire 3.0.144 and 3.0.145 add improved field template context override settings and include a new Inputfields API, along with numerous other issue fixes, optimizations and improvements to the core.
    Blog / 8 November 2019
  • Subscribe to weekly ProcessWire news

“The end client and designer love the ease at which they can update the website. Training beyond how to log in wasn’t even necessary since ProcessWire’s default interface is straightforward.” —Jonathan Lahijani