In this example, we are going to move a Careers page underneath the About Us page. Before we can move a page, we need to have the Page object of the new parent page that we are moving the current page to.

This exercise assumes that pages exist at both /about and /careers in your concrete5 site. You can create those pages through the concrete5 interface, or adapt the code in this recipe to work with pages that exist on your own site.

The steps for moving a page are as follows:

The move function is very easy to use. You only need to provide one parameter, which is a Page object of the new parent that you are moving the page under. There is an optional second parameter to indicate if you wish to retain the old page path in addition to the current one. That parameter defaults to false.

Once the page is moved, it will inherit the permissions of the new parent page (if the page does not have its own permissions set explicitly).

Once the page is moved, the event on_page_move is fired.