Ultimate Facebook

The complete solution for seamless Facebook integration and mirrored social sharing on WordPress.

Version 2.8.2

  • New: Import nested replies from Facebook
  • New: Number of User accounts fetched from Facebook, Added filter `wdfb_user_accounts_limit` to specify a custom limit


Version 2.8.2
  • New: Import nested replies from Facebook
  • New: Number of User accounts fetched from Facebook, Added filter `wdfb_user_accounts_limit` to specify a custom limit

  • Fixed: Import comments for new FB Graph API

  • Fixed: The auto posted post title contained HTML tags
  • Added: Primary User so FB auto post accounts come from him only
  • Removed: 'login_form_bottom' filter that was causing a duplicate FB login button

Version 2.8.1
  • Added: Editor can chose the FB account he is publishing in
  • Added: Publishing Title, Account and Publish are saved when the post has a draft status

  • Fixed: Permissions issue for new APP
  • Fixed: Album selector not working
  • Fixed: Crop Image, if enabled in album widget/shortcode
  • Added: One CLick Registration to signup
  • Removed: Facebook Recommendation, FacePile, Activity Feed (Discontinued by Facebook)

  • Fixed: Updated permissions required for Auto Posting

  • Fixed: Event timezone field not being retrieved
  • Fixed: Use post content for description instead of blog description in Facebook autoposting
  • Fixed (Important - Security): Fix query argument escaping to avoid XSS vulnerability

  • Fixed: Comment author Facebook URL
  • Fixed: Network Settings - Override all blog settings and Preserve individual blog api settings

  • Fixed: replaced comment_text filter with get_comment_text to fix notice and warnings
  • Fixed: Fixed recent comment widget avatar checkbox in backend
  • Fixed: Comments order in recent comment widget

Version 2.7.9
  • Updated: Album widget styling change ( check changes before updating on live )
  • New: Option to display photo description in Facebook albums
  • New: Validate Facebook APP Secret with APP ID
  • New: Allow users to display album pictures in widget using thickbox
  • New: On uninstall : Delete API settings and default tokens list, remove comments import cron
  • Fixed: Album not displayed if no limit is specified in shortcode
  • Fixed: User id and token issue ( Albums not showing up, due to invalid token )
  • Fixed: Permissions logic
  • Fixed: Disable signup using Facebook if registration is disabled on site
  • Updated: Facebook registration plugin expiry notice

Version 2.7.8
  • New: Skip autopost option for individual posts
  • New: 'wdfb-opengraph_apply_the_content_filter' filter added for developers. Returns a boolean.
  • Updated: Manual Publishing on Facebook for posts
  • Fixed: Warnings

Version 2.7.7
  • 27th October 2014
  • - Fixed: Autoimport for comments
  • - Fixed: Character encoding issue due to emojis
  • - Fixed: Autoposting for posts published using Ajax
  • - New: Allow publishing old posts in editor mode

Version 2.7.6
  • New: Added support for importing emoji's in Facebook comments
  • New: Support for bigger images in Autoposting
  • Updated: Facebook SDK, notification for captcha error on registration page
  • Updated: Refresh auth tokens code to allow changes in API and user details
  • Fixed: Select album for Album widgets
  • Fixed: Color Scheme setting for comments
  • Fixed: Batch query for album photos

Version 2.7.5
  • Fix - Album shortcode using wrong album id

Version 2.7.4
  • Fixed: Facebook login form not hooked in wp_login_form

Version 2.7.3
  • New: 'wdfb_show_comment_form' Filter to turn off Facebook comment form for a specific post id
  • Fixed: Album Shortcode not displaying photos
  • Fixed: Facebook comment form not displayed if Override WordPress Settings is enabled
  • Improved: Registration Page template ( Added hooks before and after Facebook registration form )

Version 2.7.2
  • Updated: [wdfb_events] shortcode and events widget

