andydickinson.net

online journalism, newspaper video and digital media

Feedback by paragraph plugin

WordPress › Feedback by Paragraph (feedbackBP) « WordPress Plugins

feedbackBP lets your users leave a comment on each paragraph of post.

It’s great for:

  • Leaving corrections and clarifications on any blog
  • On a news site or blog you can let your users suggest other areas of interest and investigation.
  • Document annotation – each post could be a chapter of a book or document.

Features:

You can control who can leave and who can see comments

  • Respects the comment settings of individual posts and comment moderation
  • Uses Thickbox for a neat pop-up window for comments
  • Hides the paragraph comments from the main comment window so you can have macro and micro comments on a post

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.com 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 pluging 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.

In its 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. But I hae developed it to be a little more flexible.

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 paragraph *It filters out any paragraph comments from the normal comment display

Change log

17/8/09 : Version 0.6

  • corrected a bug that put admin comments in to moderation.
  • if the post is updated, any older comments display a message saying “This  comment refers to an earlier version of this post”
  • Option added to turn off the message above
  • renamed plugin file feedbackBP.php

= 0.5.2 =

  • corrected CSS that meant the content of the pop-up window did not render
  • changed the listing of comments in the window so that they display as <ol> as per wordpress comments

= 0.5.1 =

  • corrected an error in the call to the stylesheet directory from feedbackBP to feedbackbp

= 0.4 =

  • Added an options page in admin.
  • Altered comment submission to respect blog and post settings

= 0.3 =

  • Changed the plugin so you no longer need to edit the wp-comments-post.php file

= 0.2 =

  • Corrected the database table details in queries to use wordpress variables rather than unique table names

= 0.1 =

  • Initial Release

You can get the  FeedbackBP from the wordpress plugins site

