Grav - Theme Variables

{{ base_dir }}

We can get Grav installations base file directory by using this variable.

{{ base_url }}

The base url of the Grav site can be accessed by using this variable.

{{ base_url_relative }}

It returns the relative path of the base url to Grav site.

{{ base_url_absolute }}

It returns the absolute path of the base url to Grav site.

{{ theme_dir }}

It is used to return the current theme's file directory folder.

{{ theme_url }}

It is used to return current theme's relative URL.

summary([size])

It gives a gist of the page content with the specified size provided as a parameter.

If size is not specified then the value is obtained from summary.size variable in system/config/site.yaml file.

You can also delimiter === in your content. The content before the delimiter will be used for summary.

{{ page.summary }}

Or

{{ page.summary(80) }}

content()

It is used to get the entire HTML content of the page.

{{ page.content }}

headers()

It returns the page headers defined in the YAML front-matter of the page.

title: About Us
author: Johnson

The author of this page is:  {{ page.header.author }}

media()

It is used to access all the media files such as images, videos and other files. It will return an array containing all the media associated with a page.

{% set first_image = page.media|first %}
{% set my_pdf = page.media['myfile.pdf'] %}
{% for image in page.media.images  %}
   {{ image.html }}
{% endfor %}

title()

It is set to return the title of the page which is defined in YAML headers for the page.

title: My Page

menu()

The value of the menu variable is returned which is specified in YAML headers of the page. If the title variable is not set, then it will default to title.

title: My Blog
menu: my blog page

visible()

It is used to set the visibility of the page. Usually pages with numeric value followed by period (i.e., 01.foldername) is displayed in menu and the folder name that does not contain numeric value (i.e., foldername) are not visible. We can override it in page header.

title: About Us
visible: true

routable()

By using this we can determine whether a page is routable or not routable meaning that whether you can receive content back while pointing your browser to the page. The pages which are not routable can be used in plugins, templates, etc., and these pages cannot be directly accessed. This is set in page headers.

title: My Page
routable: true

slug()

By using this variable, we can get direct name as displayed in the URL of the page.

my-page

url([include_host = false])

It is used to return the page's URL

{{ page.url }}  { # could return /myfolder/mypage #}

Or

{{ page.url(true) }}  {# could return http: //mysite.com/ myfolder/mypage #}

route()

It is used to return the internal routing of the page.

home()

Using this variable you can determine whether the page is configured as home page or not. This returns true when a page is configured as home page and false when not configured. You can find this setting in system.yaml file.

root()

It determines whether the current page is the root page of the hierarchy or not. It returns true if it's a root page or false if it's not root page.

active()

You can determine whether the browser is accessing the current page by using this variable. It returns true if browser is accessing this page or false if it's not.

modular()

By using this variable, we can determine whether this page is modular or not. If this is a modular page then it returns true and false if it's not.

activeChild()

This variable can determine whether this URI's URL has the URL of the active page; or, in simple words this page's URL in current URL. This is very useful when you are working on navigations and you want to know that whether the pages are iterating over same parent page.

find(url)

As specified by the route URL, the page object is returned by this variable.

{% include 'modular/author-detail.html.twig' with {'page': page.find('/authors/ john-bloggs')} %}

collection()

This variable is used to return the group of pages for a context as determined by the collection page headers.

{% for child in page.collection %}
   {% include 'partials /blog_item.html.twig' with {'page':child, 'truncate':true} %}
{% endfor %}

isFirst()

If the current page is first of it's sibling page, then it returns true else returns false.

isLast()

If the current page is last of it's sibling page, then it returns true else returns false.

nextSibling()

With reference to the current position, it returns the next sibling page from the array.

prevSibling()

With reference to the current position, it returns the previous sibling page from the array.

children()

As defined in the pages content structure, the array of child pages is returned by this variable.

orderBy()

The sorted children's order type is returned by this method. The values that may be included are default, title, date and folder and these values configured in page headers.

orderDir()

The sorted child pages’ order direction is returned by this method. And the values can be either asc(ascending) or desc(descending). Usually these values are configured in page headers.

orderManual()

This method returns an array consisting of manual page ordering and this ordering will be for any children of the page. This value will be typically set in page headers.

maxCount()

This variable tells that at most how many children pages are allowed to be returned. Usually the value is specified in page headers.

children.count()

This variable returns how many child pages are there for a page.

children.current()

This variable will return the current child item.

children.next()

This will return the next child item from an array of child pages.

children.prev()

This will return the previous child item from an array of child pages.

children.nth(position)

This will return the position of the child in the array of children.

parent()

In a nested tree structure when you want to navigate back up to the parent page, then you can use this variable. It will return the parent page object for the current page.

isPage()

By using this variable, you can determine whether this page has an actual .md file or it’s just a folder for routing.

isDir()

By using this variable you can determine whether current page is only a folder for routing. It returns true or false based on it.

id()

This will return unique id for the page.

modified()

It returns the timestamp of when the page was last modified.

date()

The date timestamp for the page is returned by this method. Usually this is configured in headers that represents the page's or post's date. If no value is provided by default the modified timestamp is used.

filePath()

By using this, you can get the full file path of the page.

/Users/yourname/sites/ Grav/user/pages/ 01.home/default.md

filePathClean()

This will return the relative path.

user/pages/ 01.home/default.md

path()

This will return a full path to the directory in which the current page is present.

/Users/yourname /sites/ Grav/user/pages /01.home

folder()

This will return the folder name for the page.

taxonomy()

This will return an array of taxonomy which is connected with the page.

path()

The part of the current url can be accessed by using this method.

uri.path = /section/category/page

paths()

The array of path elements is returned by using this method.

uri.paths = [section, category, page])

route([absolute = false][, domain = false])

This method returns route with either absolute or relative URL.

uri.route(true) = http://mysite.com/Grav/ section/category/page

Or,

uri.route() = /section/category/page)

params()

This will return the parameter portion in the URL.

uri.params = /param1:foo/param2:bar

param(id)

This will return the value of the param.

uri.param('param1') = foo

query()

The query portion of the URL can be accessed by using this method.

uri.query = query1=bar&query2=qux

query(id)

Using this you can access the specific query item.

uri.query('query1') = bar

url([include_host = true])

This returns the full URL which may or may not contain host.

uri.url(false) = Grav/section/ category/page/param:foo?query = bar

extension()

This will return the extension or if not provided, then it will return the html.

uri.extension = json)

host()

This return the host of the URL.

uri.host = mysite.com

base()

This will return the base part of the URL.

uri.base = http://mysite.com

rootUrl([include_host = true])

This will return the Grav instance's root URL.

uri.rootUrl() = http://mysite.com/Grav

referrer()

The referrer information of the page is returned by this method.