Version 2.7.1
  • Updated code to support facebook API v2
  • REMOVED: Facebook EVENTS and NOTES support
  • Fixed: Facebook Registration Iframe src
  • Validate email for Facebook registrations
  • Updated permission list
  • Fixed warnings, fixed js reload on settings page

Version 2.7
  • Added author notification for Facebook comments.
  • Added new options for permissions selection.
  • Improved permissions selection.

Version 2.6.6
  • Fix for mixed content issue on registration page.
  • Fix for imported event timezones.
  • Better "more" tag handling in content publishing.
  • Added content filtering for image content.

Version 2.6.5
  • Settings for archive pages buttons.
  • Support for events limiting.
  • Fix for redirection issues with certaing parameters.

Version 2.6.4
  • Fix for scheduled semi-auto publishing.
  • Fix for localized IFRAME buttons.
  • Fix for buttons with more activities.
  • Added photo title support in album shortcode.

Version 2.6.3
  • Added per-blog cache operations area.
  • Added color scheme settings box.
  • Wrapping the base Facebook exception class.
  • Ensuring brief logger messages.
  • Added optional XFBML option for BuddyPress activities button.

Version 2.6.2
  • Network connection data loading.
  • Stripping extra markup.
  • Using internal flag to make sure the scripts are loaded in time.

Version 2.6.1
  • Async loading and new script placement options.
  • Allowing responsive FB comments hack.
  • Network settings fix.
  • Showing stored post title for scheduled posts.
  • Added optional activity feed update on registration.

Version 2.6
  • Added option for BuddyPress groups info sync, minus avatar.
  • Added more hooks.
  • Added custom post type support for comments import.
  • Fix for comments import issues.
  • Fix for filter nesting check.
  • Allowing admin nag skips with a define.
  • Account limiting via define flag.
  • Trumping WordPress discussion settings by default.

Version 2.5.4
  • Added the Facebook avatars override option.
  • Added paged setting saves for large networks.
  • Added generic access token fallback for events graph api calls.
  • Fix for prefiltering checks.

Version 2.5.3
  • Recognizing Jetpack-encoded shortlinks.
  • Hierarchical data imports.

Version 2.5.2
  • Fix for overzealous avatar override.
  • Fix for non-BuddyPress sites tooltip help item.
  • Added feed fetching error log entry and url-to-post ID map wrapper.
  • Branching out for comments import.
  • Added pre-initialization FB curlopts filtering.

Version 2.5.1
  • Multi-values BuddyPress fields query returns only top-level choices.
  • Exposing per-field WP profile syncing filter.
  • Events widget reverse order setting.
  • Fix for OpenGraph custom header increments.

Version 2.5
  • Fix for BuddyPress heuristics.
  • BuddyPress activity native button support.
  • Allowed footer hook in a define, for WP-incompatible themes.
  • Added HTML5 vs XFBML tag format dispatcher.
  • Added auto-login on registration option.

Version 2.4.1
  • Fix for BuddyPress activity items logic in OpenGraph url.
  • Fix for cursor-based paging items fetching through batch requests.
  • Added color scheme selection for Facebook Comments.

Version 2.4
  • Deprecated simple redirection logic.
  • Added optional exact redirect url fallback.
  • Resizing avatars to thumbnail size, added optional auto-crop.
  • Activity updates publishing to personal and sitewide feed.
  • Optional identity renewal link.

Version 2.3
  • Added OpenGraph metabox and augmented per-post overrides.
  • Central OpenGraph property handling.
  • Exposed more filters.

Version 2.2.3
  • Fix for limit attribute in albums shortcode.
  • Fix for protocol mismatch in mixed HTTPS/HTTP environments.

Version 2.2.2
  • Using bundled datepicker in events widget.
  • Replacing deprecated calls, typo fixes, silencing notices.
  • Added filtering for login redirection URL.
  • Added macro expansion for URL redirection.
  • Added avatar size attribute to connect shortcode.

Version 2.2.1
  • Fix for permissions check procedure.
  • Fix for button width issue.
  • Silenced some debug mode output.

