jMessage session variable has a default name : JELIX_MESSAGE. You can change it through jMessage::session_name static member.

Example :

   jMessage::session_name = 'MYAPP_MESSAGE';

Use jMessage::add static method to store a message for further display. Give your message as first argument. it also accepts an optional type.

Example :

   // if login has failed
   jMessage::add( 'login failed : incorrect password'); // adds a message of 'default' type

   // redirect to home 

Use jMessage template plugin to display messages pending. Example :

    // in your home tpl

    // display pending messages of 'default' type within an <ul> tag 
    {jmessage} 

code above will result in the html fragment below:

  <ul class="jelix-msg">
   <li class="jelix-msg-item-default">login failed : incorrect password</li>
  </ul>

Or alternatively use jMessage::get static method to retrieve a message in a controller.

Example :

   // in your 'home' action
   $message = jMessage::get(); // retrieves messages of type 'default'

   // assign to your template
   $tpl->assign('message', $message);

Note : if your message had not been stored with the default type, you should have called jMessage::get('mytype') to retrieve it.

You can also retrieve every messages with jMessage::getAll().

To clear pending messages and thus ensures that your sessions does not get filled piles of messages, call jMessage::clearAll().

To clear a specific type of messages, use jMessage::clear(). it accepts an optional type argument. If empty, it clears messages of default type.