DocsToolsSupportNewsApps

Facepile

After the July 2013 migration, the Facepile plugin will require an absolute URL in the 'href' parameter.

The Facepile plugin displays the Facebook profile pictures of people who have connected with your Facebook page via a global or custom action. It can also be configured to display pictures of people who have connected with your app.

To display pictures of people who have connected to your page via an action, you use the action parameter, like this:

<fb:facepile app_id="62572192129" action="og_runkeeper:run" width="300" max_rows="1"></fb:facepile>

To display pictures of people who like your Facebook Page, specify the URL of your page as the href parameter. To display counts of people who have connected to your app, specify your App ID as the app_id parameter.

You can add the plugin in one of two ways:

  1. Using a simple iframe you can drop into your page.
  2. Using the <fb:facepile> XFBML tag, if you use the Facebook SDK for JavaScript.
(?)
(?)
(?)
(?)
(?)
show_count (?)
(?)
(?)
Get Code

Attributes

  • href - the URL of the page. The plugin will display photos of users who have liked this page. Note: After July 2013 migration, href should be an absolute URL.
  • action - an action type. The plugin will display photos of users who have connected to your app via this action.
  • app_id - if you want the plugin to display users who have connected to your site, specify your application id as this parameter. This parameter is only available in the iframe version of the Facepile. If you are using the XFBML version of the plugin, specify your application id when you initialize the Javascript library.
  • max_rows - the maximum number of rows of faces to display. The XFBML version will dynamically size its height; if you specify a maximum of four rows of faces, but there are only enough friends to fill two rows, the XFBML version of the plugin will set its height for two rows of faces. Default: 1.
  • width - width of the plugin in pixels. Default width: 300px. Minimum width: 200px.
  • size - size of the photos and social context. Default size: medium.
  • colorscheme - the color scheme for the like button. Options: 'light', 'dark'.

Why is nothing displaying?

The plugin only displays friends photos. If the user does not have friends who have liked your page or have connected to your site, no faces will be shown.

If you are displaying users who have liked your page, and no users have liked it yet, the plugin will render nothing. If some users have liked your page, but none of the viewing users friends have liked it, the plugin will display the total number of users who have liked your page.

If you are displaying users who have connected to your site, and none of the users friends have connected yet, the plugin will render nothing.

How to show users who have connected to your site

You need to specify your application id. If you are using the iframe version simply include it as another query parameter. Example:

<iframe src="http://www.facebook.com/plugins/facepile.php? 
app_id={YOUR_APP_ID}" scrolling="no" frameborder="0" style="border:none;  
overflow:hidden; width:200px;" allowTransparency="true"></iframe>

If you are using the XFBML version specify your application id when you initialize the Javascript library. Example:

<div id="fb-root"></div><script src="http://connect.facebook.net/en_US/all.js
#appId={YOUR_APP_ID}&amp;xfbml=1"></script><fb:facepile></fb:facepile>
Updated about a week ago
Facebook © 2013 · English (US)
AboutAdvertisingCareersPlatform PoliciesPrivacy Policy