Version 2.2
  • Fix for long-term tokens handling.
  • Fix for autopost warnings.
  • Filtering profile name, with sensible default.
  • Added LikeBox widget filterable hiding logic.
  • Added Facebook avatar size mapping to admin gravatar filters.
  • Added registration postprocessing filter.

Version 2.1
  • Deprecated offline_access.
  • Fix for title OpenGraph issue.
  • Fix for plugin conflict.
  • Added new permissions level (extras).

Version 2.0.1
  • Improved OpenGraph tags generation.
  • Improved Facebook album photos shortcode handling.
  • Recalculating necessary widths for Like buttons.
  • Added metabox override caching for delayed autoposting.
  • Fix for https issues with linked resources.
  • Fix for address mapping.
  • Fix for activity feed widget.

Version 2
  • Added contextual help and pointer tutorial.
  • Added album shortcode.
  • Improved settings.
  • Improved performance.

  • Silenced debug output.

Version 1.6.2
  • Workaround for late cookie setting issue.

Version 1.6.1
  • Added locale support to widgets.
  • Fix for login issues under certain conditions.

Version 1.6
  • Added recently imported comments widget.
  • Switched to new method of permissions requesting.
  • Added an option for making a Facebook account an absolute requirement.

Version 1.5.1
  • Added event title as link to event on Facebook.
  • Added filtering to OpenGraph image finding results.
  • Replaced images with better compressed ones - props KFUK-KFUM

Version 1.5
  • Fix for registration URL.
  • Fixes for script elements.
  • Styling fixes.
  • Added support for additional OpenGraph headers.
  • Allowed for registration page templating - props KFUK-KFUM.
  • Better optional registration button placement on single sites - props riyaku.
  • Events sorting direction added to shortcode.

Version 1.4.3
  • Fix for Facebook registration form.
  • Fix for uniform options propagation to registration widget and page.
  • Added registration options filtering mechanism.

Version 1.4.2
  • Fix for FB buttons with nested posts.
  • Fix for autposting escaping and stripping.
  • Fix for registration redirection issues with BuddyPress 1.5
  • Support for frontend posting posting plugins.

Version 1.4.1
  • Fix for BuddyPress avatars import.
  • Added forced Facebook locale settings.
  • Added optional login redirection settings.

Version 1.4
  • Merged App ID and API key fields.
  • Fixed autoposting on Facebook for scheduled posts.
  • Fixed conflict with single-line oEmbeds.
  • Added granular permissions framework
  • Added Activity Feed widget.

Version 1.3.1
  • Fix for publishing posts without images.
  • Fix for default Likebox height.
  • Updated posts not published on FB will remain unpublished on subsequent updates - unless overriden manually.

Version 1.3
  • Added error logging for Facebook publishing.
  • Added height attribute for the Like Box widget.

Version 1.2.2
  • Fix for importing and displaying Facebook avatars.
  • Fix for post as page hangups.
  • Fix for not fetching pages info bug
  • Added new optional setting for linked account info fetching
  • Added trimming app id and secret key to prevent possible whitespace issues.
  • Added async mapping of account IDs to names (Comments Import)

Version 1.2.1
  • Added Facebook Connect shortcode.
  • Optional permission check notice auto-updated.
  • Fix for comments notices.
  • Applied multiple app security patch.

Version 1.2
  • Added permission granting improvement.
  • Fix for workarounds for default certificate usage.
  • Fix for fallback image on home page first.
  • Fixes for undefined variables.
  • Fix for New blogs to be public by default.
  • Fix for style injection conflict with gridmarket.

  • Switching between IFRAME/XFBML buttons on front page.

Version 1.1.4
  • Fix for front page Like buttons

Version 1.1.3
  • Fixed site home OpenGraph for moved root installs.
  • Added image cropping option to Albums widget.

Version 1.1.2
  • Fix for BuddyPress profile fields discovery in multidb setups.

Version 1.1.1
  • Forcing cookie cleanup after SDK.

