Developers

Page

This object represents a page. On every page view, there exists a property named page which provides access to properties of the current page (or the parent page in case of article and element pages).

List of available attributes

blog?

Returns true if page is a blog.

data

Returns custom data bound to page.

elements_page?

Returns true if page is an elements page.

persisted?

Returns true if the page is saved.

private?

Returns true if page is protected with password.

content_type

Returns the content type for the current page (common_page, blog, element etc.).

created_at

Returns a date when this page was first created. Use date formatting filter to format the date.

description

Page description information.

hidden?

Returns true if page is hidden from site menu.

id, page_id

Returns the ID of the page.

image

Returns imageobject that can be attached to page in page settings view.

image?

Returns true or false depending whether image is attached to page.

og_image

Returns imageobject that can be attached to page in page settings view. Alias for image.

og_image?

Returns true or false depending whether image is attached to page. Alias for image?.

keywords

Page keywords information. Site keywords are added to page unique keywords.

language_id

Page language ID.

language_code

A 2-character language code for the given page, e.g. 'en' for English, 'ru' for Russian, 'et' for Estonian.

language_region

A 2-character region code for languages that support regions. E.g. "GB" or "BR". Otherwise nil.

language_locale

Equivalent to the output of language_code for region-less languages. If a language supports regions, this is a concatenation of the language code, an underscore and the region code, e.g. "en_GB".

layout_title

Returns the name of the page's layout.

level

Page level of location in site tree. 

Returns true if the page is actually an external link.

Returns the menu item for the current page.

new_record?

Returns true if the page isn't saved yet

node_id

Page node ID.

path

Returns path for given page.

<a href="{{ page.path }}">{{ page.title }}</a>

=> <a href="current/page/path">Current page</a>

Please notice that this is a relative path for this page. We suggest you always to use absolute addresses on your site, which will be generated for you by Voog assuring less broken links. Absolute path for page can be retrieved by using url variable (see below).

path_with_lang

Like path but adds language code for front page path for cross language links consistency.

parent

Returns parent page of the current page or nothing if page is already a top-level page. Returned object is also page type of object.

Go <a href="{{ page.parent.url }}">up one level</a>

site_title

Returns title for site in given language. Should be used when rendering the <title> tag.

<html>
  <head>
    <title>{{ page.site_title }}</title>
  </head>
  ...
</html>

title

Returns title for given page

<html><head><title>{{ page.title }}</title></head>...</html>

=> <html><head><title>Current page</title></head>...</html>

full_title

Returns page full title for <title> tag value. It's created by page title and site title using page title_separator and title_format with fallback to defaults (site or system default values).

<html><head><title>{{ page.full_title }}</title></head>...</html>

=> <html><head><title>Current page – My site</title></head>...</html>

Returns page title in menu. When not set then defaults to title

title_separator

Returns page <title> tag separator override value used by full_title. When empty then site (or system default) value is used instead.

title_separator_value

Returns <title> tag separator value for page with fallback to defaults (site or system default ("–") values). It's used by full_title.

title_format

Returns page <title> tag format override value used by full_title. When empty then site (or system default) value is used instead.

Supported values and their corresponding patterns:

  • page_site<page_title> <separator> <site_title>
  • site_page<site_title> <separator> <page_title>
  • page<page_title>
  • site<site_title>

title_format_pattern

Returns <title> tag format patten for page with fallback to defaults (site or system default (<page_title> <separator> <site_title>) values). It's used by full_title

url

Returns URL for given page.

<a href="{{ page.url }}">{{ page.title }}</a>

=> <a href="/site_prefix/current/page/path">Current page</a>

created_at

Returns a date when this page was first created. Use date formatting filter to format the date.

updated_at

Returns a date when this page was last updated. Useful for showing "last updated" timestamps. Use date formatting filter to format the date.

This page was last updated at <b>{{ page.updated_at | date : "%d.%m.%Y" }}</b>

=> This page was last updated at <b>09.11.2008</b>

to_json

Serializes the page into a JSON string.