Facebook for WordPress

Download Now

1. Install Facebook for WordPress either via the WordPress.org plugin directory or by uploading the plugin to your server (in the /wp-content/plugins/ directory).
2. After activating the plugin, you will be asked to set up your Facebook application credentials (via http://developers.facebook.com/apps) to enable advanced functionality such as sending new posts to your Facebook Timeline or Facebook page or tracking Facebook-powered statistics for your site.

---

The Facebook plugin for WordPress packages Facebook social plugins and publishing into a single software package deeply integrated into the WordPress publishing experience. This official plugin bundles the latest Facebook SDKs, social plugins, and Facebook best practices. We have worked with the most popular WordPress plugins to ensure compatibility and special features enabled when multiple compatible plugins are present.

The Facebook plugin requires WordPress 3.3 or newer.

Publishing new posts to your Facebook Timeline or Facebook Page requires a server software capable of communicating with Facebook servers over HTTPS.

Posts may be published to the post author's Timeline and/or a Facebook page when its status is changed to public for the first time. An author must associate his WordPress account with a Facebook account and grant the Facebook application associated with your WordPress site permission to post to his Facebook Timeline on his behalf. A Facebook account associated with one or more pages in a Content Creator or Manager role may grant the Facebook application associated with your WordPress site permission to publish on his behalf.

An author can add a custom message to a shared post before publishing or choose to disable sharing a post with his Facebook Timeline or a site's Facebook Page.

A custom message posted to an author's Facebook Timeline can mention Facebook friends and Pages through mention tagging syntax. Press the "@" key while typing a custom Timeline message followed by a search term. Search results matching your Facebook friends and Facebook Pages appear as search results below the message composer. Select a search result to insert the special mention tagging syntax into your custom message. Note: this feature requires an Open Graph action configured for the site and enabled through Social Publisher settings

Many social plugins are offered and can be easily enabled on the settings page.

• Like, Send and Follow buttons
• Comments Box including comments markup added to your page for easy indexing by search engines. Moderate comments, add login providers, and block specific words from appearing in comments using the Comment Moderation Tool.
• Recommendations Bar allows users to discover additional content on your site and like the current page after reading your page content.

The plugin also supports WordPress Widgets, allowing you to easily drag-and-drop the social features that you want into your theme's widget content areas.

• Recommendations
• Recent Activity
• Like Box
• Like, Send, and Follow buttons.

Download the plugin at http://wordpress.org/extend/plugins/facebook to get started!

Once you've enabled "Publish to author's Timeline", you will need to set up the publish action in your Facebook application settings to take advantage of improved distribution through Open Graph publishing including the ability to mention friends and pages and mark a new story as explicitly shared.

Create a Facebook application and Open Graph action-object pair

• Go to http://developers.facebook.com/apps.
• Select your existing Facebook application or create a new application for your WordPress site or network.
• Click 'Open Graph' link in the sidebar.
• Click 'Create New Action Type'. You should see the dialog below.
• Enter 'publish' and 'article' by selecting each from the autocomplete field as you type. Click "Get Started" to save your work.

In order for posts to authors' Timelines to be public, You will need to add an application description, upload a logo, and submit your newly created Open Graph "publish" action for approval before posts to authors' Timelines will appear to the public.

Fill in your Facebook application details in the "App Details" section of the Facebook application editor. Add your site title, description, links to your site, and other information you have available. Add icons for your site for display the permissions dialog shown to your site authors. If your site does not have a unique icon or branding you might consider using a generic WordPress logo of equal height and width.

Open your Facebook application's Open Graph dashboard (Open Graph -> Dashboard). You should see a "Publish" action type. Submit your action for approval. Select the following action properties:

• User Messages - attach a personalized message to each new post
• Tags - enables mention tagging of Facebook friends and pages
• Explicitly Shared - allows a post authored from the WordPress edit screen to be marked as explicitly shared to Facebook

Add Facebook application credentials to WordPress site

Copy-and-paste your Facebook application identifier and application secret from the Settings -> Basic section of your Facebook application editor into the "General" Facebook settings page in your WordPress administrative interface (wp-admin/admin.php?page=facebook-application-settings). Navigate to the Facebook settings page by clicking on the Facebook menu item in your WordPress administrative interface.

Associate your WordPress account with your Facebook account

New submenu options should appear under the Facebook menu item after you have successfully saved your Facebook application information. Select the "Social Publisher" submenu item to view publishing options. (wp-admin/admin.php?page=facebook-social-publisher)

Associate your Facebook account with your WordPress account by selecting an appropriate Timeline or Page link on the Social Publisher Settings page. A Facebook dialog will ask for permission to share your basic Facebook account data with the Facebook application associated with your WordPress site. You will also be asked to optionally grant permission for your site's Facebook application to publish to your Facebook Timeline and/or Facebook page on your behalf. Additional site authors may follow the same flow (if the author has manage_options capability on the site) or associate an account from his WordPress profile editor (displayed to WordPress users with edit_posts capability).

Publish a new post from your WordPress site. The post should appear on your timeline, linked from a status box above the post editing area after successfully publishing. You can delete the test post from Facebook and your site.

Submit your Open Graph "publish" action for approval.

You're finished!

All the source code for the plugin has been open sourced and made available on our GitHub repository "Facebook plugin for WordPress GitHub repository". If you have experience developing for WordPress or Facebook and are itching to implement a feature, open up an issue against the repository where we can discuss it. Once your code is ready, submit a pull request from your branch and reference the issue. More details on that are available from GitHub's documentation.

Note that all contributors must agree to and sign the Facebook Contributor's License Agreement prior to submitting Pull Requests later published by Facebook under the GNU General Public License version 2 or later. We can't accept Pull Requests until this document is signed and submitted. See CONTRIBUTING.md in the GitHub repository for more details.