----------------------
session_add() FUNCTION
----------------------

  ------------
  USAGE FORMAT
  ------------

    Within a PREPROCESS tag:
    
    &session_add($name, $value);

  -----------
  DESCRIPTION
  -----------

    The session_add() function adds a cookie value to the current PTM Session.
    Alternately, if the cookie value already exists, it changes the cookie's
    value. May be used ONLY in a PREPROCESS tag.
    
    After any modifications have been made using this function, a call to
    update_session() or start_session() MUST be made before ending the
    PREPROCESS tag, otherwise changes will not take effect.

  ---------
  ARGUMENTS
  ---------

    $name

      REQUIRED

      The name of the cookie you wish to create. Behind the scenes, this name
      will be prefixed with 'PTMSESSION' before being sent to the user, and that
      same string will be parsed off before being returned to you.

    $value

      REQUIRED

      The value you wish to store in the named cookie.

  -------
  RETURNS
  -------

    NONE

  --------------
  USAGE EXAMPLES
  --------------

    ----------------------------------------------------------------------
    Example 1: Adding a "Color" Cookie to the Session, If a Session Exists
    ----------------------------------------------------------------------

      <?:
        if (&is_session()) {
          &session_add('Color', 'red');
          &update_session();
        }
      ?>

  --------
  SEE ALSO
  --------

    TAGS

      PREPROCESS

    VARIABLES

      %_COOKIES, %_SESSION, %_SET_COOKIES

    FUNCTIONS

      delete_cookie(), end_session(), is_session(), session_delete(),
      session_domain(), session_id(), session_name(), session_path(),
      session_secure(), set_cookie(), start_session(), update_session()