Simple Facebook Connect

Hey, have you tried the Official Facebook Plugin yet? Maybe you should give that one a shot before trying this one. Simple Facebook Connect is a framework and series of sub-systems that let you add any sort of Facebook functionality you like to a WordPress blog. This lets you have an integrated site without a lot of coding, and still letting you customize it exactly the way you'd like. After activating the plugin and setting up a Facebook Application for your site, you can enable individual pieces of functionality to let you integrate your site in various ways. The plugin is also a developer framework for both the Graph API and the Facebook Javascript SDK, allowing you to make other custom plugins or theme modifications with much less code. The basics of Facebook integration are already handled by the core plugin, so just a few function calls can be made to contact Facebook systems and connect with them in various ways. Requires WordPress 3.0 and PHP 5.

• Enables your site to connect to Facebook with JS SDK
• Implements OpenGraph tags, entirely automatically
• Comment using Facebook credentials (with Facebook avatar support)
• Automatically Publish new posts to Facebook Profile or Application or Fan Page
• Manually Publish posts to FB Profile or Application or Fan Page
• Integrate comments made on Facebook back into your own site
• Login with your Facebook credentials, optionally using Facebook avatars instead of Gravatars
• New user registration with Facebook credentials (using the Facebook Registration Authentication system)
• Facebook Photo Album integration in the Media uploader
• Like Button and shortcode
• User Status Widget and shortcode
• Live Stream Widget and shortcode
• Fan Box Widget and shortcode
• Fan Count Chicklet and Widget
• Activity Feed Widget
• "Share" button and Shortcode (reworked version of Like button, as Share button is no longer supported by Facebook)

If you have suggestions for a new add-on, feel free to email me at otto@ottodestruct.com . Want regular updates? Become a fan of my sites on Facebook! http://www.facebook.com/ottopress http://www.facebook.com/apps/application.php?id=116002660893 Or follow my sites on Twitter! http://twitter.com/ottodestruct

1.5

• Fix for broken Like button due to Facebook implementing breaking changes without telling anybody about it in advance.

1.4

• Corrected some internationalization issues
• Fix for global $post in meta being changed (caused issues with some themes)
• Youtube handler updates
• Video display on publish fixes

1.3

• Dump application wall publishing support.
• Move help info into separate file
• Fix image handling when auto or manually publishing some videos
• Yet another logout issue. FB sure makes it hard to disconnect from them when you want to do so.
• Minor improvements to photo module.
• Minor bugfixes.
• Height/width fix for video support
• Better manual excerpt handling
• Fix problem relating to FB's new access token requirements

1.2

• Lots of minor bugfixes
• Logout JS fix for edge cases. Props johnkleinschmidt.
• Updated FB schema URIs to be compliant with the latest spec
• Locale handling improvements
• Vast changes to OpenGraph support. Now supports audio, various video sites, etc. Media handling migrated to sfc-media.php for easier expansion in the future.
• Registration improvements
• Support website linkage properly in comments (FB does silly things here with multiple websites)
• Publish using message fields to get greater edgerank for auto posts
• Publish using "link" feed type, since edgerank seems to be improved in this way (use SFC_PUBLISH_ENDPOINT define if you want to change it back to "feed")
• Help Screen additions, along with a dismissable WP 3.3 pointer to point you to them
• Permissions fixes for publishing
• Text Domain loading fixes for translations
• Made modules generic for easier additions in the future and by separate plugins
• Improved asyncronous JS loading, to reduce conflicting code cases
• Added channel URL support (should reduce extraneous log of FB requests, and eliminate frame-busting issues)

1.1

