WordPress.org

(Note: installation instructions are also included in HTML and as a PDF along with the plugin)

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/ /wp-content/plugins/wpbook/php4client/

   NOTE: If you've used previous versions, you no longer need to copy the wp-facebook folder (which no longer exists) to your themes directory.

   If you've used versions prior to 0.9.5, you can DELETE the following directory and all it's contents: /wp-content/themes/wp-facebook/

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.

   Enabling the "Show Invite Friends Link" will show a link inside Facebook when viewing your application which allows users to send invites to their friends.

   Comments inside Facebook can be enabled or disabled without any impact on comments when your blog is viewed outside Facebook. If you have comments enabled, you can optionally require users to provide their email address. (Facebook does not allow access to the user's email address, so you can really only ask users to provide one, not prefill it automatically).

   The "Give WPBook credit" option adds a line at the bottom of your Facebook application pages which says "This Facebook application powered by the WPBook plugin for Wordpress" - I'd love it if you would leave this enabled but it is not required.

   The "Share this post" links can also be enabled or disabled. If they are enabled, they will allow the user to "share" your blog posts using the built in Facebook Share mechanism, including sending a message to friends or posting in their profile.

   The "Enable 'view post at external site' link" enables a link to each blog post at your full blog url (outside Facebook). This is useful to get folks going to your blog outside Facebook, to see it full size/theme etc.

   The "Link position for share button and external link button" option determines where, within each post, those two links will appear - either at the top of the post (before the post content) or at the bottom of the post (after the post content).

   "Enable Facebook users to add your app to their profile" will show an "Add to Profile" button for users viewing the app inside Facebook - this lets them choose to add the application to their profile.

5. To add the application to "Pages" not just "Profiles" - see the instructions linked to from the "settings" page for the plugin.