Includes its body, if the user check validates.

----

!Usage

{{{
<wiki:UserCheck status="unknown|known|named|validated|unvalidated">
   JSP or HTML content
</wiki:UserCheck>
}}}

!Parameters

;__status__: Is used to determine if the user has logged in or what.  See below.

The possible values of "status" are:

* "unknown"     - the body of the tag is included 
                  if the user is completely unknown (no cookie, no password)
* "known"       - the body of the tag is included 
                  if the user is not unknown (i.e has a cookie, 
                  or has been authenticated.
* "named"       - the body of the tag is included 
                  if the user has either been named by a cookie, but
                  not been authenticated.
* "validated"   - the body of the tag is included 
                  if the user is validated either through the container,
                  or by our own authentication.
* "unvalidated" - the body of the tag is included 
                  if the user is not validated (i.e. he could have a cookie,
                  but has not been authenticated.)

In 2.0 there was an attribute called "exists".  This is now deprecated, but it is still recognized.  See below.

!Example
{{{
    <wiki:UserCheck status="known">
        G'day,<wiki:UserName />
    </wiki:UserCheck>

    <wiki:UserCheck status="unknown">
        Set your name in <wiki:LinkTo page="UserPreferences">UserPreferences</wiki:LinkTo>
    </wiki:UserCheck>
}}}

Displays a greeting, if the user has either set a cookie or logged in; else displays a link to the page UserPreferences.

!Notes

The behavior of this tag was significantly enhanced in 2.2.  The old tag had the parameter "exists", which corresponds to the status parameter as follows:

__OLD__
{{{
<wiki:UserCheck exists="true">
}}}
Replace with
{{{
<wiki:UserCheck status="known">
}}}

__OLD__
{{{
<wiki:UserCheck exists="false">
}}}
Replace with
{{{
<wiki:UserCheck status="unknown">
}}}