Inheriting portal engine page content

Inheritance allows you to maintain a consistent design throughout the website and manage content shared by multiple pages in a single location. Portal engine pages can use two different types of content inheritance:

  • Page nesting inside ancestor documents
  • Inheriting the entire page template from the parent document (shared templates)

Using page nesting

Nested pages display their own content inside other pages. You can nest pages within ancestor documents in the content tree.

What are ancestor documents?

Ancestors include all documents under which a given document is stored, from the root of the site’s content tree down to the document’s direct parent.

For example, the /Company/Offices/London Office document has the following ancestors:

  • Website root document
  • /Company
  • /Company/Offices

Nesting allows you to organize your website’s content tree in the following way:

  • Pages that provide shared content on the upper levels
  • Individual content pages stored as subpages

Creating pages that support nesting

Note: The following steps are required for all documents serving as master pages, but you can also set up nesting for any other pages.

To allow subpages to nest within a page:

  1. Open the Pages application.
  2. Select the page in the content tree.
  3. Open the Design tab.
  4. Add the Page placeholder web part.

The page placeholder specifies the position of nested pages within the content. When displaying the nested pages, the system loads everything around the page placeholder as fixed content.

Page placeholder web part located on a website’s master page template

Setting default content for page placeholders

By default, the placeholder does not display anything on the page where it is placed. You can configure the placeholder to show one of the website’s re-usable page templates as default content:

  1. Configure the page placeholder web part (double-click).
  2. Select a template in the Default page template property.
  3. Click OK.

The page displays the selected template inside the area occupied by the page placeholder. Nested pages ignore the placeholder’s default template and display their own content instead.

The Use template on all subpages and Document to display properties force the placeholder to always display the default template or a specific document. Such placeholders cannot be used for standard page nesting — all nested subpages display the specified content instead of their own.

Configuring pages to nest within ancestors

Tip: You can use page nesting on any number of levels. Nested pages can also contain their own page placeholders for displaying subpages.

  1. Open the Pages application.

  2. Select the subpage document in the content tree.

  3. Open the Properties -> Template tab.

  4. Choose one of the following Page nesting options for the document:

    Page nesting type

    Description

    Use page template settings

    The page nesting settings are determined by the configuration of the document’s page template. This option allows you to manage the settings for documents with shared templates.

    To modify the page template’s nesting settings:

    1. Click Edit template properties.
    2. Set the Page nesting options on the General tab.
    3. Click Save.

    None

    The document behaves as a standalone page without any nesting.

    Only the nearest master page

    The document nests only within the website’s master page. If your website uses multiple master pages, the document nests within the closest master page in the content tree hierarchy.

    Specific ancestor pages

    Allows you to enable or disable nesting within any ancestor pages (regardless of the master page structure). Specific pages are represented by the checkboxes below.

    Configuring page nesting on the document level

  5. Click Save.

When visitors view the nested page, the system loads the content of the selected ancestors and displays it around the content of the page itself (according to the positions of the page placeholder web parts).

On the Design tab of nested documents, the editable template section appears inside the content of ancestor pages (in the position of the page placeholder on the previous nesting level). You can edit the  page layout and web parts of the nested page’s template as usual. You cannot modify the content from the ancestors where the page is nested.

Editing a nested page on the Design tab

Important

You can only edit the page template on the Design tab if all documents where the given page is nested contain a Page placeholder.

If you configure a subpage to “nest” inside a page without a page placeholder, the subpage only displays the content of the given ancestor and cannot be modified in any way.

Inheriting page header content for nested pages

You can add custom <head> content to pages, such as links to external CSS or JavaScript files.

  1. In the Pages application, open the document’s Properties -> Template tab.
  2. Click Edit template properties.
  3. Switch to the Header tab.
  4. Type in the required content.
  5. Click Save.

The system inserts the content into the <head> element in the output code of all pages that use the given template.

Nested pages can inherit the header content from their ancestors. The inheritance depends on the following options, which you can enable or disable on the Header tab of each page template:

  • Allow descendant templates to inherit the header
  • Inherit headers from the templates of ancestor documents

The header inheritance follows the page nesting settings — pages can only inherit head content from the ancestor pages where they are nested. Pages that do not use nesting cannot inherit head content.

Inheriting the page template of the parent document

One way to display content from parent documents is to inherit the entire page template. Documents with an inherited template are mostly identical to the parent, but you can modify them in the following ways:

  • Set different content inside the document’s editable web parts (Editable text and Editable image)
  • Use web parts that display different content based on the document’s type and location in the content tree (path)
  • Hide web parts on subpages
  • Add web parts that appear only on particular document types

A typical scenario where you can use page template inheritance is a page document with multiple non-page child documents. By inheriting the template, users can create the child documents without worrying about the page design. You can use one of the document viewer web parts to dynamically display a list of child documents on the parent page and detailed information when viewing specific child documents.

You can create new pages with an inherited template by choosing the Use parent page template option in the template selection dialog. Non-page document types automatically inherit the template of the parent page by default.

To configure an existing document to inherit the parent document’s template:

  1. In the Pages application, select the document content tree.
  2. Open the Properties -> Template tab.
  3. Select Inherit from parent in the Template section.
  4. Click Save.

The child document uses the same page template as the parent. Any changes that you make to the page template’s layout or web part configuration affect both the parent page and all documents that inherit the template.

Tip: The page template inheritance can continue throughout the content tree — documents may inherit from parent documents that already use an inherited template (Parent -> Child -> Descendants…).

Hiding web parts on subpages

You can disable content inheritance for individual instances of web parts. This allows you to add web parts to pages without affecting the design of subpages that inherit content. Applies to both types of content inheritance — page nesting and documents with inherited templates.

  1. In the Pages application, open the Design tab of the document containing the web part.
  2. Configure the web part (double-click).
  3. Expand the Visibility property category.
  4. Check Hide on subpages.
  5. Click OK.

Users now cannot see the web part on sub-documents in the content tree.

Example

You can find an example on the News page on the sample Corporate site. The page hides the Header text, Description text, News filter and Universal pager web parts on child pages. As a result, the text sections are only visible on the list of news items — not on the detail pages of individual news items, which inherit the page template from the parent News document.

Making web parts visible only for specific document types

You can configure web part instances to appear only on specific types of documents. This allows you to set up different content inheritance for different document types (applies to both page nesting and documents with inherited templates). You can also use this features for documents that simply share page templates, without any kind of inheritance.

  1. In the Pages application, open the Design tab of the document containing the web part.
  2. Configure the web part (double-click).
  3. Expand the Visibility property category.
  4. Click Select next to the Show for document types property.
  5. Choose the allowed document types.
  6. Click OK in both dialogs.

The web part is now only visible when viewing documents of the selected types.

Example

You can find an example on the /Community/Blogs/Andrew-Jones-Blog page on the sample Corporate site. The page displays the Header text, Description text and Blogs filter web parts only on CMS.Blog and CMS.BlogMonth documents. The web parts are hidden when viewing individual CMS.BlogPost documents, which inherit the template.

Sample inheritance scenario

The following example shows how the system processes a request for a nested product page: /Products/Notebooks/Dell-XPS-15z

This sample scenario demonstrates content inheritance through both page nesting (Page placeholder web parts) and page template sharing. The portal engine loads the templates in the following order:

1. / (root)

Website master template

2. /Products

Products page template

3. /Products/Notebooks

Laptops page template

4. /Products/Notebooks/Dell-XPS-15z

Laptops page template - inherits the page template from the parent page.

Note

The document viewer web part (e.g. Repeater) automatically displays the detail of the selected product instead of the product list.

See Loading and displaying data on websites for more information.