=== Plugin Name === Contributors: Tomas Vorobjov Donate link: https://www.paypal.com/cgi-bin/webscr?cmd=_s-xclick&hosted_button_id=WFXMBAHD523VW Tags: Wordpress, Facebook, Social Requires at least: 2.8 Tested up to: 3.0 Stable tag: 1.09 This plugin integrates the new Facebook Social Platform tools with Wordpress. == Description == This plugin integrates the new Facebook Social Platform tools with Wordpress It provides the Social Plugins as fully customizable Wordpress Widgets, including: * Activity Widget * Comments Widget (XFBML only) * Facepile Widget (XFBML only) * Like Box Widget * Like Button Widget * Live Stream Widget * Login Widget (XFBML only) * Recommendation Widget The widgets can be added to your blog just as easy as any other Wordpress Widget, i.e. through the widgets page (under Appearance on your Dashboard). Apart from the widgets, the plugin also delivers Facebook Comments and the Like Button to individual posts. Now anyone with Facebook account can post comments on your blog and like your posts. Whenever available (as per the Facebook implementation), the user can choose from two rendering options: to either render the modules in an iframe or using the Facebook Javascript API. **Requirements** * PHP 5.2.0 or newer * WordPress 2.8 or newer == Installation == 1. Upload the plugin files to your `/wp-content/plugins/` directory 2. Activate the plugin through the 'Plugins' menu in WordPress 3. Go to the "Connect" settings (via you administration dashboard) and set the value for Application ID (there is a link to a Facebook page where you can create those). == Frequently Asked Questions == = What is the API Key and Application ID for? = Many of the Facebook Social Plugins are available to be rendered in iframes, however, some (Comments, Facepile and Login) can be added to websites only via the Facebook Platform Javascript API. The Javascript API require a unique application key and ID to work. Technically, you don't need to fill-in those fields, however the widgets provided by this plugin will work only in the "iframe" mode (iframe type in the widget settings). Although mostly there is no difference between the two rendering modes (iframe/xfbml), the xfbml rendering mode offers additional functionality not available through iframes. = Can I enable both the Comments Module and the Like Button? = No. An equivalent of the Like Button is already a part of the Comments Module. Furthermore the Comments and the Like Button module do not seem to co-exist on the same page without conflicts. Therefore, enabling Comments (for blog posts) will automatically remove the Like Button (a warning message appears on the Like Button Settings Page whenever the Comments are enabled) = Do the widgets work with WP Super Cache and other caching plugins? = Yes, the content in all widgets will update every time a user visits your site regardless of the rendering mode (iframe/xfbml), even if the page (in which the widgets are embedded) remains unchanged. This is because Facebook delivers content to widgets either via iframes or via asynchronous Javascript calls (xfbml), i.e. content is requested with every page load. = The plugin doesn't work in my favorite theme = If the plugin doesn't work in one theme but does in others, the most likely reason is that the theme itself doesn't implement Wordpress hooks properly. For everything to work correctly, the plugin needs to add code into the html head tag (wordpress header) and the footer of the blog pages. It uses wordpress hooks (add_action and add_filter calls) for this purpose. If the theme author has not included the common wordpress hooks into the theme, required code cannot be added into the pages. You should contact the theme author and ask him/her to implement the wp_head and wp_footer action calls correctly. = I updated the plugin to the latest version but don't see the changes = If you are using any caching solution, such as WP Cache or WP Supercache, you'll need to reset the cache, i.e. to delete the cached pages. This is necessary so that the xfbml and iframe markup values can be updated. = Plugins Info = More information about the plugins can be found back on Facebook at http://developers.facebook.com/docs/reference/plugins/ == Screenshots == 1. Wordpress Connect Widgets 2. Wordpress Connect Widgets Settings 3. Wordpress Connect (global) 4. The Like Button Settings 5. New Comments Module Settings (enabling users to select on which pages will the comments appear) 6. New Comments Module Settings (enabling users to force the module to a new line) == ChangeLog == = 1.09 * Added a like button to the comments box (iframe only for now) = 1.07 = * Fixes the problem that comments no longer appear after facebook plugins have been updated = 1.05 = * Adds the option to force the Comments and the Like Button to appear on a new line in case posts' content isn't enclosed in a block element. * Compatibility up to Wordpress 3.0 = 1.03 = * Adds options to control on which pages comments and like button appear, i.e. it is possible to disable the comments and the like button on the homepage, pages and categories (they always appear in single posts) - see screenshot #5. = 1.02 = * Fixes the issue with the Like Button within the Comments plugin = 1.01 = * Update to the plugin package to include all necessary files * Added Facebook Connect languages = 1.0 = * The initial release of this plugin. Due to a failed svn update this version of the plugin does NOT deliver any functional widgets or modules. == Upgrade Notice == = 1.05 = * Adds the option to force the Comments and the Like Button to appear on a new line in case posts' content isn't enclosed in a block element. * Compatibility up to Wordpress 3.0 = 1.03 = * Adds options to control on which pages comments and like button appear, i.e. it is possible to disable the comments and the like button on the homepage, pages and categories (they always appear in single posts) = 1.02 = * Fixes the issue with the Like Button within the Comments plugin = 1.01 = * The first fully functional version (1.0 release failed due to SVN issue)