Version 1.1
  • Improved new username creation.
  • Post to Facebook metabox is now optional.
  • Added notification in metabox for already published posts.
  • Added "On Facebook" status columns to post/page management list.
  • Optional register button looks a bit more like a button now.
  • Made CAPTCHA image optional on registration.
  • Optional preventing site admin access to plugin settings.
  • Improved login/logout process.

Version 1.0.9
  • Fix for unchecking "post as page" checkbox issue.
  • Fix for posting as page and gathering API info on subsites.
  • Avatar importing for BuddyPress defaults to a large picture.

Version 1.0.8
  • Added options for skipping particular accounts for comments import.
  • Fixed publishing issues with remote posting.
  • Fixed cache warnings.

Version 1.0.7
  • Added "show on front page" option for Like buttons.
  • Added publishing to Facebook page *as* page.
  • Improved error handling and user notification for Facebook publishing.
  • Fix for Membership shortcodes.

  • Fix for styles and scripts loading on admin pages.

Version 1.0.6
  • Added events shortcode attributes, "starting_from" and "only_future".
  • Added custom hook field for Facebook Comments.
  • Added support for OpenGraph type property.
  • Fixed the wording for Autpost settings.

Version 1.0.5
  • Added single-click registration option. If this is enabled, "Login" button will double as a single-click register button too.
  • Added basic WP avatar support to Connect widget.
  • Full registration allows for site creation, if enabled in network options.
  • Added option for hiding API credentials from sub-site admins.
  • Post length quickfix for autoposting.
  • Allowing one dimension to be omitted in Facebook Album widget, so the images are properly scaled.
  • Added additional settings for Facebook Comments.
  • Added optional URL attribute for the Facepile widget.

Version 1.0.4
  • Added filtering past dates to Facebook Events widget.
  • Added some more fields to profile import.
  • Fix for registration button at login in single site.
  • Fix for shortcodes registration, so Membership pick them up.
  • Fix for OpenGraph to play nice with Membership.

Version 1.0.3
  • Fix for registration listener.
  • Facebook Connect widget fix: unbinding the click handlers before binding our own.
  • Added datepicker to Facebook Events widget.
  • Updated strings for l10n.
  • Added more strings for translation.
  • Applied grola's fix for fetching the first post image.

Version 1.0.2
  • Added "forced" attribute to FB Like button: overrides post types negative filter.
  • Changed targeting for Facebook Connect widget tab triggers to be more precise.
  • Added class name to Like button wrapping div, for styling.
  • Added an option for overriding the WordPress discussion settings.
  • Added date threshold parameter for Facebook Events widget.

Version 1.0.1
  • Fixed the bug with saving settings.
  • Facebook albums: fetching all associated albums for current user (including pages and profile albums).
  • Fix for redirection with multiple login buttons on page.

Version 1
  • Initial Release

Version 1-BETA-2
  • Second BETA release.

Version 1-BETA-1
  • First BETA release.
Try Ultimate Facebook today!
  • One plugin for every Facebook integration
  • Autofill user info with Facebook profile
  • Autopost to wall, page, event or notes
  • Facebook OpenGraph Integration
  • Login using Facebook credentials
  • Share Facebook albums
Ultimate Facebook comes FREE with your WPMU DEV Membership GET Ultimate Facebook FOR FREE Free trial & pricing info
  • "The Ultimate Facebook plugin eliminates the use of multiple plugins and takes care of everything, including posting updates on a Facebook page wall."
    Soumya Pratihari
Downloads 127,902 Compatibility WordPress 4.6.1Multisite 4.6.1BuddyPress 2.7.2 Version 2.8.2 - Changelog - Translations

"The Ultimate Facebook plugin eliminates the use of multiple plugins and takes care of everything, including posting updates on a Facebook page wall."

Soumya Pratihari

Ultimate Facebook packs full Facebook integration for WordPress into one simple plugin.

