get_flash
The get_flash tag can be used to fetch value contained within a flash data variable set by the set_flash tag.
‘Flash data’ are i.e. session variables that exist for only a single server request, specifically the next one, and then are deleted.
Important
Two scenarios can cause flash messages not to work as expected:
- Multiple redirects (as happens when prettyURLs are on but a page is accessed using the ‘older’ URL. This causes Couch to redirect it to the newer (pretty) URL. The second redirection causes the flash message to be lost as it remains available for only one redirect)
- The page being redirected to has been cached by Couch (in which case the cached page would be supplied).
Parameters
- name
name
The name of the flash data variable the value of which is to be retrieved.
Variables
This is a self closing tag and sets no variables of its own.
Example
<h3>Flash Message: <cms:get_flash 'flash_msg' /></h3>
<cms:form method="post" anchor='0'>
<cms:if k_success >
<cms:set_flash name='flash_msg' value="Your transaction is complete!" />
<cms:redirect k_page_link />
</cms:if>
<cms:input name="submit" type="submit" value="Submit" />
</cms:form>