Updating pages is similar to creating them in that you must first pass in an associative array containing all of the data that you wish to update on the page.
In this recipe, we will be modifying a page with the path of /about. We created that page in the previous recipe, but if it does not exist on your system, please adapt the code to your needs.
In this example, we will update the name of the About page. The steps are as follows:
First, we need to load the
Pageobject by its path.$page = Page::getByPath('/about');Create an associative array with the data that you wish to update.
$data = array( 'cName' => 'About Our Company' );
Pass the data array into the
$pageobject's update function.$page->update($data);
Output a success message and exit the process.
echo 'done!'; exit;
The update function updates the necessary tables in the database with the newly specified information. concrete5 will also rescan all permissions for this page and all of the related page paths. When the function is complete, the on_page_update event is fired, which you can write custom code to listen to and perform custom actions when a page is updated. Listening to system events is covered in a later chapter.
Just like creating a page, you will need to pass an associative array to the update() function in order to update an existing page. You can use all of the fields specified in the previous recipe for adding a page, in addition to these other optional fields.