Configuring a page

Overview

To configure a page, click on the Configure button in the editor's toolbar.

This takes you to the following form.

The form is made of four parts:

• The title field
• The Page section
• The optional type-specific section, not present in the example but present for many page types.
• The Script section

Click on "Update configuration" to save the changes.

The title field

Edit this field to change the page title.

The Page section 

This section contains the following fields:

• Id (read-only): the unique random id assigned by Portofino when the page is created
• Navigation root: does this page inherit the parent's root or is it a new root for its children? See the discussion below.
• Description: the page description
• Template: which template applies to this page. Read more on page templates.
• Apply template recursively: check this flag if you want this page's template to be applied to all child pages recursively.

The "navigation root" field supports three values: "inherit", "root", and "ghost root". This allows you mark a page as a logical root, even if it is not a real root page in the hierarchy. A logical root is a page that behaves, as far as breadcrumbs and navigation are concerned, as a root for its children.

"Inherit" is the regular value that you will need most of the time. The page will not be a new root and will simply appear under its parent in breadcrumbs and navigation.

"Root" will make the page behave as a logical root for all its children. This is useful when you want to create a sub-site that is independent from other parts of the site.  For example a page called "Documentation" could be the logical root for its children, even if "Documentation" is deeply nested in the page hierarchy.

"Ghost root" is similar to "root" except the page will not appear in breadcrumbs and navigation when visiting its children. This is useful, e.g., in a multilingual site if you create a root for each language you support ("English", "French", etc) and you don't want the language to appear as the first element in the breadcrumbs and navigation. 

The type-specific section

Depending on the page type you've chosen, the configuration page will contain type-specific settings. For more information see:

• CRUD configuration
• Chart configuration
• Text configuration
• Calendar configuration
• Many-to-many configuration
• Change Password configuration
• Custom page configuration

The Script section

This section shows the Groovy script associated with the current page. The script is editable on-line and the changes will be applied immediately after you save the configuration. This section is for experienced users who want to customize or extend the behavior of the pages.