.. _reference_session:

Session
=======

This application uses session mechanism. The session keeps the following
values.

Chrysalio core
--------------

* ``session['lang']``: interface or user language

* ``session['user']``: user information set by
  :meth:`~chrysalio.models.dbuser.DBUser.set_session`

* ``session['sidebar']``: sidebar mode: ``Foldable`` (default) or ``Fixed``

* ``session['breadcrumbs']``: used by
  :class:`~chrysalio.lib.breadcrumbs.Breadcrumbs` class

* ``session['filters']``: used by :class:`~chrysalio.lib.filter.Filter` class

* ``session['paging']``: :class:`~chrysalio.lib.paging.Paging` class parameters

* ``session['cache']``: used by :class:`~chrysalio.includes.cache.CacheUser` to
  manage user cache.

* ``session['clipboard']``: :class:`~chrysalio.lib.clipboard.Clipboard` class
  parameters.

* ``session['panels']``: :class:`~chrysalio.lib.panel.Panel` class parameters.

* ``session['_csrft_']``: to prevent Cross-Site Request Forgery attacks

* ``session['_accessed_time']``: last access to the session

* ``session['_creation_time']``: first access to the session

`Include` Themes
----------------

* ``session['theme']``: default or user theme

`Include` Menu
--------------

* ``session['menu']``: main menu generated by
  :meth:`~chrysalio.lib.menu.Menu.xhtml`