After the July 2013 migration, the Send Button will require an absolute URL in the 'href' parameter.
The Send button lets users 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 lets users share content with all of their friends, the Send button lets them 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.
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.
href- the URL to send. Note: After July 2013 migration, href should be an absolute 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 parameter
fb_source- the story type ('message', 'group', 'email') in which the click occurred.
If you use the XFBML version you can subscribe to the 'message.send' event through FB.Event.subscribe.
Include the language code when you instantiate the library. Replace ‘en_US’ in this line with the correct locale code:
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.
Add the 'ref' parameter to the plugin (see "Attributes" above).
<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:
Aggregated stream stories contain all ref parameters, concatenated with commas.
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