Login with Facebook, autopost, comment mirroring, one-click registration, like and share buttons, open graph, use Facebook avatars, share albums, display recent Facebook activity feed and a heap of widgets.

It would take over a dozen mix-n-match plugins to get this kind of Facebook integration anywhere else.

Automatically share new posts on your blog to Facebook.
Automatically share new posts on your blog to Facebook.

Autopost and Comment Mirroring

Autopost to your wall or page for better social marketing without spending any extra time on Facebook.

Merge comments made on Facebook with your comment thread and share a feed of Facebook comments.

Allow users to register and log in with their Facebook account.
Allow users to register and log in with their Facebook account.

One-click Signup and Login

Let users register, use their Facebook avatar and logon to your site with a click. Add a Login with Facebook button to the login page.

Get better contact information, build your user base and eliminate lost password support tickets.

Widgets make it easy to integrate Facebook into your site.

Widgets and Shortcodes

5 frontend widgets, 1 dashboard widget and an entire shortcode catalog seamlessly integrate Facebook with any WordPress theme.

Share albums, ‘Like’ buttons, events and registration information anywhere.

For help and information on installing plugins you can view our Installing WordPress Plugins Manual.

Important: Support for Events & Notes has been discontinued by Facebook. They have also changed how Apps are created. Please see the Recent Changes section at the bottom of this page for details.

Before you can use the Ultimate Facebook Plugin on any site you will need to create a Facebook Application and use the API and Secret Key from that Application to activate the plugin. If you are not familiar with the process see this fabulous guide by one of our members.


Check out our introductory video to help get you started with Ultimate Facebook.

You can watch the entire series in this playlist on YouTube.

Select the “Playlist” at the bottom of the video frame for more videos, or choose the videos from this list here:

  1. Introduction to Ultimate Facebook
  2. The Front-End Interface
  3. How to Create a Facebook App
  4. Configuring the Settings
  5. Like Button and Open Graph Settings
  6. Facebook Comments and Autoposting
  7. Using Shortcodes
  8. Ultimate Facebook Widgets
  9. Multisite Settings
  10. Conclusion and Thank You

Network Settings

You will need to Network Enable Ultimate Facebook if you are using a Multisite Install, you will see a new menu appear on the Network Admin Dashboard once you do so.

If you are using Ultimate Facebook on a Network you’ll want to address the following settings first in the Network Admin (if you are not using it on a Multisite Install you can skip on down)

Network Settings

These check-boxes are your options that will determine if your subsites will use the API information you set on the Network Admin Ultimate Facebook Settings. You will need to pay special attention that you enable your sites to use the Network API in the Facebook API Settings section if you do decide to force or enable the option.


Plugin Settings

Once you have successfully added your API and Secret Key you will see a green check above the entry boxes for the keys and a note of success. Should there be an issue with your entry or lack of connection the green check will be a red “x” and the note will change.


Once you click “Save” or “Move on to the Next Step” you will see the next Meta box open for Granting Extended Permissions. Extended Permissions gives the plugin permission to access your account upon your command even when you’re not around (like when you want to Auto-Post). You don’t need to do anything special for this part, just click the button to “Grant Extended Permissions”. You’ll see a note of success after this has been completed successfully.

Extended Permissions

Facebook Connect

Click to go to the next step. You are presented with a Facebook Connect Settings menu. Here you will decide if and how your users will use Facebook to connect to your site.

Going through the options you’ll see the Mapping Feature, this will allow you to map the signup info into the User Profile of the registrant. This will also work with BuddyPress enabled and will map to any Custom Profile fields you have created in BuddyPress. There is no special option to use BuddyPress here, the plugin will detect if BuddyPress is active or not.


The Identity Renewal option will give your users the option to Map their info to their site profile (with or without BuddyPress) on demand.

Once you’re done with the Facebook Connect settings you can move on by clicking Save.

Facebook Like/Send Button

