\/wp-content\/plugins\/simple-facebook-connect\/<\/code> directory<\/li>\n- Activate the plugin through the 'Plugins' menu in WordPress<\/li>\n<\/ol>\n\n\n
Whoa, what's with all these plugins?<\/h4>\n\n
The principle behind this plugin is to enable small pieces of Facebook Connect functionality, one at a time.<\/p>\n\n
Thus, you have the base plugin, which does nothing except to enable your site for XFBML and Facebook Connect in general. It's required by all the other plugins.<\/p>\n\n
Then you have individual plugins, one for each piece of functionality. One for enabling comments, one for adding a share button, etc. These are all smaller and simpler, for the most part, because they don't have to add all the Facebook Connect stuff that the base plugin adds.<\/p>\n\n
The comments plugin isn't working!<\/h4>\n\n
You have to modify your theme to use the comments plugin.<\/p>\n\n
In your comments.php file (or wherever your comments form is), you need to do the following.<\/p>\n\n
\nFind the three inputs for the author, email, and url information. They need to have those ID's on the inputs (author, email, url). This is what the default theme and all standardized themes use, but some may be slightly different. You'll have to alter them to have these ID's in that case.<\/p><\/li>\n
Just before the first input, add this code:\n[div id=\"comment-user-details\"]\n[?php do_action('alt_comment_login'); ?]<\/p><\/li>\n<\/ol>\n\n
(Replace the []'s with normal html greater\/less than signs).<\/p>\n\n
\n- Just below the last input (not the comment text area, just the name\/email\/url inputs, add this:\n[\/div]<\/li>\n<\/ol>\n\n
That will add the necessary pieces to allow the script to work.<\/p>\n\n
Hopefully, a future version of WordPress will make this simpler.<\/p>\n\n
The plugin causes an error with a missing \"json_encode\"!<\/h4>\n\n
I did say that this plugin was for WordPress 2.9 and up.<\/p>\n\n
If you are using PHP 5.2 and up, json_encode is built in. If not, then WordPress 2.9 contains a backwards compatible version of it. Either way, many of the plugins need this function in order to do the Facebook sharing functionality properly.<\/p>\n\n
Instead of defining the function itself, it's relying on your code already having it available, whether it's through PHP or WordPress. WordPress 2.8.5 does NOT have this function, so unless you're running PHP 5.2 or up, many of the add-on plugins will not work with that version of WordPress.<\/p>\n\n
The automatic \"share\" after the comments looks funky! Or, there's strange text showing up where it shouldn't be!<\/h4>\n\n
I have encountered other WordPress plugins which mess with the output created by the_excerpt. Since I'm using this to create the content for this piece of the share part, it's possible that there is another plugin interfering.<\/p>\n\n
To check this, view the source of the single post page. Near the bottom is a fair amount of javascript added by the comments plugin. One section in particular looks like this:<\/p>\n\n
var attachment = {\n 'name':'Name of post',\n 'href':'http:\/\/example.com\/blog\/2009\/post-name\/',\n 'description':"Lorem ipsum dolor sit amet [...]",\n 'caption':'{*actor*} left a comment on Name of post',\n 'comments_xid':'http%3A%2F%2Fexample.com%2Fblog%2F2009%2Fpost-name%2F'\n};<\/code><\/pre>\n\nIf it looks messed up in any way, or if there's any extra text around that area, then you likely have some other plugin that breaks the usage of the_excerpt. You'll need to find and deactivate that plugin.<\/p>\n\n
The automatic \"share\" after the comments shows the wrong post!<\/h4>\n\n
You have some plugin that is breaking the proper operation of The Loop. A lot of plugins that display some list of posts (like a list of most popular posts in the sidebar, or a recent comments list, etc) have been known to do this. These plugins were written incorrectly and need to be fixed. Look for updates to those plugins.<\/p>\n\n
Note that you must<\/em> fix these plugins, or remove them. They can cause other issues as well, like comments being attached to the wrong posts and other oddities along those lines. This has been a long standing problem with many WordPress plugins and even some themes. If you cannot find the culprit, try the WordPress support forums. Be prepared to post code from your theme so that somebody can solve the problem for you.<\/p>\n\nShare doesn't work, Publish doesn't work<\/h4>\n\n
Check the page source. If you have a message in there that looks like this: \"Warning: Cannot modify header information - headers already sent by ... in ...\/wp-includes\/class-json.php on line 238\", then you need to upgrade WordPress to 2.9.1. WordPress 2.9 had a minor bug that manifested itself as this error in some cases.<\/p>\n\n
Facebook Avatars look wrong.<\/h4>\n\n
Facebook avatars use slightly different code than other avatars. They should style the same, but not all themes will have this working properly, due to various theme designs and such.<\/p>\n\n
However, it is almost always possible to correct this with some simple CSS adjustments. For this reason, they are placed inside a div with an \"fbavatar\" class, for you to use to style them as you need. Just use .fbavatar in your CSS and add styling rules to correct those specific avatars.<\/p>\n\n
The login plugin won't let me connect my accounts!<\/h4>\n\n
A new security feature in the login plugin is email validation.<\/p>\n\n
When you connect your account to Facebook, the plugin talks to Facebook behind the scenes and attempts to verify your email address. This means that your email on your WordPress account must match one of the email addresses attached to your Facebook account. If the matching process fails, you'll get an alert box telling you why it failed, and the accounts will not be linked.<\/p>\n\n
This is a very alpha process and I can't be sure I've worked all the bugs out. If you have a problem and you know that your two accounts share the same email address, then email me directly with the problem and I'll try to help you out and fix the plugin. Please include screenshots of your email address in both WordPress and Facebook to prove you've checked that possible problem.<\/p>\n\n
Why does the comment plugin ask everybody to send them email?<\/h4>\n\n
The comments plugin, as of version 0.10, asks for the Facebook user's permission to get their email address. Facebook uses a system called \"proxy email\", where it gives an email address back that is not the user's real email address, but which will forward emails to them. The comments plugin puts this information in the comment's email field. This is so that when you get the comment notification email, then the Reply-To section will actually work. You'll be able to reply back to the comment notification and the email will actually get to the user. This also lets plugins like Subscribe to Comments work.<\/p>\n\n
Sometime soon, Facebook is planning on changing their Email API, so this functionality may change or break. The plugin will be kept up to date with any changes Facebook makes, however, the permissions dialog will very likely remain.<\/p>\n\n
To disable this type permissions dialog, disable the option \"Require Name and Email\" in the WordPress Settings->Discussion screen.<\/p>\n\n
Why can't I automatically publish to my Application\/Fan Page?<\/h4>\n\n
Sorry, nothing I can do about it. There's a bug on Facebook preventing this: http:\/\/bugs.developers.facebook.com\/show_bug.cgi?id=8184<\/p>\n\n
When they fix it, I'll turn this feature on. The code is there and done, it just needs to have that bug fixed.<\/p>\n\n
In the meantime, the manual publishing button for an Application or Fan Page works correctly. And automatic publishing of new posts to your personal profile works fine. Note: If you use a multi-user blog, this will publish to the user profile of whoever is publishing the post. That user must also have granted the extended permissions for it to work. Different people may see different settings there, so anybody doing publishing must have granted that permission if they want the post sent to Facebook automatically in any format.<\/p>\n\n\n
\n\t- \n\t\t
\n\t\tSimple Facebook Connect Main Admin Screen.<\/p>\n\t<\/li>\n\t
- \n\t\t
\n\t\tFacebook share button in action.<\/p>\n\t<\/li>\n\t
- \n\t\t
\n\t\tFacebook Comments login button.<\/p>\n\t<\/li>\n\t
- \n\t\t
\n\t\tFacebook Connect button on the Login Screen.<\/p>\n\t<\/li>\n\t
- \n\t\t
\n\t\tFacebook Publisher box in the Post editing screen.<\/p>\n\t<\/li>\n\t
- \n\t\t
\n\t\tConnecting a WordPress account to a Facebook Account on the Profiles Page.<\/p>\n\t<\/li>\n\t
- \n\t\t
\n\t\tConnected a WordPress account to a Facebook Account on the Profiles Page.<\/p>\n\t<\/li>\n\t
- \n\t\t
\n\t\tShare button configuration<\/p>\n\t<\/li>\n<\/ol>\n\n\n
0.11<\/h4>\n\n\n- Fix html entities in publish dialogs.<\/li>\n
- Publish plugin now supports automatic publishing! Look on the SFC settings page to grant permissions and enable automatic publishing.<\/li>\n
- 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.<\/li>\n
- Register plugin is now working. Requires login plugin to be enabled first.<\/li>\n
- Publish plugin is now smarter and won't show you publishing buttons if you're not connected to Facebook.<\/li>\n
- Published posts now also have a See Comments link on Facebook. <\/li>\n<\/ul>\n\n
0.10<\/h4>\n\n\n- Fix quoting problems with publish and comments, for stream publishing (quote marks in titles and such shouldn't cause problems any more)<\/li>\n
- 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<\/em>. Tested, proven.<\/li>\n
- Comments plugin now uses comment meta table for storing FB user id, making for much<\/em> 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. <\/li>\n
- Comments now don't rely on Javascript quite so much. Facebook PHP code is used to get relevant data.<\/li>\n
- Publish post-processing improvements, to try to get more images from the post content by using the_content filter.<\/li>\n
- Publish button now shows \"Fan Page\" instead of \"Application\", if you're using a Fan Page.<\/li>\n
- Made comment login button hook a bit more generic (anticipating a \"Simple Twitter Connect\" plugin).<\/li>\n<\/ul>\n\n
0.9<\/h4>\n\n\n- Added share button type option.<\/li>\n
- 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.<\/li>\n
- Fixed problem with page reloading for no obvious reason (using different reload method for login plugin).<\/li>\n
- Share button shortcode is now [fb-share] if you want to use that in a post.<\/li>\n
- 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).<\/li>\n
- Added Facebook logo checkbox to fanbox plugin.<\/li>\n<\/ul>\n\n
0.8<\/h4>\n\n\n- 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.<\/li>\n
- Improved login capabilities. Now a Connect button shows on the login screen, and logging out actually logs you out properly.<\/li>\n<\/ul>\n\n
0.7<\/h4>\n\n\n- Added shortcode for fanbox widget. [fb-fanbox]. Optional parameters are stream (1 or 0), connections (int), and width (int).<\/li>\n
- Added Application Secret field to main plugin. Login plugin will need it.<\/li>\n
- 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.<\/li>\n<\/ul>\n\n
0.6<\/h4>\n\n\n- Added shortcode for live stream widget. [fb-livestream] will work in pages and posts. The width and height are optional parameters.<\/li>\n
- Added shortcode for user status widget. [fb-userstatus profileid=\"12345\"] will work similarly. The profileid is required.<\/li>\n
- Added Connect button widget and shortcode [fb-connect].<\/li>\n
- Added Bookmark button widget and shortcode [fb-bookmark].<\/li>\n<\/ul>\n\n
0.5<\/h4>\n\n\n- Live Stream widget<\/li>\n
- 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.<\/li>\n<\/ul>\n\n
0.4<\/h4>\n\n\n- Added Fan Box Widget<\/li>\n
- Added new Application ID field to main plugin<\/li>\n
- Minor internal reorganizing, for planned addons<\/li>\n
- Decided to keep all the version numbers in sync<\/li>\n<\/ul>\n\n
0.3<\/h4>\n\n\n- Comment avatars working, beginnings of a Facebook login capability.<\/li>\n<\/ul>\n\n
0.2.3<\/h4>\n\n\n- Comments working now. Requires minor theme modifications to make it work.<\/li>\n<\/ul>\n\n
0.2.2<\/h4>\n\n\n- Support FBFoundations compatibility, to some extent (make it easier to switch)<\/li>\n
- Correct minor errors<\/li>\n<\/ul>\n\n
0.2.1<\/h4>\n\n\n- Add meta information to share button, so that stuff shows up nicely on Facebook.<\/li>\n<\/ul>\n\n
0.2<\/h4>\n\n\n- Functional enough to use. Barely. Comments still not working. Share button works. XFBML works.<\/li>\n<\/ul>\n\n
0.1<\/h4>\n\n\n- Pre-Alpha. DO NOT USE.<\/li>\n<\/ul>","raw_excerpt":"Makes it easy for your site to use Facebook Connect, in a wholly modular way.","jetpack_sharing_enabled":true,"_links":{"self":[{"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin\/60129","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin"}],"about":[{"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/types\/plugin"}],"replies":[{"embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/comments?post=60129"}],"author":[{"embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wporg\/v1\/users\/borhlar"}],"wp:attachment":[{"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/media?parent=60129"}],"wp:term":[{"taxonomy":"plugin_section","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_section?post=60129"},{"taxonomy":"plugin_tags","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_tags?post=60129"},{"taxonomy":"plugin_category","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_category?post=60129"},{"taxonomy":"plugin_contributors","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_contributors?post=60129"},{"taxonomy":"plugin_business_model","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_business_model?post=60129"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}