Send Button
The Send Button allows users to easily send content to their friends. People will have the option to send your URL in a message to their Facebook friends, to the group wall of one of their Facebook groups, and as an email to any email address. While the Like Button allows users to share content with all of their friends, the Send Button allows them to send a private message to just a few friends.
The message will include a link to the URL specified in the send button, along with a title, image, and short description of the link. You can specify what is shown for the title, image, and description by using Open Graph Meta Tags.
The Send button requires the JavaScript SDK.
Get a combined Like and Send button
You can implement the send button on its own, but if you also want a Like button on your site, you can simply add send=true as an attribute to the XFBML version of the Like button (or data-send="true" to the HTML5 version). This will render the Like button and Send button next to each other. Find the documentation on the Like button page.
Get a Send button
After July 2013 migration, Send button will require an absoute URL in the 'href' parameter.
Attributes
href- the URL to send. Note: After July 2013 migration, href should be an absoute URL.font- the font to display in the button. Options: 'arial', 'lucida grande', 'segoe ui', 'tahoma', 'trebuchet ms', 'verdana'colorscheme- the color scheme for the button. Options: 'light', 'dark'ref- a label for tracking referrals; must be less than 50 characters and can contain alphanumeric characters and some punctuation (currently +/=-.:_). The ref attribute causes two parameters to be added to the referrer URL when a user clicks a link from a stream story about a Send action:fb_ref- the ref parameterfb_source- the story type ('message', 'group', 'email') in which the click occurred.
FAQ
How do I know when someone sends a message from the plugin?
If you use the XFBML version you can subscribe to the 'message.send' event through FB.Event.subscribe.
How do I display the Send button in different languages?
Include the language code when you instantiate the library. Replace ‘en_US’ in this line with the correct locale code:
'//connect.facebook.net/en_US/all.js';
What analytics are available about the Send button?
If you visit facebook.com/insights and register your domain, you can see the number of sends from your domain each day and the demographics of who is clicking the Send button.
What is the best way to know which Send button on my page generated the traffic?
Add the 'ref' parameter to the plugin (see "Attributes" above).
Examples:
<fb:send ref="top_left"></fb:send>
<iframe src="...&ref=top_left"></iframe>
When a user clicks a link back to your website, we will pass the ref value as a fb_ref parameter in the referrer URL. Example:
http://www.yoursite.com/home?fb_ref=top_left&fb_source=message
Aggregated stream stories contain all ref parameters, concatenated with commas.
When I click the Send button, the popup window (or "flyout") doesn't show. Why?
If the Send button is placed near the edge of an HTML element with the overflow property set to hidden, the flyout may be clipped or completely hidden when the button is clicked. This can be remedied by setting the overflow property to a value other than hidden, such as visible, scroll, or auto.
Updated on Friday