craft.session

This document is for a version of Craft CMS that is no longer supported. Please refer to the latest version →

You can get info about the active HTTP session with craft.session.

#Properties

The following properties are available:

#isLoggedIn

Returns whether a user is currently logged in.

{% if craft.session.isLoggedIn %}
  <a href="{{ logoutUrl }}">Logout</a>
{% endif %}

(Note that checking for currentUser works just as well for this.)

#rememberedUsername

Alias of getRememberedUsername()

#returnUrl

Alias of getReturnUrl()

#Methods

The following methods are available:

#getFlash( key, defaultValue, delete )

Returns a flash message by its key, or the default value if that flash message doesn’t exist. Pass false as the third parameter if you don’t want it deleted right away.

#getFlashes( delete )

Returns any flash messages that have been queued up for the user. Pass false if you don’t want them to be deleted right away.

#getRememberedUsername()

Returns the user’s username, even if they are not logged in, if they have logged in recently enough for Craft to still remember it.

<input type="text" name="loginName" value="{{ craft.session.getRememberedUsername() }}">

#getReturnUrl()

Returns the URL the user was trying to access before getting sent to the login page, because they hit a requireLogin tag.

#hasFlash()

Returns whether a flash message exists, by a given key.