Facebook 2008 FBML User's Guide

facebook FBML Reference GuideConsolidated by: yapish.comLast updated: 03/10/2008

facebook FBML Reference Guide Page 10 of 159Fb:profile-picDescriptionTurns into an img tag for the specified user's or Facebook Page's profi

facebook FBML Reference Guide Page 100 of 159Examples<div style="padding: 10px;"> <fb:request-form method="post" action=

facebook FBML Reference Guide Page 101 of 159www.yapish.com

facebook FBML Reference Guide Page 102 of 159Fb:request-form-submitDescriptionCreates a button that submits an fb:request-form. Use this along with an

facebook FBML Reference Guide Page 103 of 159Fb:application-nameDescriptionRenders the application name. Use this tag to render the name of an applica

facebook FBML Reference Guide Page 104 of 159Status messages Fb:errorDescriptionRenders a standard Facebook error message. The content within the <

facebook FBML Reference Guide Page 105 of 159Fb:explanationDescriptionRenders a standard Facebook explanation message. The content contained within th

facebook FBML Reference Guide Page 106 of 159Fb:successDescriptionRenders a standard Facebook success message. The content within the <fb:success&g

facebook FBML Reference Guide Page 107 of 159Fb:messageDescriptionRenders the heading text for an error, explanation or success message.Examplesfb:mes

facebook FBML Reference Guide Page 108 of 159Fb:editorDescriptionCreates a form with two columns, just like the form on the edit-profile page. The chi

facebook FBML Reference Guide Page 109 of 159NotesMock AJAX There is currently no way to implement Mock AJAX using fb:editor. In order to use Mock AJA

facebook FBML Reference Guide Page 11 of 159Fb:eventlinkDescriptionPrints the specified event name and formats it as a link to the event's page.A

facebook FBML Reference Guide Page 110 of 159Fb:editor-buttonDescriptionRenders a button of type submit inside an fb:editor tag. This tag can be a chi

facebook FBML Reference Guide Page 111 of 159Fb:editor-buttonsetDescriptionA container for one or more fb:editor-button tags, which are rendered next

facebook FBML Reference Guide Page 112 of 159Fb:editor-cancelDescriptionRenders a Cancel button inside an fb:editor tag. AttributesRequired Name Type

facebook FBML Reference Guide Page 113 of 159Fb:editor-customDescriptionAllows you to put any content into an fb:editor block, as long as it is valid

facebook FBML Reference Guide Page 114 of 159Fb:editor-dateDescriptionCreates two drop down list boxes that let a user select a date. The month is lis

facebook FBML Reference Guide Page 115 of 159Fb:editor-dividerDescriptionRenders a horizontal line separator in the column containing the form element

facebook FBML Reference Guide Page 116 of 159Fb:editor-monthDescriptionCreates a form selector element displaying the month. This article or section n

facebook FBML Reference Guide Page 117 of 159Fb:editor-textDescriptionCreates an <input> of type text.AttributesRequired Name Type Descriptionop

facebook FBML Reference Guide Page 118 of 159Fb:editor-textareaDescriptionCreates a <textarea> element. AttributesRequired Name Type Description

facebook FBML Reference Guide Page 119 of 159Fb:editor-timeDescriptionCreates a series of form selector elements showing the time in hours and minutes

facebook FBML Reference Guide Page 12 of 159Fb:grouplinkDescriptionPrints the specified group name and formats it as a link to the group's page.A

facebook FBML Reference Guide Page 120 of 159Page navigation Fb:dashboardDescriptionRenders a standard Facebook dashboard header. Dashboards can conta

