Plugins/ImageAnnotation

About Image Annotation Plugin

The Image Annotation plugin allows users to annotate images associated with items.

Download

1.0 Beta

Features

  • Image Annotation Gallery - permitted users can browse and annotate images on item pages. Admins can also can use the image_annotation_display_annotated_image_gallery_for_item helper function in their themes to display an image gallery for an item.
  • Image Annotation Admin Page - permitted users can search, sort, and delete image annotations via an admin page.
  • Configurable Permissions - admins can specify which types of users can view, add, edit, or delete annotations. They can also specify whether users can edit or delete all annotations, or just the annotations they added. The plugin also works with the Guest Login plugin, so that self-registered users can annotate images.

Known Bugs

  • The image annotation javascript conflicts with ReSize javscript function in the Berlin theme.

Needed Features

  • Save relative coordinates, so annotations can display on resized images.

How To Add An Image Annotation Gallery For An Item In A Public Theme

  1. Edit the items/show.php page in your public theme.
  2. Add the following code:
    
    <?php echo image_annotation_display_annotated_image_gallery_for_item();?>
    

Image Annotation and other Plugins

Keep in mind that if you are activating other plugins that append the items/show page for displaying content those elements may crowd the page's public display.

How To Add An Image Annotation

  1. Go to an image annotation gallery (either on the admin item show page or a page in your public theme where you've added one).
  2. Click on the thumbnail of the image you want to view.
  3. Click on the Add Annotation button.
  4. A small annotation box will appear. Drag the annotation to the region of the image you want to annotate. You can also resize the box by clicking and dragging the borders of the box.
  5. Fill in the text of your annotation in the form.
  6. Click the Save button.

How To Edit An Image Annotation

  • Click the annotation box you want to edit.
  • Drag the annotation box over the part of the image you want to annotate. You can resize the box by clicking and dragging the borders of the box.
  • Click the Save button.

How To Delete An Image Annotation

  1. Click the annotation box you want to delete.
  2. Click the Delete button.

Uninstalling Image Annotation Plugin

If you edited the items/show page in the public theme, you must also delete that snippet of PhP after you uninstall Image Annotation from the plugins page. If you do not go back and edit items/show, you will find that most of the data does not display on public items/show pages.