Twig Components / Available variables in Twig
Note: You are currently reading the documentation for Bolt 4.0. Looking for the documentation for Bolt 5.2 instead?
To see all variables defined in the current page, use
# To output all variables in place in the HTML output
{{ dump() }}
# To output all variables in the Symfony toolbar
{% dump() %}
App¶
App is an instance of Symfony\Bridge\Twig\Appvariable
. It contains:
Name | Description |
---|---|
debug |
Boolean indicating whether Debug is enabled or not |
environment |
Indicating the current environment, like dev or prod |
request |
Instance of Symfony\Component\HttpFoundation\Request |
session |
Instance of Symfony\Component\HttpFoundation\Session\Session |
flashes |
Array of Session Flashes |
user |
Instance of Bolt\Entity\User |
tokenStorage |
Instance of Symfony's UsageTrackingTokenStorage |
requestStack |
Instance of Symfony\Component\HttpFoundation\RequestStack |
{{ app.debug }}
Request¶
The app variable also includes information about the request, accessible by:
{{ dump(app.request) }}
{% set request = app.request %}
{% set method = request.method %}
{% set host = request.headers.host %}
Session¶
The session can be accessed through the app variable:
{% set session = app.session %}
User¶
Apart from the global user
variable, the user can also be accessed using the
app variable:
{% set user = app.user %}
{{ user.displayName }} # shows the logged in user's display name
{{ user.username }}
{{ user.email }}
{{ user.lastSeenAt }}
{{ user.locale }}
{{ user.disabled }} # true if user is disabled, otherwise false.
{{ user.roles }} # returns an array containing the user's roles
Environment¶
The current environment, as set in your .env
file, can be accessed:
{% environment = app.environment %} # in dev, it returns 'dev'. For production, it will return 'prod'
For more info on app
, check the Symfony app variable.
Flashes¶
Symfony's flashes can be accessed through the global app variable:
{% for message in app.flashes('notice') %}
<div class="flash-notice">
{{ message }}
</div>
{% endfor %}
Config¶
The config global variable is used to access the configuration available in
your config.yaml
and contenttypes.yaml
files. It has a bunch of useful
methods
get(path)¶
Returns a config value using a path
{% set sitename = config.get('general/sitename') %}
{% set accepted_file_types = config.get('general/accept_file_types') %}
has(path)¶
Returns true if config matches path, and false otherwise.
{% set has_sitename = config.get('general/sitename') %} # returns true
{% set has_fakedummy = config.get('fake/dummy) %} # returns false
contentType(contenttype)¶
Returns the configuration for the given contenttype.
{% set homepage_config = config.contentType('homepage') %}
Theme¶
The global theme variable contains the configuration for your current theme, as
defined in theme.yaml
. For example, if you have configured your theme with a
dark/light modes, here is how to access them:
{% set mode = theme.get('mode') %}
Note: Unlike the global config
,
the global theme
variable is a multi-dimensional array. Thus,
to access nested configurations, use theme.get('level-1').get('level-2')
.
Record¶
Most pages will have a global 'record' defined that corresponds to the current page. For more information on this, see Record and Records
Couldn't find what you were looking for? We are happy to help you in the forum, on Slack or on Github.