Feedback by Paragraph (feedbackBP)

This plugin allows users to leave comments at paragraph level as well as post level.

Author:Andy Dickinson (profile at wordpress.org)
WordPress version required:2.8
WordPress version tested:2.8
Plugin version:0.6
Added to WordPress repository:13-08-2009
Last updated:19-08-2009
Warning! This plugin has not been updated in over 2 years. It may no longer be maintained or supported and may have compatibility issues when used with more recent versions of WordPress.
Rating, %:0
Rated by:0
Plugin URI:http://www.andydickinson.net/feedback-by-para...
Total downloads:1 588
Active installs:10+
plugin download
Click to start download

This plugin was written to help me feedback comments on blog posts to my journalism students who use wordpress as a base for their online publications.

It was based on an idea I saw at http://newsmixer.us which allows users to comment or ask questions on a particular paragraph. The creators of newsmixer are looking to turn the thing in to an API with a wordpress plugin which would be cool but seems a little way off.

The closest plugin I could find is one called marginalia (http://marginalia.cc/) which looks very nice but doesn't seem to play well with WordPress 2.8. So I've written Feedback by Paragraph to fill the gap.

Why would you want to comment on a paragraph?

One of the basic writing styles that we get Journo students to use is to think about one fact per paragraph. That may sound limiting or over simplistic but it's a good structural approach. So if you allow people to comment by paragraph they can question, clarify or dispute that bit of content. In a broader (and online) sense this is useful as it makes the feedback more specific and encourages threading off the fact in to broader areas of discussion. A bit like a mental/micro hyperlink.

But in this basic form the plugin is really there to allow me to leave feedback on students work. Pointing out good and bad, par by par, is useful feedback.

How does it work?

FBP does a couple of things:

  • It hijacks the content of the post, looking for the </p> tag and inserting a little bit of code that attaches a pop-up box to that paragraph so you can leave comments. It inserts a little bubble with a link to open the box. It only does this on the article page (what WP calls a single post as defined by the template single.php). It uses the closing p tag because it's the easiest one to find as the <p> is often full of crap like classes etc and my regex is not really up to that. Using </p> also has the advantage of picking up any image captions without breaking the styling class.
  • It saves any paragraph comments with a custom 'comment type' so that they can be associated with a paragrpah *It filters out any paragraph comments from the normal comment display