facebook FBML Reference Guide Consolidated by: yapish.
facebook FBML Reference Guide Page 2 of 159 Table of Contents Table of Contents...................................................................................................................................................2 FBML......................................................................................................................................................................5 From Facebook Developers Wiki.................................................................................
facebook FBML Reference Guide Page 3 of 159 Fb:flv.............................................................................................................................................................47 Fb:silverlight.................................................................................................................................................48 Tools ....................................................................................................................................
facebook FBML Reference Guide Page 4 of 159 Fb:editor-buttonset......................................................................................................................................111 Fb:editor-cancel..........................................................................................................................................112 Fb:editor-custom.......................................................................................................................................
facebook FBML Reference Guide Page 5 of 159 FBML From Facebook Developers Wiki Jump to: navigation, search Facebook Markup Language (FBML) enables you to build full Facebook Platform applications that deeply integrate into a user's Facebook experience. You can hook into several Facebook integration points, including the profile, profile actions, Facebook canvas, News Feed and Mini-Feed.
facebook FBML Reference Guide Page 6 of 159 Facebook tags Summary: User/Groups Deprecated Tags Profile-specific Visibility on Profile Embedded media Tools Misc Forms Message/Wall attachments Notifications and requests Status messages Editor display Page navigation Dialog Wall User/Groups Fb:name Description Renders the name of the user specified, optionally linked to his or her profile. This also works for Facebook Pages with the ID of the Page passed as the uid parameter.
facebook FBML Reference Guide Page 7 of 159 possessive bool Make the user's name possessive (e.g. Joe's instead of Joe). (default value is false) reflexive bool Use "yourself" if useyou is true. (default value is false) shownetwork bool Displays the primary network for the uid. (default value is false) useyou bool Use "you" if uid matches the logged in user. (default value is true) ifcantsee string Alternate text to display if the logged in user cannot access the user specified.
facebook FBML Reference Guide Page 8 of 159 Fb:user Description Forces the enclosed content to be restrained to site privacy checks[verify] based on the viewer of the information. The content within the tag "belongs" to the user specified. Note: This tag does not appear to work at all when I test it, it does nothing. See bug report number 404. Attributes Required Name Type Description required uid int The user ID of the user whose information will be contained in the tag.
facebook FBML Reference Guide Page 9 of 159 Fb:pronoun Description Renders a pronoun for a specific user. Attributes Required Name Type Description required uid int The user ID for whom to generate the pronoun. You can substitute actor for the user ID so you can more easily aggregate feed stories. optional useyou bool Use the word "you" if uid is viewing the page. (default value is true) possessive bool Use the possessive form (his/her/your/their).
facebook FBML Reference Guide Page 10 of 159 Fb:profile-pic Description Turns into an img tag for the specified user's or Facebook Page's profile picture. The tag itself is treated like a standard img tag, so attributes valid for img are valid with fb:profile-pic as well. Attributes Required Name Type Description required uid int The user ID of the profile or Facebook Page for the picture you want to display. optional size string The size of the image to display. (Default value is thumb).
facebook FBML Reference Guide Page 11 of 159 Fb:eventlink Description Prints the specified event name and formats it as a link to the event's page. Attributes Required Name Type Description required eid int Event ID for the event whose name and link you want to retrieve. Examples www.yapish.
facebook FBML Reference Guide Page 12 of 159 Fb:grouplink Description Prints the specified group name and formats it as a link to the group's page. Attributes Required Name Type Description required gid int Group ID for the group whose name and link you want to retrieve. Examples www.yapish.
facebook FBML Reference Guide Page 13 of 159 Fb:networklink Description Prints the specified network name and formats it as a link to the network's page. Attributes Required Name Type required nid int Description Network ID for the network whose name and link you want to retrieve. Examples www.yapish.
facebook FBML Reference Guide Page 14 of 159 Fb:is-in-network Description Displays content inside the tag only if the user is in a given network. Note: You can use fb:else with fb:is-in-network, even though the tag does not start with fb:if-. Attributes Required Name Type Description required network int The network ID to check. You can check one network at a time. optional uid int The user ID to check.
facebook FBML Reference Guide Page 15 of 159 Fb:if-can-see Description Displays the enclosed content if the logged in user can see the specified what attribute of the specified user. You can use these settings to provide content or links with relevance to Facebook privacy or to implement your own privacy using Facebook's current controls. You can use this tag in conjunction with fb:else. Attributes Required Name Type Description required uid int The user ID to check.
facebook FBML Reference Guide Page 16 of 159 Fb:if-can-see-photo Description Displays the enclosed content only if the logged in user can see the photo specified. You should use this tag[who says?] when specifying content that should only be shown when using fb:photo. You can use this tag in conjunction with fb:else. Attributes Required Name Type Description required pid int An API-supplied pid of the photo, or any pid found in the query string of a photo URL on Facebook.
facebook FBML Reference Guide Page 17 of 159 Fb:if-is-app-user Description Displays the enclosed content only if the specified user has accepted the terms of service of the application. Use to determine whether the user has added the application to their account. Attributes Required Name Type Description optional uid int The user ID to check.
facebook FBML Reference Guide Page 18 of 159 Fb:if-is-friends-with-viewer Description Displays the enclosed content only if the specified user is friends with the logged in user. Attributes Required Name Type Description optional int uid includeself bool The user ID to check. (default value is profile owner[verify]) Return true if viewer and uid specified are the same.
facebook FBML Reference Guide Page 19 of 159 Fb:if-is-group-member Description Displays the enclosed content only if the specified user is a member of the specified group. Attributes Required Name Type Description required gid int The group ID. optional uid int The user ID to check. (default value is loggedinuser) role string The role to check. (Default value is member). Other valid values are officer, admin.
facebook FBML Reference Guide Page 20 of 159 Fb:if-is-user Description Only renders the content inside the tag if the viewer is one of the specified user(s). Attributes Required Name Type Description required uid int The user ID of the user that is allowed to see the content. To match multiple users, pass in a comma-delimited list of uids. Examples This is secret 4 u 2! Notes As of FBML v1.1 you can use this tag only on a canvas page. www.yapish.
facebook FBML Reference Guide Page 21 of 159 Fb:if-user-has-added-app Description Displays the enclosed content only if the specified user has added the application to their account. Attributes Required Name Type Description optional uid int The user ID to check. (default value is loggedinuser) Examples This user has put this app into his account. That user hasn't put this app into his account.
facebook FBML Reference Guide Page 22 of 159 Deprecated Tags Fb:userlink Description Prints the specified user's full name linked to their profile along with their network, optionally (as is normally displayed on the Wall, for example). This tag is deprecated. It is still useful in one context, however: using it in feed.publishActionOfUser (with the user ID on whose behalf the action is being published) prevents the Mini-Feed from prepending the actor's name to your feed title.
facebook FBML Reference Guide Page 23 of 159 Fb:if-is-own-profile Description This tag is deprecated, since if- tags are no longer allowed on profile pages. It was used to display content inside only if the viewer of the profile matches the profile owner.[verify] See also/instead fb:visible-to-user Attributes Examples Welcome back to your profile! This is not your profile. Notes As of FBML v1.1 you can use this tag only on a canvas page.
facebook FBML Reference Guide Page 24 of 159 Profile-specific Fb:wide Description The enclosed content appears only when profile box is in the wide column of the profile. See fb:narrow for the opposite. Attributes Examples This will only appear in the wide column. Notes If no fb:narrow or fb:wide tag is specified, all content appears in either column. The wide profile box is 388 pixels wide, not including margins. The left margin is 8 pixels, but there is no right margin.
facebook FBML Reference Guide Page 25 of 159 Fb:narrow Description Renders the content contained by the tag only if the profile box is in the narrow column of the profile. Attributes Examples This text appears only in the narrow column. Notes If no fb:narrow or fb:wide tag is specified, all content is displayed in either column. The narrow profile box is 190 pixels wide, not including margins. The left margin is 10 pixels, but there is no right margin.
facebook FBML Reference Guide Page 26 of 159 Fb:profile-action Description Renders a link on the user's profile under their photo (such as "View More photos of.."). Attributes Required Name Type Description required url string The URL to which the user is taken after clicking. Must be an absolute link. Examples PAGE 27facebook FBML Reference Guide Page 27 of 159 Check Out Application
Notes Use profile.setFBML to add the button to a user's profile. If you add this to the profile of a user who has not added your application, it will appear only to those users who have added your application. By setting the default FBML (in Edit Settings, under My Applications) to include an fb:profile-action, this action appears on every profile the user of your application sees.
facebook FBML Reference Guide Page 28 of 159 Fb:user-table Description Renders a table, each cell of which contains a thumbnail and name for a particular user, similar to the Mutual Friends table on profile pages. Inside this tag, use fb:user-item tags to specify the set of users. This tag only works on profile pages. Applications cannot use this on their canvas pages. Attributes Required Name Type Description optional cols int The number of columns in the table.
facebook FBML Reference Guide Page 29 of 159 Fb:user-item Description Renders a single cell of a table, which contains a thumbnail and name for a particular user, similar to the Mutual Friends table on profile pages. Must be used inside a fb:user-table tag. This tag only works on profile pages. Applications cannot use this on their canvas pages. Attributes Required Name Type Description required uid uid The ID of the user whose name and photo you want to show.
facebook FBML Reference Guide Page 30 of 159 Fb:subtitle Description Defines the subtitle for the profile box. The enclosed content is interpreted purely as plain text. This tag may contain fb:action, an optional tag that renders an action link on the right-hand side of the subtitle. Attributes Required Name Type Description optional seeallurl string The URL for a "See all" link. This URL must be a canvas page. Examples PAGE 31facebook FBML Reference Guide Page 31 of 159 Fb:action Description Renders a link, usually for navigational purposes. Its appearance depends on its container. The tag must be a child of either fb:dashboard or fb:subtitle. Attributes Required Name Type Description required href string The URL for the link. The URL must be a canvas page. For example, href="http://apps.facebook.com//.php". optional title string Specifies the text to display as a tool tip for this link.
facebook FBML Reference Guide Page 32 of 159 See Also You can see a real world example of this tag in the Who's Showing Up demo application. Go to Demos for more details and to download and install the demo apps. www.yapish.
facebook FBML Reference Guide Page 33 of 159 Visibility on Profile Fb:visible-to-owner Description Displays content inside only if the viewer of the profile matches the profile owner. This also works for Facebook Pages with the content only displayed to an admin of the Page. Attributes Required Name Type Description bgcolor color The color of the blank box shown to users who are not the owner.
facebook FBML Reference Guide Page 34 of 159 Fb:visible-to-user Description Only displays the content inside the tag if the viewer is the specified user.[verify] This also works for Facebook Pages with the content only displayed to an admin of the Page and the viewer is not on a Page profile. Attributes Required Name Type Description required int uid The uid of the user that is allowed to see the content.
facebook FBML Reference Guide Page 35 of 159 Fb:visible-to-friends Description Use this tag to display the content inside the tag on a user's profile only if the viewer is a friend of that user. While this tag is still valid, you may find it more versatile to use fb:visible-to-connection, since it applies equally to user profiles and Facebook Pages. Attributes Required Name optional Type Description bgcolor color The color of the blank box shown to viewers who are not friends of the user.
facebook FBML Reference Guide Page 36 of 159 Fb:visible-to-app-users Description Displays the enclosed content only if the viewer has granted full permissions to the application.[verify] Attributes Required Name Type Description bgcolor color The color of the blank box shown to users who do not own the app. Examples Welcome users! Notes This is new to FBML v1.1. Do not use this tag to display private or sensitive information.
facebook FBML Reference Guide Page 37 of 159 Fb:visible-to-added-app-users Description Displays the enclosed content only if the viewer has added the application to their account.[verify] Attributes Required Name Type Description bgcolor color The color of the blank box shown to users who are not the owner or have added the app. Examples Hey, welcome! Thanks for adding my app! Notes This is new to FBML v1.1.
facebook FBML Reference Guide Page 38 of 159 Fb:visible-to-connection Description Use this tag to display the content inside the tag on a user's or a Facebook Page's profile only if the viewer is a friend of that user or is a fan of that Facebook Page. Attributes Required Name optional Type Description bgcolor color The color of the blank box shown to viewers who are not friends of the user or fans of the Page.
facebook FBML Reference Guide Page 39 of 159 Fb:18-plus Description Restricts content to users who are age 18 or older. Examples Oooh la laBarney? www.yapish.
facebook FBML Reference Guide Page 40 of 159 Fb:21-plus Description Restricts content to users who are age 21 or older. Examples Oooh la laBarney? www.yapish.
facebook FBML Reference Guide Page 41 of 159 Embedded media Fb:iframe Description Inserts an
