EEA Annotator

http://ci.eionet.europa.eu/job/eea.annotator-www/badge/icon http://ci.eionet.europa.eu/job/eea.annotator-plone4/badge/icon

EEA Annotator is the Plone integration of http://okfnlabs.org/annotator/ which allows your editors to easily collaborate on a Plone document by adding annotations (inline comments) on it.

http://eea.github.io/_images/eea.annotator.cover.png

Main features

  1. Inline comments on any webpage.
  2. Portal types aware. Possibility to enable inline comments only for certain content types.
  3. Workflow aware. Possibility to enable/disable inline comments only for certain workflow states (via content rules).
  4. Events. Possibility to define custom content-rules based on inline comments events: add/reply/close/re-open/delete (e.g. notify users by e-mail)
  5. Dexterity aware. It works also with dexterity content-types.
  6. Contextually disable inline comments.
  7. Moderate inline comments.

Install

Warning

Once you’ll install this add-on via Site Setup > Add-ons, it will overrides Publish Traversal for Archetypes base object (plone.app.imaging.interfaces.IBaseObject) and Dexterity Base Content (plone.dexterity.interfaces.IDexterityContent) in order to handle custom annotator URLs. Still, it preserves old functionality from plone.app.imaging and plone.dexterity (also eea.depiction) but if you have custom traversals registered for these interfaces, try to use custom browser layers when registering them (see: eea.annotator.browser.app.traverse).

Plone version dependency

eea.annotator does not have a hard dependency on Plone 4.3, however, it has been built around plone.app.jquery version 1.7.2 which is shipped by default with Plone 4.3. If you wish to use the product on an older version of Plone, you could pin the plone.app.jquery version to 1.7.2.

Getting started

  1. Go to Plone Site Setup > EEA Annotator Settings and enable inline comments for your content-types (default enabled for Page);
  2. Go to your work-space within Plone Site and add a new object (Page) or user an existing one;
  3. In view mode select text you want to comment on and add an inline comment;
  4. Within edit form > Settings Tab you can contextually disable inline comments.
  5. You can also add an “Inline comments” portlet in order to overview all inline comments on this page.

Moderate inline comments

Warning

You’ll have to be logged-in ad Manager or have the eea.annotator: Manage permission

  1. Click on the title of the Inline comments portlet if any or just access @@moderate-inline-comments

Dexterity

Dexterity content-types are supported by EEA Annotator.

  1. In order to be able to contextually disable inline comments you need to add a boolean field called disableAnnotator within your Dexterity content-type schema fields.
  2. In order to be able to contextually make inline comments read-only you need to add a boolean field called readOnlyAnnotator within your Dexterity content-type schema fields. (Plone Site Setup > Dexterity Content Types > MyCustomType > Fields)

Source code

Funding

EEA - European Environment Agency (EU)