19 Responses

  1.   Comment on paragraphs – Wordpress Plugin by andydickinson.net

    August 11th, 2009 at 9:53 pm

    1

    [...] Feedback by paragraph plugin Search [...]

  2. Robert D

    August 14th, 2009 at 12:21 am

    2

    Does not show up in Windows IE. Oh it pops up but the box is empty. Works well in foxfire though. Lot of my users are IE so cannot use till it works well with IE. Alos noticed the comments did not show up any where

  3. Andy

    August 14th, 2009 at 11:26 am

    3

    Robert

    Many thanks for the feedback. Really useful.

    It turned out to be some truly awful CSS coding by me that was causing the problem. The comments and form were inheriting the display:none from the span hiding the content so a pop up would work. That’s been fixed (and tested) in the latest version and I hope the code is a bit better.

    But any more feedback would be appreciated.

  4. #Tip of the day from Journalism.co.uk – a new plug-in for Wordpress commenting | Journalism.co.uk Editors' Blog

    August 24th, 2009 at 8:01 am

    4

    [...] a plugin for WordPress that allows readers to comment on individual paragraphs of blog posts. Download it at this link. Tipster: Laura Oliver. To submit a tip to Journalism.co.uk, use this link – we will pay a fiver [...]

  5. Sina Yeganeh

    September 8th, 2009 at 8:47 am

    5

    I love your widget, but I cannot seem to make it work with my current comment setup. What happens is that after a leave a comment in a paragraph, it no longer will display comments written in the normal comment box posted after that comment in the paragraph. I think my layout is just pointing to the wrong table in the database. Please fix this, because I need your widget to enjoy my life. Thanks again

  6. Ray

    September 8th, 2009 at 10:57 pm

    6

    Is there a demo of your plugin in action?

    I’m looking for something similar.

  7. Building Community Sites with WordPress: 15 Plugins to Get Started - Noupe

    March 18th, 2010 at 1:46 pm

    7

    [...] used in an educational setting, to annotate a post, or even to offer criticism.Feedback by ParagraphFeedback by Paragraph is another plugin that lets users leave comments on individual paragraphs within a post. Comments [...]

  8. Building Community Sites with WordPress: 15 Plugins to Get Started | Best Web Magazine

    March 18th, 2010 at 2:29 pm

    8

    [...] [...]

  9. Building Community Sites with WordPress: 15 Plugins to Get Started | Yooxe

    March 19th, 2010 at 4:26 am

    9

    [...] Feedback by Paragraph is another plugin that lets users leave comments on individual paragraphs within a post. Comments are shown in a Thickbox pop-up. Comments here respect settings of individual posts as far as who is allowed to post, and moderation policies are also honored. The fact that paragraph-level comments are kept separate from the main content is a nice feature that makes it easy to implement without requiring any kind of redesign. [...]

  10. Building Community Sites with WordPress: 15 Plugins to Get Started | SeanBurdick

    March 19th, 2010 at 1:02 pm

    10

    [...] Feedback by Paragraph is another plugin that lets users leave comments on individual paragraphs within a post. Comments are shown in a Thickbox pop-up. Comments here respect settings of individual posts as far as who is allowed to post, and moderation policies are also honored. The fact that paragraph-level comments are kept separate from the main content is a nice feature that makes it easy to implement without requiring any kind of redesign. [...]

  11. Building Community Sites with WordPress: 15 Plugins to Get Started | The circuits of imagination

    March 19th, 2010 at 1:24 pm

    11

    [...] Feedback by Paragraph is another plugin that lets users leave comments on individual paragraphs within a post. Comments are shown in a Thickbox pop-up. Comments here respect settings of individual posts as far as who is allowed to post, and moderation policies are also honored. The fact that paragraph-level comments are kept separate from the main content is a nice feature that makes it easy to implement without requiring any kind of redesign. [...]

  12. Building Community Sites with WordPress: 15 Plugins to Get Started | Afif Fattouh - Web Specialist

    March 20th, 2010 at 10:15 am

    12

    [...] Feedback by Paragraph is another plugin that lets users leave comments on individual paragraphs within a post. Comments are shown in a Thickbox pop-up. Comments here respect settings of individual posts as far as who is allowed to post, and moderation policies are also honored. The fact that paragraph-level comments are kept separate from the main content is a nice feature that makes it easy to implement without requiring any kind of redesign. [...]

  13. Building Community Sites with WordPress: 15 Plugins to Get Started « qeqnes | Designing. jQuery, Ajax, PHP, MySQL and Templates

    March 23rd, 2010 at 10:23 am

    13

    [...] Feedback by Paragraph is another plugin that lets users leave comments on individual paragraphs within a post. Comments are shown in a Thickbox pop-up. Comments here respect settings of individual posts as far as who is allowed to post, and moderation policies are also honored. The fact that paragraph-level comments are kept separate from the main content is a nice feature that makes it easy to implement without requiring any kind of redesign. [...]

  14. 15 plugins para criar uma comunidade em torno do seu blog | Wordpress Love - Themes, Plugins e tudo para Wordpress, em Português

    April 1st, 2010 at 6:42 pm

    14

    [...] plugin Feedback by Paragraph é outro plugin que permite aos seus leitores deixarem comentários em parágrafos individuais [...]

  15. 15 plugins para criar uma comunidade em torno do seu blog | Word Press – Noticias

    April 7th, 2010 at 12:54 pm

    15

    [...] plugin Feedback by Paragraph é outro plugin que permite aos seus leitores deixarem comentários em parágrafos individuais [...]

  16. Oviyas Blog – Rajkumar Portfolio website, » Building Community Sites with WordPress: 15 Plugins to Get Started

    April 19th, 2010 at 8:02 am

    16

    [...] Feedback by Paragraph is another plugin that lets users leave comments on individual paragraphs within a post. Comments are shown in a Thickbox pop-up. Comments here respect settings of individual posts as far as who is allowed to post, and moderation policies are also honored. The fact that paragraph-level comments are kept separate from the main content is a nice feature that makes it easy to implement without requiring any kind of redesign. [...]

  17. Crie uma comunidade em torno do seu blog com plugins WordPress :: Tutoriais CTDO - Sua Base de Tutoriais Online

    April 21st, 2010 at 5:23 am

    17

    [...] plugin Feedback by Paragraph também permite aos seus leitores deixarem comentários em parágrafos individuais dentro dos seus [...]

  18. 建立社区wordpress:入门15个插件

    May 18th, 2010 at 2:44 pm

    18

    [...] Feedback by Paragraph 一款用户反馈表单 [...]

  19. .Visitantes, manifestai-vos!. | Bia Lombardi

    May 19th, 2010 at 2:58 pm

    19

    [...] -2a., habilitei a opção de vocês comentarem parágrafo por parágrafo. Vocês vão ver que na visualização individual dos posts aparece um quadradinho cinza com um número dentro ao final de cada parágrafo. Se você clicar nele vai ver que dá pra deixar uma anotação de etxto nesse parágrafo! bacana, né? assim fica mais rápido e fácil deixarum recadinho sem ter que usar os comentários  pra isso :)0 Comments No Comments Your name* [...]


RSS feed for comments on this post · TrackBack URI

Leave a reply