Next up is the Facebook Like/Send Button settings. Here you can determine what, if anything, you want folks to be able to “LIKE” on your site or Send to Facebook. By default you the Like and Send will show on all posts and pages (including Custom Post Types) so you’ll need to check the type to exclude if you want to remove it from a particular page.


You will see the option to manually position your button with the shortcode [wdfb_like_button]. You can find more information about the shortcode by clicking through Facebook>Shortcodes. Once Done, click Save and move on!

Facebook Open Graph

Moving along to Facebook Open Graph. Here you can control what it is that folks see when others Like stuff on your site or Send said stuff to Facebook. You need to choose whether to enable it by checking the box, then set your image url’s accordingly.


If you want to add more information you can add your own OpenGraph items. Facebook has a list of Bult-In Object Types you can use here.

You can visit the Facebook Technical Guide to Open Graph to learn more.

You will also notice an Open Graph meta box on your Post Editor Page, for ease of using custom Open Graph Settings per post.


Save or skip to go to the next meta box…

Facebook Comments

Facebook Comments allows you to import comments made on the posts that you share to Facebook. It will only import the comments from Facebook to your WordPress, not from WordPress to your Facebook.

Note you can reverse the checking logic for your import list when selecting which items to skip importing from. Checking the reverse logic box means you’ll check those that you want to import from, not those you want to skip importing from. Also note “Override WordPress discussion settings” this will override ANY WordPress settings you have for comments and make Facebook Comments your exclusive comment item.


AutoPost to Facebook

Last but not least, Auto Post to Facebook gives you the option to have every post on your site go directly to Facebook. This requires Extended Permissions.

Just select the location and user for each type of item listed and the resulting posts/pages/media/events will all be sent accordingly.

You will also find two handy items here: 1 ) Show post Facebook status column: this gives you a status on if the post has been sent to Facebook. You may need to change the Screen Options to make sure you can see this column on the Posts Menu.


2) Do not allow individual posts to Facebook disables the option to send an individual post to Facebook in the Post Editor.


If you do NOT have AutoPosting enabled your users will see the following in the Post Editor underneath the content meta box. Checking this option will remove this box for your users, but not the Admin.

Individual Posts

The remaining menu items are:

Widget Pack:

checking any of these will enable a new widget in your Appearance>Widget menu

  • Facebook Connect
  • Facebook Albums
  • Facebook Facepile
  • Facebook Like Box
  • Facebook Recommendations
  • Facebook Activity Feed
  • Facebook Recent Comments
  • Facebook Dashboard Widget (for users to grant extended permissions)

Flexible options for displaying. Use the parameters provided to display

  • Like Button
  • Connect with Facebook
  • Facebook Albums
Error Log:

Lists any errors encountered by the plugin. These are especially helpful when troubleshooting and should be referred to and sent along with any other relevant information when submitting a support ticket.

Recent Changes


From version 2.7.1 of Ultimate Facebook, autoposting of events & notes is no longer available. This is due to changes in the Facebook API. More information can be found in their changelog here: https://developers.facebook.com/docs/apps/changelog

Creating your app

Although Facebook has changed the way apps are handled, you do not need to submit an app for approval in order to use it with our Ultimate Facebook plugin.

When creating your app, under “Settings”, simply select “Website” as the platform, enter your App Domains (domain.com) & Site URL (http://domain.com), and your contact email. Then under “Status and Review”, make it public.

UltimateFacebook App Settings

When creating your app, you may get a warning like the one seen in the image below. One of the devs over at Facebook has assured us that you can safely ignore it, as you are the only one actually using the app.

Ultimate Facebook App Warning

Ultimate Facebook Features

Complete Facebook integration for WordPress.

  • Use Facebook avatars
  • Autofill user info with Facebook profile
  • Autopost to wall, page, event or notes
  • Previous post import
  • Show comments made on Facebook
  • Like/Share buttons
  • Facebook OpenGraph Integration
  • Facebook Connect
  • Share Facebook albums
  • Like box widget
  • Recent comments feed
  • Dashboard widget
  • Multisite ready