官术网_书友最值得收藏!

  • concrete5 Cookbook
  • David Strack
  • 368字
  • 2021-08-13 16:15:59

Moving a page

The concrete5 sitemap is a great tool for managing the page hierarchy of your website. It lets you arrange the order of pages, and even drag-and-drop pages to different areas of the site. Thankfully, you aren't limited to using the graphical interface to move pages around the site. You can also rearrange pages dynamically in your custom concrete5 applications.

Getting ready

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.

How to do it...

The steps for moving a page are as follows:

  1. Open /config/site_post.php, as that is a safe place to play with some random code.
  2. First, load the About Us page, which is where the Careers page will be moved to.
    $newParent = Page::getByPath('/about');
  3. Now, we need to load the careers page that we are moving.
    $careersPage = Page::getByPath('/careers');
  4. Finally, call the move function on the careers page, passing it the new parent page and an optional Boolean which tells concrete5 if we want to save the old page path as well as the new one.
    $careersPage->move($newParent, true);

How it works...

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.

See also

  • Listening to system events in Chapter 9, System Events and Advanced Configuration
  • The Getting a Page object by its path recipe
主站蜘蛛池模板: 荔波县| 巨鹿县| 青冈县| 金山区| 泰安市| 资源县| 共和县| 磐石市| 大宁县| 县级市| 临泉县| 香格里拉县| 祁阳县| 马边| 新干县| 普兰县| 南澳县| 孝义市| 中阳县| 金寨县| 沙田区| 沁水县| 海宁市| 建始县| 富顺县| 兴海县| 聂荣县| 柳江县| 清新县| 怀集县| 崇义县| 彭泽县| 宁国市| 九台市| 响水县| 惠水县| 定安县| 巴东县| 葵青区| 象州县| 余江县|