=== WPBook === Contributors: johneckman, davelester, bandonrandon Tags: facebook, platform, application, blog, mirror Stable tag: 2.0.9.1 Tested up to: 3.0.1 Requires at least: 2.6 Plugin to embed Wordpress Blog into Facebook Platform. As of 1.5, this plugin requires PHP 5. == Description == WPBook enables users to add your (self-hosted, not wordpress.com) wordpress blog as a Facebook application. Facebook users will see your posts in a Facebook look and feel, and can leave comments with their Facebook identity. Comments are shared - meaning comments made by users on your blog at its regular domain and comments made by users inside Facebook are all shown to users of either "view" of your content. Facebook users can also - at their option - add a profile tab to their profile, using the "add profile tab" button at the top of the default canvas page. WPBook also post notifications automatically to your wall, or the wall of pages for which you are an admin, to which you've added the app, and for which you've granted stream publish permission, when you write a new post. (This includes Application Profile pages and group walls, if you are an admin and have enabled fans to write on your walls). Finally, WPBook can also import comments made on your wall (or the wall of a Fan page) in response to excerpts it has posted, and show those in your WordPress blog as full comments. WPBook *DOES NOT* (yet) do any of these: - Post notifications into your users feeds (except for your posts to your wall) when you publish a post - Post notifications back to a users feed when he/she posts a comment If you'd like to do these things, please investigate: - Simplaris Blogcast (http://apps.facebook.com/flogblog/) - The Facebook Notes application (for fan pages) (http://www.facebook.com/notes.php) - The Sociable Facebook Connect plugin (http://www.sociable.es/facebook-connect/) - The Wordbooker Plugin (http://wordpress.org/extend/plugins/wordbooker/) As of 1.5, this plugin requires PHP 5. == Installation == (Note: installation instructions: http://wpbook.net/docs/install/ )) 1. Copy the entire wpbook directory into your wordpress plugins folder, /wp-content/plugins/ You should have a directory structure like this: /wp-content/plugins/wpbook/wpbook.php /wp-content/plugins/wpbook/theme/ /wp-content/plugins/wpbook/client/ 2. Set up a New Application at http://www.facebook.com/developers/, obtaining a secret and API key. Set the callback url to your blog url, including a trailing slash. (http://www.yourblogurl.com/) For canvas url, you just need something *all lower case*, unique, with no spaces, and no trailing slash. Remember it. Set the application type to "website" Set the application to use an iFrame, not fbml, and to "resizable" (Using iFrames lets you use javascript, objects, and other tags not allowed in FBML inside blog posts) 3. Login to Wordpress Admin and activate the plugin 4. Using the WPBook menu, (Dashboard->Settings->WPBook) fill in the appropriate information including Facebook application secret and API keys, as well as your application canvas url. Full directions included with the plugin - linked from the plugin's page or see: http://www.openparenthesis.org/wp-content/plugins/wpbook/install_instructions.html == Frequently Asked Questions == = How do I edit the way my Facebook Application (mirrored blog) looks? = In the wpbook/theme directory, there is an index.php file. Most of what you want is there. There's also a default/style.css which basically mimics Facebook's styles, as well as some other files for processing comments and the like. == Changelog == = 2.0.9.1 = * Packaging script problem? removed htmlentities around fb author = 2.0.9 = * Fixed the lost navigation issue - previous and next page of posts listed at bottom of archive pages (Though not on tabs) * %category_link% and %tab_link% in header/footer were broken - fixed. * Attempt at fix for comment authors with non-ascii characters in their names * Removing old profilebox code and references - Facebook no longer allows profile boxes - replaced by tabs * Excerpts posting to walls with [caption] shortcodes - fixed * Timestamp on imported comments - fixed * Added user_ID to comment-data array for comment import = 2.0.8.1 = * Ouch! Checked in version had extra whitespace before opening php tag * Array checking for page type should be cleaner = 2.0.8 = * Changed the "catch permissions" logic for retrieving the infinite session key again - hopefully eliminate conflict with theme-my-login plugin and any other plugin trying to set cookies. * Adapted logic to allow for posting to the walls of Application Profile pages, Group pages, and regular Fan Pages = 2.0.7 = * Added new way to grant permissions directly for a pageID entered into the wpbook settings interface. Should improve capability for folks looking to publish to a page for which they aren't necessarily an admin, but for which permissions can be granted * Removed instructions, replaced with pointer to online version (easier to keep updated, limit size of download) = 2.0.6 = * Misc bug fixes: gravatar strtolower, htmlspecialchars on blog titles, link to instructions wrong in admin, adding