| 1 | === Wordbook ===
|
|---|
| 2 |
|
|---|
| 3 | Contributors: rtsai
|
|---|
| 4 | Tags: facebook, minifeed, newsfeed, crosspost
|
|---|
| 5 | Requires at least: 2.2
|
|---|
| 6 | Tested up to: 2.8
|
|---|
| 7 | Stable tag: trunk
|
|---|
| 8 |
|
|---|
| 9 | This plugin allows you to cross-post your blog posts to your Facebook Wall. Your Facebook "Boxes" tab will show your most recent blog posts.
|
|---|
| 10 |
|
|---|
| 11 | == Description ==
|
|---|
| 12 |
|
|---|
| 13 | This plugin allows you to cross-post your blog posts to your Facebook Wall. Your Facebook "Boxes" tab will show your most recent blog posts.
|
|---|
| 14 |
|
|---|
| 15 | == Installation ==
|
|---|
| 16 |
|
|---|
| 17 | 1. [Download](http://wordpress.org/extend/plugins/wordbook/) the ZIP file.
|
|---|
| 18 | 1. Unzip the ZIP file.
|
|---|
| 19 | 1. Upload the `wordbook` directory to the `/wp-content/plugins/` directory.
|
|---|
| 20 | 1. Activate the plugin through the 'Plugins' menu in WordPress.
|
|---|
| 21 | 1. Navigate to `Options` → `Wordbook` for configuration and follow the on-screen prompts.
|
|---|
| 22 |
|
|---|
| 23 | == Frequently Asked Questions ==
|
|---|
| 24 |
|
|---|
| 25 | = Isn't Wordbook the same as importing my blog posts into Facebook Notes? =
|
|---|
| 26 |
|
|---|
| 27 | It is certainly similar, but not the same:
|
|---|
| 28 |
|
|---|
| 29 | - Facebook Notes imports and caches your blog posts (e.g., it subscribes to your blog's RSS feed).
|
|---|
| 30 |
|
|---|
| 31 | Wordbook uses the Facebook API to actively update your Facebook Wall just as if you had posted an update yourself on facebook.com. This means that your updates are likely to appear faster than waiting around for the Facebook Notes RSS reader to notice your update. It also means that you can make changes to your blog postings *after* initially publishing them.
|
|---|
| 32 |
|
|---|
| 33 | - With Wordbook, your blog postings will have their own space in your Facebook profile, instead of having to compete for space with your other posted Facebook Notes.
|
|---|
| 34 |
|
|---|
| 35 | - Your updates will show up with a nifty WordPress logo next to them instead of the normal "Notes" icon :).
|
|---|
| 36 |
|
|---|
| 37 | - Your Facebook Notes' comments will not show up on your WordPress blog. Wordbook links everything back to your blog, so your comments will also stay on your blog (it does mean your readers will have to leave Facebook).
|
|---|
| 38 |
|
|---|
| 39 | = How is this different from the WordPress application? =
|
|---|
| 40 |
|
|---|
| 41 | The [WordPress application](http://www.facebook.com/apps/application.php?id=2373049596) allows you to post to your [wordpress.com](http://www.wordpress.com/) blog directly from within Facebook. You cannot use the Facebook app with a self-hosted WordPress blog.
|
|---|
| 42 |
|
|---|
| 43 | This Wordbook plugin works in the reverse direction. When you publish a new post or page, the plugin, in conjunction with the [Wordbook](http://www.facebook.com/apps/application.php?id=3353257731) Facebook application, cross-posts your new blog entry to your Facebook account. You cannot use Wordbook with a blog hosted at wordpress.com.
|
|---|
| 44 |
|
|---|
| 45 | = Why aren't my blog posts showing up in Facebook? =
|
|---|
| 46 |
|
|---|
| 47 | - Wordbook will not publish password-protected posts.
|
|---|
| 48 |
|
|---|
| 49 | - Any errors Wordbook encounters while communicating with Facebook will be recorded in error logs; the error logs (if any) are viewable in the "Wordbook" panel of the "Options" WordPress admin page.
|
|---|
| 50 |
|
|---|
| 51 | To discourage spammy behavior, Facebook restricts each user of any application to 10 posts within any rolling 48-hour window of time ([see reference](http://developers.facebook.com/documentation.php?v=1.0&method=feed.publishTemplatizedAction)). If you've been playing around with Wordbook and posting lots of test posts, you have likely hit this limit; it will appear in the error logs as `error_code 4: "Application request limit reached"`. There is nothing to do but wait it out.
|
|---|
| 52 |
|
|---|
| 53 | - Facebook sometimes incorrectly returns this result to application requests (other developers have also reported this problem with their Facebook apps; it's not just Wordbook); there is also nothing the Wordbook plugin can do about this.
|
|---|
| 54 |
|
|---|
| 55 | = My WordPress database doesn't use the default 'wp_' table prefix. Will this plugin still work? =
|
|---|
| 56 |
|
|---|
| 57 | The plugin is aware of database table prefixes. Specifically, things should work correctly for a single WordPress install supporting multiple blogs in a single database.
|
|---|
| 58 |
|
|---|
| 59 | = How do I reset my Wordbook/WordPress configuration so I can start over from scratch? =
|
|---|
| 60 |
|
|---|
| 61 | 1. Click the "Reset configuration" button in the "Wordbook" panel of the "Options" WordPress admin page.
|
|---|
| 62 | 1. Deactivate the Wordbook plugin from your WordPress installation.
|
|---|
| 63 | 1. [Uninstall Wordbook](http://www.facebook.com/apps/application.php?id=3353257731) from your Facebook account.
|
|---|
| 64 | 1. Download the [latest version](http://wordpress.org/extend/plugins/wordbook/)
|
|---|
| 65 | 1. Re-install and re-activate the plugin.
|
|---|
| 66 |
|
|---|
| 67 | = How do I report problems or submit feature requests? =
|
|---|
| 68 |
|
|---|
| 69 | Use the [Wordbook Discussion Board](http://www.facebook.com/board.php?uid=3353257731). Either start a new topic, or add to an existing topic.
|
|---|
| 70 |
|
|---|
| 71 | Do *not* use the Review Wall for support or feature requests. People are unable to respond to Review Wall posts; you are less likely to get a response.
|
|---|
| 72 |
|
|---|
| 73 | Alternatively, leave a comment on [my blog](http://www.tsaiberspace.net/blog/2007/07/29/wordbook/).
|
|---|
| 74 |
|
|---|
| 75 | == Features ==
|
|---|
| 76 |
|
|---|
| 77 | - Works with a complementary [Facebook application](http://www.facebook.com/apps/application.php?id=3353257731) to update your Facebook Wall and friends' News Feeds about your blog and page postings.
|
|---|
| 78 | - A miniature version of your recent blog posts will be displayed in the "Boxes" tab of your Facebook profile.
|
|---|
| 79 | - Supports multi-author blogs: each blog author notifies only their own friends of their blog/page posts.
|
|---|
| 80 |
|
|---|
| 81 | == Bugs that will be fixed ==
|
|---|
| 82 |
|
|---|
| 83 | 1. Internationalization/Localization
|
|---|
| 84 |
|
|---|
| 85 | I would like for Wordbook to work everywhere, but I lack expertise in this sort of thing and welcome any pointers and/or patches.
|
|---|
| 86 |
|
|---|
| 87 | == Feature requests under consideration (as time permits) ==
|
|---|
| 88 |
|
|---|
| 89 | 1. How can I customize the way Wordbook appears in my profile?
|
|---|
| 90 |
|
|---|
| 91 | For the immediately-forseeable future, Wordbook will not be that configurable. The only immediately-available configuration is the number of posts showing up in the mini-blog. This number is the same as the number of posts that show up on the front page of your blog; navigate to your Dashboard Options → Reading and configure the "Blog Pages: Show at most" option.
|
|---|
| 92 |
|
|---|
| 93 | 1. Wordbook sends *all* my posts to Facebook. Can I do this selectively?
|
|---|
| 94 |
|
|---|
| 95 | At this time, no. You will have to log in to Facebook immediately after posting and manually remove the item from your Wall.
|
|---|
| 96 |
|
|---|
| 97 | Someday I'll add a "Post to Facebook" checkbox next to the WordPress "Publish" button or something.
|
|---|
| 98 |
|
|---|
| 99 | 1. I have multiple blogs; I'd like for all of them to update the same Facebook account.
|
|---|
| 100 |
|
|---|
| 101 | This is possible, but does not work at this time. This features requires a UI to allow Facebook session keys (currently not displayed anywhere in the UI) to be cut-and-pasted between multiple blogs.
|
|---|
| 102 |
|
|---|
| 103 | 1. I use WordPress excerpts for my RSS feeds; Wordbook doesn't use this for the profile box.
|
|---|
| 104 |
|
|---|
| 105 | This is a Wordbook bug; it doesn't know about excerpts yet.
|
|---|
| 106 |
|
|---|
| 107 | == Feature requests not under consideration ==
|
|---|
| 108 |
|
|---|
| 109 | 1. My blog has multiple authors. Can they all post to the same Facebook account using their own name?
|
|---|
| 110 |
|
|---|
| 111 | The name shown as the source of a News Feed update is determined solely by the Facebook account connected to Wordbook, and has nothing to do with the WordPress blog author. Using multi-author support, each blog author can post to their own Facebook account (using their own respective Facebook names), or they can all post to the same Facebook account using the same Facebook name.
|
|---|
| 112 |
|
|---|
| 113 | This is a Facebook restriction ([see reference](http://developers.facebook.com/documentation.php?v=1.0&method=feed.publishActionOfUser)). All News Feed updates *must* include the first name of the Facebook account owner. If the Facebook app doesn't supply it, Facebook will automatically add it. There is no way for Wordbook to make a News Feed update appear to come from some other account.
|
|---|
| 114 |
|
|---|
| 115 | 1. Will this work with Facebook Pages?
|
|---|
| 116 |
|
|---|
| 117 | No. Facebook Pages look similar to user account profile pages, but the Facebook API treats the two very differently, and it is currently not possible to show the blog on a Facebook Page as is done for profile pages.
|
|---|
| 118 |
|
|---|
| 119 | 1. My WordPress is 1.x/2.0/2.1. The plugin doesn't work!
|
|---|
| 120 |
|
|---|
| 121 | This plugin is written for and tested on WordPress-2.3. I cannot test on older WordPress releases. I will happily accept any patches, if you are able to write a patch to get things to work. Otherwise, you really should consider upgrading your WordPress installation.
|
|---|
| 122 |
|
|---|
| 123 | 1. Can this work with PHP-4.x or MySQL-4.x?
|
|---|
| 124 |
|
|---|
| 125 | It is true that the [WordPress minimum requirements](http://wordpress.org/about/requirements/) are PHP-4.3 or greater and MySQL-4.0 or greater.
|
|---|
| 126 |
|
|---|
| 127 | There are two obstacles to Wordbook getting PHP4 support again: (a) My development environment is PHP5 and MySQL-5.0, and (b) Facebook has stopped releasing an "official" client library for PHP4.
|
|---|
| 128 |
|
|---|
| 129 | I cannot actively maintain PHP4 support, but will happily accept patches.
|
|---|
| 130 |
|
|---|
| 131 | == Screenshots ==
|
|---|
| 132 |
|
|---|
| 133 | 1. WordPress updating a Facebook profile's Wall.
|
|---|
| 134 | 1. Summary of WordPress blog posts in a Facebook profile.
|
|---|