• OAuth 2.0 upgrade. Signed requests are now used exclusively.
• Added SFC_LOCALE define to allow users to override the FB Locale string in the wp-config.php file.
• Filter sfc_register_fields added for adding new fields to the registration screen.
• Comments init script added back to allow anon FB "logged in" users to show up automatically in comments form
• Comments fixed for OAuth 2.0 issues
• Comemnts share fixed to have Read Post action links and comment text as FB post content
• Plugin screen action links fixed
• Slightly better publish permissions interface (auto-submit on button click)
• Caption bug in publisher fixed (published items won't show the domain name as the caption anymore)
• SSL problems fixed for hosts that had them
• Activity feed widget fix (FB made a non-backward compatible change to the XFBML code)
• Locale issues worked around. Non-recognized locales will get en_US locale. Future versions may fix this better, but this will at least let the plugin function.
• Swapped AppID/Secret field order to be more like how FB displays them
• sfc_is_fan function fixed and re-enabled
• Image and Video meta scanning improved. Still has minor problems with YouTube HTML5 capable iframe code, however works fine with most oEmbed code.

1.0

• Entirely rewritten plugin.
• Graph API support.
• OpenGraph support.
• FB JS SDK support.
• Registration model changed to use FB's new registration system.
• Meta handling improved and centralized.
• Publish reworked (app auto-publishing works now!)
• Comments reworked (sharing comments to Facebook now happens entirely in the background)
• Share removed and replaced with modified Like button (FB Share is no longer supported by Facebook, and incompatible with newer code)
• "Send" option now available with Like button.
• NEW Photo integration module
• Widgets reworked
• Deprecated widgets removed

0.26 (never released)

• SFC-Login: Profile connection fix
• SFC-Base: SSL admin fix (thanks to jwz)
• SFC-Publish: Squeeze out max possible number of chars (jwz)
• SFC-Publish: More filters on more things for more customization potential
• SFC-Register: Remove admin nag for fb connected users (hattip: Stephan Muller)

0.25

• Fix UTF-8 encoding problem for non-English publishing.
• Add FB Icon to username for FB connected users

0.24

• Fix missing xd_receiver URL.

0.23

• i18n thanks to Burak Tuyan.
• New filter: sfc_img_exclude will let other plugin authors add their own image classes to exclude from the automatic image finder for share and publish and such.
• sfc_like_button now supports a url parameter to add a like button to a specific URL, like the homepage.
• Publish now sends up to 1000 chars from the post to Facebook. Thanks to jwz for the patch.
• Publish now gets images correctly in more cases. Thanks to jwz.
• If you enable login avatars (by uncommenting that code), it will show them for comments now too.
• xid elimination
• Custom Post Type support for automatic publishing (any CPT with public=>true will get auto-published)
• Contextual help added
• Improved error messages
• Numerous optimizations and bugfixes

0.22

• Error due to bad code release. Do not use.

0.21

• The main SFC base plugin now has a proper and working check for PHP 5 only systems. I think. I hope. I'm sick of people talking about "error on line 210" or what have you. Read the requirements, folks!
• The base plugin now has ways to pre-define the main four settings (api-key, app-secret, app-id, and fanpage-id). You can add defines for each of them into your wp-config with these names: SFC_API_KEY, SFC_APP_SECRET, SFC_APP_ID, and SFC_FANPAGE. All of them are optional, and when defined they will no longer show up on the settings page. This may be useful for people using the multi-site capabilities of WP 3.0 and wanting to use a single application across domains. You can also define SFC_IGNORE_ERRORS to "true" to force the settings page to not display the "Incorrect URL" error. This is necessary for multi-user systems using a base domain application across multiple subdomains, as the error checker cannot account for that.
• Facebook avatars now use the Graph API for displaying. This eliminates the fb:profile XFBML tag and makes it back into a normal IMG tag, like Gravatars and Twitter avatars are. This should remove styling problems people had, though they are still classed as "fbavatar" if you want to style them differently. Side note: Because of this, the Facebook logo on these avatars is now gone. Graph API has no way to force the logo.
• Several like button options added.
• Remove minimum width of Fanbox.
• More options in activity feed widget.
• Assorted bug fixes.

0.20

• Added Activity Feed widget.
• Minor update to fanbox. functions get_sfc_fanbox() and sfc_fanbox() are now available for direct theme usage.
• Added lots more og: meta data. Facebook added an "article" type, specifically for blog posts and other such similar things. This fixes the every-post-becomes-a-fan-page problem.
• Minor wording changes.
• Minor bugfixes.
• Fix for login for people with high FB ID numbers. Maybe. I can't test this patch, but somebody told me it worked.
• Changed the init call to force email request on connection. This may solve some problems for people unable to comment and such.

0.19

• Added og:site_name to base plugin, for OpenGraph info.
• Added fb-like shortcode.
• Offline permissions fix, assorted thumbnail handling fixes.

0.18

• Added Upcoming Events widget. This will show your upcoming events from Facebook. For a user, it shows events that person has been invited to. For a fan page, application, or group, it will show events created by that entity.
• Added Like button. Will be reworking entire plugin soon for FB's new OpenGraph support. Expect that to be a 1.0 release.

0.17

• Add error checking for bad API and similar inputs which caused a Facebook API error. The error from FB is now echoed and handled properly.
• Add Locale support. If your WordPress is in a locale, then that locale will be passed to Facebook's Javascript to make the default text appear in that language. Logged in users will still see the text localized to their own lanaguage.
• Support for WordPress 3.0. Works with Multi-Site, but it must be configured separately for each individual site, it will not work sitewide. Sitewide coming soon for a small percentage of configurations (it's only possible if all sites are on the same domain, not in multiple domains).
• Fixed image handling in Share and Publish plugins (requires WP 3.0 kses fixes for it to really work).
• Facebook decided to remove email_domain without telling anybody in advance. That's now fixed.

0.16.1

• Missed a trailing slash issue in 0.16.

0.16

• Error handling on login now tells you "Facebook user not recognized" if you try to login with a FB user that isn't attached to a WP user.
• Added Facebook Platform Status Feed on config page. This might help to tell users when Facebook is having issues, hopefully to make them stop emailing me every time Facebook's API servers have another hiccup.
• Rewritten javascript for Comments plugin. Now the Sharing is optional with a checkbox (per FB's new guidelines) and the comment submission should be more bulletproof (for browsers that don't do Javascript quite properly... I'm looking at you Safari and Chrome!).
• Fixed avatar styling issues. If you had already made changes to your CSS to account for the avatar divs, then those are now gone and the avatar class is properly on the IMG instead. If you do need special styling, use .fbavatar to refer to facebook avatars only.
• Fixed minor share button problem with "method 2".
• Main plugin now does some sanity checking for common errors.

0.15

• Script and style tags now get stripped properly when publishing.
• Fanbox widget now has a height option.
• The Connect Widget will now actually log a user into WordPress via redirecting them to wp-login.php. Login plugin must be activated for this to work. This can also trigger Register plugin, if that plugin is activated. User will be redirected back to current page, but with logged in cookies set.

0.14

• Fanbox had an error in 0.13.
• Fixes publish error for people using themes that don't support post thumbnails

0.13

• Bug fix: Publish and Share could miss images in the content sometimes.
• Minor speed improvements to Fan Box CSS handling.
• Automatic Fan Page publishing now tries to force privacy setting to "Everyone", to eliminate issues with invalid privacy settings making posts not visible to Fans.
• Post thumbnail support in Publish and Share plugins.
• Minor Fanbox custom CSS improvement.
• Publish won't send mere edits of already existing posts to Facebook now.
• Changed comment plugin to use newer translateable Connect with Facebook button.

0.12

• Fan Box custom CSS support.
• PHP 5 version checking as a base requirement. No way around this, Facebook's PHP libraries are PHP 5 and up only. PHP 4 is just dead.
• Login and Comments plugins add Facebook person extension data to Atom feeds, based on Friendfeed discussion.
• Additional error checking to try to prevent odd PHP errors whenever Facebook's API goes wonky.
• Login now has an option to prevent people from disconnecting their WP and FB accounts. Add a "define('SFC_ALLOW_DISCONNECT',false); to your wp-config to prevent disconnection of accounts.
• Fixed logout bugs in Login plugin. Logout works correctly now.
• SSL Support. The base plugin now loads the scripts correctly for SSL connections. No guarantees, but it should work for SSL Admin users now.
• Added "Find us on Facebook" button in widget and shortcode form. Button links to your main Facebook App/Fan Page wall. Use [fb-find] in posts for shortcode.
• Automatic publishing to Fan Pages works now. Automatic publish to Application Walls does not work yet, due to Facebook bugs.
• Register plugin now has a "one-click" mode, to skip all prompting. Add "define ('SFC_REGISTER_TRANSPARENT', true);" to your wp-config to enable this mode. WARNING: May be buggy, not recommended for production sites.
• Minor speed enhancement that should fix some of the delays people see when logging in with FB on their sites.
• Height support in Fan Box shortcode.

0.11

• Fix html entities in publish dialogs.
• Publish plugin now supports automatic publishing! Look on the SFC settings page to grant permissions and enable automatic publishing.
• Real email address support in comments and register. You need to fill in the "Email Domain" on the FB Applications tab to be given a proper choice.
• Register plugin is now working. Requires login plugin to be enabled first.
• Publish plugin is now smarter and won't show you publishing buttons if you're not connected to Facebook.
• Published posts now also have a See Comments link on Facebook.

0.10

• Fix quoting problems with publish and comments, for stream publishing (quote marks in titles and such shouldn't cause problems any more)
• Comment email improvement: If you have the "Comment author must fill out name and e-mail" checked in Settings->Discussion, the comments plugin will now ask the Facebook user for Permission to email that user. This will allow things like replying to the comment emails and Subscribe to Comments and similar plugins to work with Simple Facebook Connect. Yes, you can actually reply to the Facebook commenter when their comment gets emailed to you, and the reply works. Tested, proven.
• Comments plugin now uses comment meta table for storing FB user id, making for much quicker avatar generation. Avatars used to be built by getting FB UID from the email field, which took time for regex parsing. Old avatars will be auto-converted to new method when displayed. This also has an advantage in that there's now an 'fbuid' comment meta field on every facebook connected comment, to tie back to the author of the comment.
• Comments now don't rely on Javascript quite so much. Facebook PHP code is used to get relevant data.
• Publish post-processing improvements, to try to get more images from the post content by using the_content filter.
• Publish button now shows "Fan Page" instead of "Application", if you're using a Fan Page.
• Made comment login button hook a bit more generic (anticipating a "Simple Twitter Connect" plugin).

0.9

• Added share button type option.
• Improved login support. Now it verifies your users email address with Facebook before allowing them to connect their accounts. This ensures that at least they're using the same email on FB and on WP.
• Fixed problem with page reloading for no obvious reason (using different reload method for login plugin).
• Share button shortcode is now [fb-share] if you want to use that in a post.
• Added new Publisher button to publish to your own Facebook profile (this is the same as sharing the post with the share button, actually, but a few people requested it).
• Added Facebook logo checkbox to fanbox plugin.

0.8

• Added Fan Page support, for people who already have Fan Pages that they don't want to give up. I do not recommend using this option, but it's there if you really need it.
• Improved login capabilities. Now a Connect button shows on the login screen, and logging out actually logs you out properly.

0.7

• Added shortcode for fanbox widget. [fb-fanbox]. Optional parameters are stream (1 or 0), connections (int), and width (int).
• Added Application Secret field to main plugin. Login plugin will need it.
• Facebook login now partially working. If you connect your WP account to your FB account and you visit the wp-login page while logged into Facebook as well, you will get auto-logged into WordPress, without any prompting or intervention. This may not be 100% secure or safe, and I do not recommend using it at this point, it's for testing only. I would, however, appreciate feedback on the best way to implement this, sort of thing.

0.6

• Added shortcode for live stream widget. [fb-livestream] will work in pages and posts. The width and height are optional parameters.
• Added shortcode for user status widget. [fb-userstatus profileid="12345"] will work similarly. The profileid is required.
• Added Connect button widget and shortcode [fb-connect].
• Added Bookmark button widget and shortcode [fb-bookmark].

0.5

• Live Stream widget
• Manual Publishing plugin. Lets you post links to your posts on the Facebook Application's Wall. These will show up as "updates" to Fans of your application (which makes the Fan Box widget more useful). Currently, this is manual in that it will only push posts to the Wall when you click the button on the Edit Post page and publish it there.

0.4

• Added Fan Box Widget
• Added new Application ID field to main plugin
• Minor internal reorganizing, for planned addons
• Decided to keep all the version numbers in sync

0.3

• Comment avatars working, beginnings of a Facebook login capability.

0.2.3

• Comments working now. Requires minor theme modifications to make it work.

0.2.2

• Support FBFoundations compatibility, to some extent (make it easier to switch)
• Correct minor errors

0.2.1

• Add meta information to share button, so that stuff shows up nicely on Facebook.

0.2

• Functional enough to use. Barely. Comments still not working. Share button works. XFBML works.

0.1

• Pre-Alpha. DO NOT USE.