Friends 1.x

Legacy documentation for Friends 1.x.

The Friends:Status_Form function allows your users to submit a current status for their profile, similar to the way Facebook's status feature works.

{exp:friends:status_form} content {/exp:friends:status_form}

Parameters

The following parameters are available for use:

form_class=

form_class="your_form_class"

This parameter allows you to establish a class attribute for the form.

form_name=

form_name="your_form_name"

This parameter allows you to establish a name attribute for the form.

form_id=

form_id="your_form_id"

This parameter allows you to establish an ID attribute for the form.

return=

return="friends/status"

This parameter allows you to return the user to a specified template upon successful submittal of form.

Variables

All standard and custom member fields are available for use here.

Form Fields

The following form fields are available for use:

friends_status

<input type="text" name="friends_status" value="is " />

This form field collects the status the member wants submitted to their profile.

friends_status_private

<input type="checkbox" name="friends_status_private" value="y" />

This form field allows the user to control whether their status update is public or only available to their friends for viewing. Checking the checkbox with a value of y will make the status update available only to reciprocal friends.

Examples

The following example will allow your users to submit a status to their profile:

<h3>Submit a new Status:</h3>

{exp:friends:status_form
    return="friends/status"
}
    <p>
        {friends_screen_name}
        <input type="text" name="friends_status" value="is " />
    </p>
    <p>
        <input type="checkbox" name="friends_status_private" id="friends_status_private" value="y" />
        <label for="friends_status_private"> Show Only to Friends?</label>
    </p>
    <p>
        <input type="submit" name="submit" value="Add" />
    </p>
{/exp:friends:status_form}