facebook FBML Reference Guide Page 121 of 159</fb:dashboard><fb:else><fb:dashboard>{include file='header-actions-external.tpl&a

facebook FBML Reference Guide Page 122 of 159Fb:actionDescriptionRenders a link, usually for navigational purposes. Its appearance depends on its cont

facebook FBML Reference Guide Page 123 of 159See AlsoYou can see a real world example of this tag in the Who's Showing Up demo application. Go to

facebook FBML Reference Guide Page 124 of 159Fb:create-buttonDescriptionRenders a Create button for adding user-generated content. This tag must be a

facebook FBML Reference Guide Page 125 of 159Fb:helpDescriptionRenders a help link. This tag must be a child of fb:dashboard. AttributesRequired Name

facebook FBML Reference Guide Page 126 of 159Fb:headerDescriptionRenders a standard Facebook title header. AttributesRequired Name Type Descriptionopt

facebook FBML Reference Guide Page 127 of 159See AlsoYou can see a real world example of this tag in the Restaurants demo application. Go to Demos for

facebook FBML Reference Guide Page 128 of 159Fb:mediaheaderDescriptionRenders a standard media header, intended mainly for displaying content contribu

facebook FBML Reference Guide Page 129 of 159Fb:header-titleDescriptionSpecifies the header title for a fb:mediaheader.Examples<pre><fb:media

facebook FBML Reference Guide Page 13 of 159Fb:networklinkDescriptionPrints the specified network name and formats it as a link to the network's

facebook FBML Reference Guide Page 130 of 159Fb:owner-actionDescriptionSpecifies an action link to be displayed inside a fb:mediaheader when the viewe

facebook FBML Reference Guide Page 131 of 159Fb:tabsDescriptionRenders a group of standard Facebook navigation tabs. Must contain at least one fb:tab-

facebook FBML Reference Guide Page 132 of 159Fb:tab-itemDescriptionRenders a standard Facebook tab. Must always be a child of fb:tabs.AttributesRequir

facebook FBML Reference Guide Page 133 of 159Notesfb:tabs and fb:tab-item do not render correctly within the FBML Test Console Dynamic FBML, clickt

facebook FBML Reference Guide Page 134 of 159Dialog Fb:dialogDescriptionImportant: The fb:dialog tag is in beta mode right now, which means there is a

facebook FBML Reference Guide Page 135 of 159<fb:dialogresponse> <fb:dialog-title>My Little Dialog Part II</fb:dialog-title> <f

facebook FBML Reference Guide Page 136 of 159Fb:dialog-titleDescriptionfb:dialog-title is a child of fb:dialog and renders a title for what is display

facebook FBML Reference Guide Page 137 of 159Fb:dialog-contentDescriptionThe fb:dialog-content tag is a child of fb:dialog and represents the content

facebook FBML Reference Guide Page 138 of 159Fb:dialog-buttonDescriptionRenders a button for the fb:dialog popup. The fb:dialog-button tag is a child

facebook FBML Reference Guide Page 139 of 159Wall Fb:wallDescriptionEmulates a wall environment.Examples<fb:wall> <fb:wallpost uid="123

facebook FBML Reference Guide Page 14 of 159Fb:is-in-networkDescriptionDisplays content inside the tag only if the user is in a given network. Note: Y

facebook FBML Reference Guide Page 140 of 159Fb:wallpostDescriptionRenders a wall-style post. You should use it inside fb:wall tags, but it renders fi

facebook FBML Reference Guide Page 141 of 159Fb:wallpost-actionDescriptionDisplays a link at the bottom of a wallpost (even if it appears before other

facebook FBML Reference Guide Page 142 of 159Dynamic FBML attributesSummaryVisibility (clicktoshow, clicktohide,clicktotoggle) Mock AJAX (clickre

facebook FBML Reference Guide Page 143 of 159to be.) To prevent this from happening, use a bookmark name that does not exist, such as href="#none

facebook FBML Reference Guide Page 144 of 159DynamicFBML/MockAJAXAttributesclickrewriteid - This is the id of the div that will be replaced by the ret

facebook FBML Reference Guide Page 145 of 159DynamicFBML/FormsAttributesclicktoenable - Will enable the form elements specified by id. clicktodisable

facebook FBML Reference Guide Page 146 of 159RequireloginDescriptionYou can add the attribute requirelogin to anchor tags to ensure that the user will

facebook FBML Reference Guide Page 147 of 159FBJSDescriptionFBJS is Facebook's solution for developers who want to use JavaScript in their Facebo

facebook FBML Reference Guide Page 148 of 159//--></script>As you can see, creating FBJS is very similar to JavaScript. Note, however, that t

facebook FBML Reference Guide Page 149 of 159lastChild getLastChild childNodes getChildNodes Returns a snapshot array of childNodes innerHTML n/a

facebook FBML Reference Guide Page 15 of 159Fb:if-can-seeDescriptionDisplays the enclosed content if the logged in user can see the specified what att

facebook FBML Reference Guide Page 150 of 159type getType setType selectedIndex getSelectedIndex setSelectedIndex selected getSelected setSelect

facebook FBML Reference Guide Page 151 of 159Textbox selections have been implemented with the methods getSelection and setSelection. getSelection ret

facebook FBML Reference Guide Page 152 of 159 firedByDescription.setTextValue(''); return true; } //otherwise... do some processing:

facebook FBML Reference Guide Page 153 of 159AJAXFBJS supplies a very powerful AJAX object for developers. Facebook proxies all AJAX requests and opti

facebook FBML Reference Guide Page 154 of 159(constructor) type can be either Dialog.DIALOG_POP or Dialog.DIALOG_CONTEXTUAL. Dialog.DIALOG_POP This i

facebook FBML Reference Guide Page 155 of 159TipsDon't create JavaScript which depends on a sensitive DOM structure. Code like this.getElementByT

facebook FBML Reference Guide Page 156 of 159Usage notes Forms Images CSS, Design, and the DOM JavaScript Flavors Facebook Us

facebook FBML Reference Guide Page 157 of 159Invalid CSS attributes Certain CSS properties are stripped by the Facebook platform for security. This se

facebook FBML Reference Guide Page 158 of 159See also Requested FBML Tags FBML DTD www.yapish.com

facebook FBML Reference Guide Page 159 of 159External linksFBML Test Console Retrieved from "http://wiki.developers.facebook.com/index.php/F

facebook FBML Reference Guide Page 16 of 159Fb:if-can-see-photoDescriptionDisplays the enclosed content only if the logged in user can see the photo s

facebook FBML Reference Guide Page 17 of 159Fb:if-is-app-userDescriptionDisplays the enclosed content only if the specified user has accepted the term

facebook FBML Reference Guide Page 18 of 159Fb:if-is-friends-with-viewerDescriptionDisplays the enclosed content only if the specified user is friends

facebook FBML Reference Guide Page 19 of 159Fb:if-is-group-memberDescriptionDisplays the enclosed content only if the specified user is a member of th

facebook FBML Reference Guide Page 2 of 159Table of ContentsTable of Contents

facebook FBML Reference Guide Page 20 of 159Fb:if-is-userDescriptionOnly renders the content inside the tag if the viewer is one of the specified user

facebook FBML Reference Guide Page 21 of 159Fb:if-user-has-added-appDescriptionDisplays the enclosed content only if the specified user has added the

facebook FBML Reference Guide Page 22 of 159Deprecated Tags Fb:userlinkDescriptionPrints the specified user's full name linked to their profile a

facebook FBML Reference Guide Page 23 of 159Fb:if-is-own-profileDescriptionThis tag is deprecated, since if- tags are no longer allowed on profile pag

facebook FBML Reference Guide Page 24 of 159Profile-specific Fb:wideDescriptionThe enclosed content appears only when profile box is in the wide colum

facebook FBML Reference Guide Page 25 of 159Fb:narrowDescriptionRenders the content contained by the tag only if the profile box is in the narrow colu

facebook FBML Reference Guide Page 26 of 159Fb:profile-actionDescriptionRenders a link on the user's profile under their photo (such as "Vie

facebook FBML Reference Guide Page 27 of 159Check Out Application</fb:profile-action></fb:else></fb:visible-to-user> NotesUse profil

facebook FBML Reference Guide Page 28 of 159Fb:user-tableDescriptionRenders a table, each cell of which contains a thumbnail and name for a particular

facebook FBML Reference Guide Page 29 of 159Fb:user-itemDescriptionRenders a single cell of a table, which contains a thumbnail and name for a particu

facebook FBML Reference Guide Page 3 of 159Fb:flv

facebook FBML Reference Guide Page 30 of 159Fb:subtitleDescriptionDefines the subtitle for the profile box. The enclosed content is interpreted purely

facebook FBML Reference Guide Page 31 of 159Fb:actionDescriptionRenders a link, usually for navigational purposes. Its appearance depends on its conta

facebook FBML Reference Guide Page 32 of 159See AlsoYou can see a real world example of this tag in the Who's Showing Up demo application. Go to

facebook FBML Reference Guide Page 33 of 159Visibility on Profile Fb:visible-to-ownerDescriptionDisplays content inside only if the viewer of the prof

facebook FBML Reference Guide Page 34 of 159Fb:visible-to-userDescriptionOnly displays the content inside the tag if the viewer is the specified user.

facebook FBML Reference Guide Page 35 of 159Fb:visible-to-friendsDescriptionUse this tag to display the content inside the tag on a user's profil

facebook FBML Reference Guide Page 36 of 159Fb:visible-to-app-usersDescriptionDisplays the enclosed content only if the viewer has granted full permis

facebook FBML Reference Guide Page 37 of 159Fb:visible-to-added-app-usersDescriptionDisplays the enclosed content only if the viewer has added the app

facebook FBML Reference Guide Page 38 of 159Fb:visible-to-connectionDescriptionUse this tag to display the content inside the tag on a user's or

facebook FBML Reference Guide Page 39 of 159Fb:18-plusDescriptionRestricts content to users who are age 18 or older. Examples<fb:18-plus>Oooh la

facebook FBML Reference Guide Page 4 of 159Fb:editor-buttonset

facebook FBML Reference Guide Page 40 of 159Fb:21-plusDescriptionRestricts content to users who are age 21 or older. Examples<fb:21-plus>Oooh la

facebook FBML Reference Guide Page 41 of 159Embedded media Fb:iframeDescriptionInserts an <iframe> tag into the page.AttributesRequired Name Typ

facebook FBML Reference Guide Page 42 of 159Fb:photoDescriptionRenders a Facebook photo.AttributesRequired Name Type Descriptionrequired pid int An AP

facebook FBML Reference Guide Page 43 of 159Fb:mp3DescriptionRenders a flash-based audio player. AttributesRequired Name Type Descriptionrequired src

facebook FBML Reference Guide Page 44 of 159Fb:swfDescriptionRenders a Shockwave Flash (SWF) object. On profile pages, an image appears first. When th

facebook FBML Reference Guide Page 45 of 159fb_sig_profile int The uid of the user into whose profile the Flash object is being loaded; this is blank

facebook FBML Reference Guide Page 46 of 159NotesCurrently, Facebook requires Flash version 9.0.0 for all <fb:swf> tags. Make sure that the flas

facebook FBML Reference Guide Page 47 of 159Fb:flvDescriptionRenders a Flash-based FLV player that can stream arbitrary FLV (video/audio) files on the

facebook FBML Reference Guide Page 48 of 159Fb:silverlightDescriptionRenders a Microsoft Silverlight control. On profile pages, an image appears first

facebook FBML Reference Guide Page 49 of 159Tools Fb:boardDescriptionThis tag is currently in beta. It is available for all applications. Please post

facebook FBML Reference Guide Page 5 of 159FBMLFrom Facebook Developers WikiJump to: navigation, searchFacebook Markup Language (FBML) enables you to

facebook FBML Reference Guide Page 50 of 159returnurl string The URL where the user is returned after selecting a "back" link. (default valu

facebook FBML Reference Guide Page 51 of 159Fb:commentsDescriptionDisplays a set of comments for a unique identifier. Facebook handles posting, drawin

facebook FBML Reference Guide Page 52 of 159Examples<fb:comments xid="titans_comments" canpost="true" candelete="false&quo

facebook FBML Reference Guide Page 53 of 159Fb:friend-selectorDescriptionRenders a predictive friend selector input for a given person. You can use th

facebook FBML Reference Guide Page 54 of 159See AlsoYou can see a real world example of this tag in the Footprints demo application. Go to Demos for m

facebook FBML Reference Guide Page 55 of 159Fb:google-analyticsDescriptionInserts appropriate Google Analytics code into a canvas page.AttributesRequi

facebook FBML Reference Guide Page 56 of 159uccn string The name of the campaign. This is a UTM campaign tracking setting. (default value is utm_campa

facebook FBML Reference Guide Page 57 of 159Fb:ifDescriptionOnly renders the content inside the tag if value tag is set to true.AttributesRequired Nam

facebook FBML Reference Guide Page 58 of 159Fb:elseDescriptionHandles the else case inside any fb:if, fb:if-* or fb:is-in-network tag. Applicable tags

facebook FBML Reference Guide Page 59 of 159Fb:mobileDescriptionRenders the contained content only when viewed on the mobile website (http://m.faceboo

facebook FBML Reference Guide Page 6 of 159Facebook tags Summary:User/GroupsDeprecated Tags Profile-specific Visibility on Profile Embedded media Tool

facebook FBML Reference Guide Page 60 of 159Fb:multi-friend-inputDescriptionRenders a multi-friend form entry field like the one used in the message c

facebook FBML Reference Guide Page 61 of 159When used, it appears to disable the recipient input box on the popup for fb:share-button. [possible bug?]

facebook FBML Reference Guide Page 62 of 159Fb:randomDescriptionRandomly chooses an item inside the tags based on the weights provided. fb:random allo

facebook FBML Reference Guide Page 63 of 159Fb:random-optionDescriptionContains code to be output when selected by the fb:random tag. You can control

facebook FBML Reference Guide Page 64 of 159Fb:switchDescriptionEvaluates every fb: tag inside and returns the first one that evaluates to anything ot

facebook FBML Reference Guide Page 65 of 159Fb:defaultDescriptionThis article or section needs expansion For a group of fb: tags contained within an f

facebook FBML Reference Guide Page 66 of 159Fb:user-agentDescriptionDisplays the contents wrapped inside the tag to the specified user-agents. You can

facebook FBML Reference Guide Page 67 of 159NotesIf both the includes and excludes attributes exist, the order of operation is to evaluate the include

facebook FBML Reference Guide Page 68 of 159Fb:typeahead-inputDescriptionThis tag is currently in beta. Please post bugs in the Bug Tracker. Creates a

facebook FBML Reference Guide Page 69 of 159http://bugs.developers.facebook.com/show_bug.cgi?id=1372 www.yapish.com

facebook FBML Reference Guide Page 7 of 159possessive bool Make the user's name possessive (e.g. Joe's instead of Joe). (default value is fa

facebook FBML Reference Guide Page 70 of 159Fb:typeahead-optionDescriptionThis tag is currently in beta. Please post bugs in the Bug Tracker. This tag

facebook FBML Reference Guide Page 71 of 159MiscFb:js-stringDescriptionThis tag renders a block of FBML into an FBML block variable instead of renderi

facebook FBML Reference Guide Page 72 of 159</script>www.yapish.com

facebook FBML Reference Guide Page 73 of 159Fb:fbmlDescriptionDefines a block of FBML to be rendered in a specific version of FBML.AttributesRequired

facebook FBML Reference Guide Page 74 of 159Fb:fbmlversionDescriptionPrints the version of FBML currently in scope. You should use this tag only for d

facebook FBML Reference Guide Page 75 of 159Fb:redirectDescriptionRedirects a user's browser to a new URL within the Facebook canvas.AttributesRe

facebook FBML Reference Guide Page 76 of 159Fb:refDescriptionFetches and renders FBML from a given ref source – either a ref string "handle"

facebook FBML Reference Guide Page 77 of 159Cache Expiration As mentioned within a forum thread by a member of the Facebook team: "You only need

facebook FBML Reference Guide Page 78 of 159Fb:share-buttonDescriptionRenders a standard Share button in a profile for the specified URL or content. A

facebook FBML Reference Guide Page 79 of 159Fb:timeDescriptionRenders the date and time in the user's time zone. AttributesRequired Name Type Des

facebook FBML Reference Guide Page 8 of 159Fb:userDescription Forces the enclosed content to be restrained to site privacy checks[verify] based on the

facebook FBML Reference Guide Page 80 of 159Fb:titleDescriptionSets the page's <title> tag to its contents. Alternatively, when used inside

facebook FBML Reference Guide Page 81 of 159Fb:page-admin-edit-headerDescriptionFor apps that can be added to Facebook Pages, this adds a standardized

facebook FBML Reference Guide Page 82 of 159Forms Fb:submitDescriptionCreates a JavaScript submission mechanism for a form, which makes image or text

facebook FBML Reference Guide Page 83 of 159Message/Wall attachments Fb:attachment-previewDescriptionRenders a link in a wall or message attachment th

facebook FBML Reference Guide Page 84 of 159When the user clicks your "attach" link, Facebook calls your script and displays it in a pop-up

facebook FBML Reference Guide Page 85 of 159<table width="100%" border="0" cellspacing="0" cellpadding="3"&

facebook FBML Reference Guide Page 86 of 159Notifications and requests Fb:notif-subjectDescriptionSpecifies the content of the email subject line for

facebook FBML Reference Guide Page 87 of 159Fb:notif-pageDescriptionSpecifies content of a notification that appears on a user's Notifications pa

facebook FBML Reference Guide Page 88 of 159Fb:notif-emailDescriptionSpecifies content of the email body for a notification sent with the notification

facebook FBML Reference Guide Page 89 of 159Fb:req-choiceDescriptionSpecifies a button to be shown at the bottom of a request on the user's reque

facebook FBML Reference Guide Page 9 of 159Fb:pronounDescriptionRenders a pronoun for a specific user.AttributesRequired Name Type Descriptionrequired

facebook FBML Reference Guide Page 90 of 159Fb:request-formDescriptionCreates a form that sends requests to the selected users. To send requests/invit

facebook FBML Reference Guide Page 91 of 159ids array A zero-based array containing all of the user IDs of the people the user invited. ExamplesExampl

facebook FBML Reference Guide Page 92 of 159protected Map referenceData(HttpServletRequest request) throws Exception {logger.info("InviteFriendsF

facebook FBML Reference Guide Page 93 of 159Example PHP Invite Page<?phprequire_once('config.php');require_once('init.php');req

facebook FBML Reference Guide Page 94 of 159// Build an delimited list of users...if ($rs){for ( $i = 0; $i < count($rs); $i++ ){if ( $arFriends !

facebook FBML Reference Guide Page 95 of 159Example Overloaded Form<fb:fbml><fb:request-form method="POST" action="compare.php

facebook FBML Reference Guide Page 96 of 159<div class="clearfix" style="padding-bottom: 10px;"><fb:multi-friend-selector

facebook FBML Reference Guide Page 97 of 159Fb:multi-friend-selectorDescriptionThere are actually two versions of this button - the full version and t

facebook FBML Reference Guide Page 98 of 159Post VariablesRequired Name Type Descriptionids array An array of the user IDs chosen by the user. Example

facebook FBML Reference Guide Page 99 of 159Fb:multi-friend-selector (condensed)DescriptionThere are actually two versions of this button - the full v