<sn:ref>

Renders and optionally retrieves a SNML reference.

Snml allows you to set references, either by using the url attribute of this tag, or by calling the fbml.setReference api method call. Either way, the snml reference is saved for you under the key you define with the handle attribute.

The first time this tag is encountered, the SNML is fetched from the url specified by the url attribute. It is then stored indefinitely by Bebo, though you should probably keep it around. Any subsequent access will not generate a hit on your servers.
If the SNML has changed, calling the fbml.refreshRefUrl method will update it.

If the tag has a handle set, you must have previously called fbml.setRefHandle, otherwise, this tag will fail. If that method was previously called, the SNML posted by that call is returned and rendered. To update the handle, simply re-call fbml.setRefHandle

Attributes

url string < optional > The url from which to fetch the fbml you would like to reference Must be an absolute url .
handle string < optional > The handle name as defined in fbml.setRefHandle. Can be any string .

Valid Contexts

MAIN: The area where your app is displayed alone
PROFILE: The Bebo profile page
NOTIF_PAGE: On a notification page (after the user has clicked on a link in the email)
INVITES_PAGE: On the invitations page