Page Template

December 21, 2021

Understanding Templates

A template is created in Jahia Studio to enable editors to use a view for rendering jnt:template.

 

templates-diagram.png

 

Templates define:

  • Content positioning and design
  • Template-specific content
  • Content contribution areas

Changes made to templates in the Jahia Studio are immediately applied to the website and do not need to be published.

Content items can also be directly added to templates. This makes the content part of the template and cannot be changed in edit mode. Typical examples of content for this use case are page headers and footers.

Templates can only be created in Jahia using the development platform as Jahia Studio is not available on production environments.

What is a Page Template?

A Page Template allows editors to:

  • Create a page
  • Populate this page with content

Content positioning is accomplished with Content Areas in the Template Area.

While the template for a View is created using JSP, a page template is created directly in the Jahia Studio.

page-template.png

Creating a new Page Template

Under the template tab, right click the base of the template set and click "New page template"

new-page-template.png

An editing window provides different options:

  • Title: Title for the template
  • Template Thumbnail: Thumbnail to be displayed in the Page Template Selector
  • Hidden from selection: Disables the Page Template from appearing in the templates list when authors create a new page in Edit Mode
  • View: Select a View so that the template uses a rendering script instead of inheriting from the base
  • Icon: sSelect an icon from the Document Manager
  • Title from Resource Bundle: Manage the template title in a resource bundle instead of the repository
  • Theme: A theme for the template

Example: Digitall

page-template-digitall.png

Inheritance

In order to create a similar page structure without duplication, Jahia enables Template Inheritance.

A template child:

  • Inherits from the structure and areas of its parent
  • Allows content contribution only in areas that are inherited from its parent

template-inheritance.png

Base Template

The Base Template is an abstract template and, as such, cannot be accessed in Edit Mode.

It serves as the page structure root for child templates.

Creating a new Base Template

Under the template tab, right click the base of the Template Set and select "New template"

new-base-template.png

An editing window provides different options:

  • Title text field: Title for the template
  • Hidden from selection: (irrelevant since this template is not selectable)
  • View: Select a View so that the template uses a rendering script instead of inheriting from the base
  • Icon: Select an icon from the Document Manager
  • Title from Resource Bundle: Manage the template title in a resource bundle instead of the repository
  • Theme: A theme for the template

Examples: Digitall and Acme Space

example-base-template-digitall.png

example-base-template-acme-space.png

Absolutes Areas

Sharing Content using Templates

An Absolute Area is a component that displays the same content on each page where it has been added.

Absolute areas are generally used to display the common parts of the template layout: main logo, header, footer, etc.

An example of Absolute Area in Jahia Studio

what-is-absolute-area.png
 

Absolute Area Configurations

Level: This specifies the ancestor level 

  • 0 is for the home page level
  • 1 for the first subpages level, and so on.
  • If a level is not specified, the content list is pulled from the site's home page.

Limited editing from the main page

  • When selected, the absolute area may only be edited from the parent page.

The absolute area is created using the same process as a general Area. As a reminder, an ancestor level must be specified and content contribution may be restricted to the main page.