Adds Facebook-powered social features to your WordPress site themes and publishing flow.
=== Facebook === Contributors: Facebook, automattic, niallkennedy, mattwkelly, rgharpuray, ngfeldman, jamesgpearce, ravi.grover, danielbachhuber, gigawats, eosgood, Otto42, colmdoyle, zazinteractive Tags: Facebook, comments, social, friends, like, like button, social plugins, facebook platform, page, posts, sidebar, plugin, open graph, publish Facebook Requires at least: 3.3 Tested up to: 3.9 License: GPLv2 License URI: http://www.gnu.org/licenses/gpl-2.0.html Stable tag: 1.5.5
Add Facebook social plugins and the ability to publish new posts to a Facebook Timeline or Facebook Page. Official Facebook plugin.
== Description ==
The Facebook plugin for WordPress adds Facebook social plugins to your WordPress site. Associate your WordPress site with a free Facebook application identifier to enable advanced features such as automatically sharing new posts to an author's Facebook Timeline or your site's Facebook Page. This plugin is developed by Facebook with extra support for popular plugins and themes, custom post types, and custom post statuses.
= Features =
= Shortcodes =
Add a Like Button, Send Button, Follow Button, or Embedded Posts using a shortcode inside your post or evaluated from within your theme. You may override site-level options with shortcode attributes defined on the social plugin's page.
= Contributing code =
The development source code for this plugin is available on Facebook's GitHub account. Pull Requests and code discussion welcome.
== Installation ==
== Screenshots ==
== Custom actions & filters ==
= Actions =
facebook_settings_before_header_$hook_suffix- add content to a settings page before the main page header section
facebook_settings_after_header_$hook_suffix- add content to a settings page after the main page header section
facebook_settings_footer_$hook_suffix- add content to a settings page below the wrapper div
facebook_comment_form_before- comment form pluggable action replacing the WordPress
facebook_comment_form_after- comment form pluggable action replacing the WordPress
= Filters =
facebook_features- limit the plugin features available on your site
facebook_content_filter_priority- choose the priority of Facebook social plugin filters attached to
the_contentfilter. Affects where Facebook content is output on your page relative to other plugins attached to
fb_locale- directly define your site locale based on the list of Facebook locale mappings
facebook_excerpt_length- choose a custom length, in words, of a post excerpt generated for use in the Open Graph protocol description. default: 55
facebook_excerpt_more- string appearing at the end of a truncated excerpt string. default: "…"
fb_rel_canonical- customize the canonical URL used by Facebook for a post. Affects Open Graph protocol URL definitions, URL references sent in Open Graph actions, and more. default: result of
facebook_comment_schema_org- override output of search engine friendly comments content using Schema.org microdata markup
facebook_comments_number_more- override the default "% Comments" text used to generate a client-side comments number. similar to WordPress' comments_number more parameter
facebook_og_type- set an Open Graph object type for a specific post early in the Open Graph process. Affects Open Graph protocol properties built with the page and later passed to
fb_meta_tags. Affects Open Graph action publishing: only an article may be published to a Facebook Timeline using the news.publishes action
fb_meta_tags- Customize Open Graph protocol markup before it is output to the page
facebook_ogp_prefixed- true to always use prefixed properties (og:title) or false to use full IRI properties (http://ogp.me/ns#title)
facebook_rdfa_mappings- array of RDFa references with desired prefix. Used to remap Open Graph protocol properties from a full IRI to a prefix
facebook_wp_comments_title- set a custom title for the Facebook comments template
facebook_wp_list_comments- customize the arguments sent to
wp_list_commentsfor display of WordPress comments inside the Facebook comments template
facebook_comments_wrapper- override the display of Facebook comments fetched from Facebook servers for display on the page. default: noscript. set to an empty string to prevent fetch and inclusion
fb_get_user_meta- fetch a user meta value by attaching to this filter, bypassing the WordPress user meta API
fb_update_user_meta- update a user meta value by attaching to this filter, bypassing the WordPress user meta API
fb_delete_user_meta- delete a user meta value by attaching to this filter, bypassing the WordPress user meta API
== Frequently Asked Questions ==
= How do I sign up for a Facebook application ID for my website? =
You may create a new Facebook application or edit your existing Facebook application through the Facebook Developers application interface. You may first need to signup for a Facebook Developer account.
= I am unable to save my Facebook application ID and secret =
Some webmasters have reported issues saving Facebook application ID and secret information in the Facebook settings page. These inputted values are verified with Facebook servers before saving, requiring an HTTPS request to Facebook servers. Some sites experiencing issues have identified their server's bundled SSL certificates as an issue; returning false for the
https_ssl_verifyfilter used by the WordPress HTTP class may help fix server-to-server communication issues if updating your cURL or other libraries is not an option.
= How do I change the image that appears for my posts shared on Facebook? =
The plugin generates Open Graph protocol markup for your site's webpages including a explicitly-specified images generated from the post thumbnail, attached images, or gallery shortcode. Your plugin or theme may define additional images through the
fb_meta_tagsfilter. If an image or images already exists your additional image may be used as an alternate for stories shared through a pasted link. Unattended story summaries such as a Like Button click use the first defined image. support sticky
= I do not like the summary of my posts shared to Facebook =
Facebook generates a story summary for pasted links and new posts sent to your Timeline or Page based on metadata found on your page. The Facebook plugin for WordPress generates Open Graph protocol metadata to assist Facebook's understanding of your webpages. The Facebook URL debugger provides a view into Facebook's representation of your webpage and relevant extracted metadata. Test URLs of interest in the debugger to better understand how your page might be represented on Facebook.
= I do not see an option to associate my Facebook account from my WordPress profile page =
Make sure your Facebook application is properly configured for Facebook Login including the correct app domain and website URL. The Facebook debug settings submenu item in your WordPress administrative interface highlights some common issues.
= How do I moderate comments and add reviewers? =
The Comment Moderation Tool allows you to customize your Facebook application's moderators, blacklisted words, external logins, and more.
= Does Facebook Comments work with my existing WordPress comments? =
The Comments Box social plugin is meant to replace the WordPress commenting system with a more social, client-side experience. We do not currently support synchronizing comments stored on Facebook with comments stored in your WordPress database. Posts with existing WordPress comments will display those comments followed by the Facebook Comments Box.
= Why do comments on a post published to my Facebook Timeline or Page not appear inside Facebook Comments Box on my post page? =
The Facebook Comments Box social plugin is a separate commenting system associated with a URL regardless of your authors' decision to post to his or her Facebook Timeline or your site's Facebook Page.
= What additional configuration steps do I need to complete to enable an Open Graph action for my Facebook application? =
Visit the Facebook plugin for WordPress getting started page for more details and screenshots of each step in the process. You will need to create an Open Graph action-object pair for your Facebook application: publish an article. You will need to submit the new publish action for approval with support for action capabilities allowing custom messages on an author's Timeline, mentioning Facebook friends and Facebook pages within that message, and marking the new post as explicitly shared.
= I set up my social plugin but nothing happened =
Some social plugins require a URL representing a specific Facebook feature: the Follow button accepts a person's Timeline URL; the Like Box accepts a Page URL. Try configuring similar parameters through the appropriate Facebook social plugins page to view a preview of what to expect on your WordPress site after a successful configuration.
= My site content is Spanish. Why does Facebook display social plugin text in English? =
fb_localefilter for more exact control.
== Upgrade Notice ==
= 1.5.5 = Unescaped widget titles. Deprecated function update. Latest Facebook SDK for PHP.
= 1.5.4 = Like Button share button support. Facebook Embedded Post custom width. Facebook SDK for PHP 3.2.3.
= 1.5.3 = Delete Facebook account data from user profile. Facebook Login info in settings debug. Improve social publishing of scheduled posts.
= 1.5.2 = Include app secret proof with Page access tokens.
= 1.5.1 = Open Graph protocol markup for singular query types. Sign API app access token calls with app secret proof.
= 1.5 = New Facebook account association tools. Enhanced Open Graph Protocol. Facebook Embedded Posts. WP 3.6 extras.
= 1.4 = Support new Facebook Comment API. Improve reliability of application credential verification. WP 3.6 updates.
= 1.3.1 = Block new comments to Comments Box posts. Improved session handling for PHP SDK.
= 1.3 = Opt-in to the advanced features of Open Graph publishing after successful Facebook application configuration. Comments Box moved to comments template, overriding your theme's comments template for enabled post types. Existing WordPress comments displayed above Comments Box.
= 1.2.3 = Publish to Page with app access token. Improved custom post type support. Improved publish author validation.
= 1.2.2 = Improve performance of settings migration from old versions of the plugin.
= 1.2.1 = Fixes an issue with author pages and Open Graph protocol.
= 1.2 = App access token support. Mention tagging support. Explicit sharing to Facebook Timeline and/or Facebook Page.
= 1.1.11 = Like Box widget. Improved locale selector. Bugfix publishing to a Facebook Page.
= 1.1.10 = Improved string comparison functions for some installs. Improved support for sites without registered sidebars.
= 1.1.9 = Subscribe Button is now Follow Button. Google Analytics social action tracking support. Gallery images included in Open Graph protocol markup.
= 1.1.8 = Bugfix for post context on a comments filter.
= 1.1.7 = Improved comment filters. Add post author as Comment Box admin/moderator. Hide settings error displayed if no output functions exist.
= 1.1.6 = Debug page, og: prefixed Open Graph protocol properties, Shortcode API support for Like and Send buttons, comments improvements.
= 1.1.5 = Fix comments enabled option improperly set on comments settings save when no post types selected.
= 1.1.4 = Comments number filter available on all contexts when comments box enabled for one or more post types.
= 1.1.3 = Fix recommendations bar issue and PHP issue affecting 5.2.4 - 5.2.8 installs.
= 1.1.2 = Improved compatibility with PHP 5.2 installations. Recommendations Bar fix.
= 1.0.2 = Improve site performance when cURL not installed or SSL not available. Removed post meta boxes when social publishing features not enabled.
= 1.0.1 = Security fixes. Improved customization and debugging of settings. l10n and i18n fixes.
== Changelog ==
= 1.5.5 = * Update Facebook SDK for PHP app secret proof and signed request handling * Add empty directory index files to prevent autoindex files and exposed server directories * Replace deprecated
esc_sql()* Link to App Insights 2.0 * Remove widget title escaping, allowing HTML titles
= 1.5.3 = * Delete Facebook account data associated with a WordPress user from the user profile screen. * Facebook application data for Facebook Login displayed in the settings debug screen. * Improve social publisher compatibility with scheduled posts. * (beta) Convert Instagram embeds to
og:images. Convert YouTube and Vimeo embeds to Open Graph media objects for video post formats. * Improved code documentation.
= 1.5.2 = * Generate and store an app secret proof for Facebook Page access token verification
= 1.5.1 = * Expand Open Graph protocol markup to all singular post types * Generate and store an app secret proof on Facebook app id and app secret verification * Support auto embed of Facebook notes URLs
= 1.4 = * Facebook Comment API update to support July 2013 changes * Improved reliability of Facebook application credentials verification for app access token exchange * The
get_comments_numberfunction response now includes the number of comments for a post stored on Facebook servers * Update Facebook PHP SDK. Includes support for app secret proofs * Fix typo preventing custom classes on social plugins * New Facebook icons matching April 2013 Facebook favicon redesign * Added support for shortcode filters (WordPress 3.6+)
= 1.3.1 = * Reject new comments submitted for a post with comments managed by Facebook Comments Box * Improve Facebook PHP SDK performance through WordPress-managed sessions * Faster image display for mention tagging autocomplete
= 1.2.3 = * Post to Facebook Page using Facebook application access token * Do not display social publisher meta boxes or publish flow if post type not explicitly public * Improved local validators for publish flow
= 1.2.2 = * Improve performance of settings migration from old versions of the plugin
= 1.2.1 = * Fix: Properly display Open Graph protocol data on author page
= 1.2 = * Post to Timeline now uses an app access token to communicate with Facebook servers without needing an active Facebook user session. Improves XML-RPC compatibility and wp-admin performance * The Facebook PHP SDK is now loaded as needed, not with every admin request * Mention tagging Facebook friends and Facebook pages replaces previous mention meta boxes for friends and pages * Removed mention display alongside a post. Mentions are constructed in a custom Facebook message * Associate a WordPress account with a Facebook account from the edit profile page
= 1.1.11 = * Added Like Box widget for Facebook Page promotion * New locale selector provides more extensible code * Social publisher settings page inline help * Fixed bug publishing to a Facebook Page
= 1.1.10 = * Do not compare strings when needle longer than haystack * Test if expected widget files and classes exist before registering a widget. Fixes possible cache conflict
= 1.1.9 = * Support social action tracking in Google Analytics. Includes Google Analyticator and Google Analytics for WordPress support * Facebook Subscribe Button is now known as Follow Button * Add gallery images to Open Graph protocol images array if gallery shortcode present * Update to Facebook PHP SDK 3.2.2 * WordPress 3.5 color picker support in Recommendations Box and Activity Feed plugins * Fix incorrectly referenced admin menu icon file locations in minified version of icons.css
= 1.1.8 = * Bugfix: use the post global object instead of get_post on a comments filter
= 1.1.7 = * Comments Box - overrides of WordPress comment system applied at the post level, allowing more fine-grained control of comments by post type or mixed in a single loop * Comments Box - declare post author with
moderate_commentscapability an admin of the individual page, granting comment moderation capabilities on Facebook for the post * Hide settings error display if function is not yet defined
= 1.1.6 = * Open Graph protocol data output in prefixed form (e.g. og:title) instead of full IRI. You may declare your preference to always use a prefix in the future using the
= 1.1.5 = * Delete comments enabled option on plugin's settings comments page save when no comments selected.
= 1.1.4 =
= 1.1.3 =
= 1.1.2 =
= 1.1 =
= 1.0.2 =
= 1.0.1 =
= 1.0 =