I’ve just tagged version 2.0.0 of WPBook for release, but haven’t yet changed the “stable” tag in the readme.
What that means is that if you’re using WPBook, you won’t seen any automated notification of a newer version being available. You’ll have to go to the WPBook download page and find 2.0.0 at the top of the “other versions” list.
Please do so, especially if you are willing to help test the new features.
What is there to test? Most importantly, a new feature which imports comments made by users on your Facebook wall (or the wall of a Facebook page) in response to excerpts posted by WPBook on those pages.
In other words, if you have “publish to Facebook Stream” enabled and working for your personal wall and/or the wall of a Fan Page, when you publish a new blog post, and that post gets published to the FB wall, and users make comments on that wall post, those same comments will get imported to your WordPress hosted blog.
A few notes:
- You’ve got to have stream publishing working in order for importing to work. For the last few versions, I’ve had the app request “stream_read” permissions as well as “stream_publish” – so it should have the right permissions. If it doesn’t, visit the “click here to grant permissions” page from the WPBook settings and try regranting them – it can’t hurt and it might help.
- Comment importing relies on wp_cron, WordPress’s built in pseudo-cron system, which basically lets timed events happen in the background. (It’s the same thing that makes scheduled posts work). In order to get WPBook’s necessary hooks added to wp_cron, you will need to deactivate and then reactivate the plugin.
- In case you weren’t listening above, you will need to deactivate and then reactivate the plugin for commenting importing to work. Comment importing is a task which fires off hourly, so don’t expect any comments for the first hour or two.
- Comment importing will only work for new posts, or more accurately, posts published to your Facebook wall AFTER installing 2.x. Posts you had previously posted to your Facebook wall will not have their comments imported.
- Comment importing also only works for posts published within the last 7 days (user configurable). Basically this is a potentially taxing operation, and it’s my experience that most comments on a Facebook wall are made within the first 24 or 48 hours of a post being made, so there isn’t much point in going back longer than 7 days.
- You can configure (in the expected places in WPBook settings) whether comments imported from Facebook should be automatically approved, and what email address should be affiliated with them. (This is different than comments made inside the Facebook Application version of your blog, where users can input their email adress. The comment form for wall posts doesn’t allow for email, and doesn’t grant the application permission to pull the users email). This is so that you can set a gravatar to be used for imported posts (just set the email address to one you control, then set a gravatar for that email address).
- There is a debug mode, enabled by changing
define ('DEBUG', false);to
define ('DEBUG', true);at line 37 of wpbook_cron.php. (If you’re not comfortable changing this, perhaps you shouldn’t beta test plugins.) This will create a wpbook_debug.txt file inside the plugin’s directory which captures information about every time cron runs.
Additionally, this version also includes the often requested “Promote External links” option – if checked, this will cause WPBook to use your external (WordPress) permalinks for new posts, both in the “Recent Posts” box in your profile and also in the Wall notifications, so users are sent to your WordPress blog, not to the Facebook Application view of your blog. In essence this lets you use WPBook without ever expecting users to go to your Facebook Application, which is now just used as a mechanism for connecting WordPress to Facebook for the publishing of new posts and the importing of comments.
If you are testing it, please let me know by commenting here or posting in the support forums for WPBook and thanks in advance!