collective.imagetags 1.5

Adds Facebook-like tags (or Flickr-like notes) to images

Introduction

Adds a ‘Tags’ tab in ATContentTypes with non-empty image fields (News Item, Image) to allow content owners to add Text/URL tags (Facebook-like tags or Flickr-like notes) anchored to a certain position of the image.

Tagged image can then be displayed in:

• News Items

• Images

• Fullscreen images

• any other template that you want

by means of:

• custom templates provided with this package, or

• replacement of images via AJAX.

Showing tagged images with AJAX

A special class for images is added to TinyMCE and kupu settings. If an image with this special class “Show tags (imagetags-show)” is inserted in a text field it will be automatically replaced via AJAX to display not only the tags but also a “Tag this picture” link (available only for content owner).

This behavior can be disabled via “Image tags settings” configlet in control panel.

Showing tagged images with <iframes />

‘Tags’ tab displays a list of several pieces of HTML code to embed the tagged image inside an <iframe /> element. HTML code can then be inserted inside a text field to display the tagged image.

This behavior can be disabled via “Image tags settings” configlet in control panel.

Features

Highlights

• Degrades gracefully in non-JavaScript browsers

• All JavaScript interaction done with jQuery and jQueryUI (dialogs, draggables, etc.)

• i18n support (English, French, Dutch and Spanish translations)

• Tested in Plone 4.0.3 and Plone 3.3.5

• Collage view layout provided with collective.collage.imagetags

Browser support

• Linux: Firefox 3.6, Google Chrome 5.0

• Windows: Firefox 3.6, Google Chrome 5.0, Internet Explorer 7, Internet Explorer 8

Known issues

• Content types with more than one image field are not fully supported. The only missing part is to provide a way of changing the tagging image in @@imagetags-manage browser view.

Installation

• Add collective.imagetags to the list of eggs to install, e.g.:

  [buildout]
  ...
  eggs =
      ...
      collective.imagetags

• Tell the plone.recipe.zope2instance recipe to install a ZCML slug:

  [instance]
  recipe = plone.recipe.zope2instance
  ...
  zcml =
      collective.imagetags

• Re-run buildout, e.g. with:

  $ ./bin/buildout

You can skip the ZCML slug if you are using Plone 3.3 or if you are going to explicitly include the package from another package’s configure.zcml file.

Plone 3 installation

• Add this line to the extends parameter in main buildout section:

  [buildout]
  ...
  extends=
      ...
      http://svn.plone.org/svn/collective/collective.imagetags/kgs/collective.imagetags.plone3.cfg

Upgrades

If you already had collective.imagetags installed prior to 1.5, you’ll need to run an upgrade step to migrate old style tag ids. Go to:

1. ZMI

2. portal_setup

3. Upgrades

4. Select collective.imagetags:default and press “Choose Profile”

5. Run required upgrade steps

Credits

Development

• Marcos F. Romero <marcos.romero {at} inter-cultura {dot} com> (developer)

• Juan Pablo Gimenez <jpg {at} rcom {dot} com {dot} ar> (advisor)

• Maurits van Rees <m.van.rees {at} zestsoftware {dot} nl> (contributor)

• Fred van Dijk <f.van.dijk {at} zestsoftware {dot} nl> (contributor)

• JeanMichel Francois <toutpt {at} makina-corpus {dot} org> (contributor)

Translations

• English (en): Marcos F. Romero

• French (fr): JeanMichel Francois

• Dutch (nl): Fred van Dijk

• Spanish (es): Marcos F. Romero

Changelog

1.5 (2011-05-11)

• Remove simplejson dependency (add it in extra require for plone3 compatibility) [toutpt]

• Update provided buildout to use plone4. old one has been renamed and updated to test-plone3.cfg [toutpt]

• Add french translation [toutpt]

• Moved tag management to new adapter [marcosfromero]

• Changed tag ids with hyphens instead of dots [marcosfromero]

• Minor improvement in js_labels to avoid translation errors [marcosfromero]

• Tweaks to improve tag rendering and managing [marcosfromero]

• Important: Upgrade step to migrate tag ids [marcosfromero]

1.4.6 (2011-04-26)

• Bug fix in AJAX image replacement and ifrmaes that made no image being displayed at all.

• Bug fix in improved templates that used to duplicate html and body tags.

• Better embedding code for iframes.

• Bug fix in Plone 3 when unprotecting formUnload.

• CSS tweaks to provide tag hints when entering the tagged area and to re-layout tag labels.

1.4.5 (2011-04-24)

• Added MANIFEST.in file to make sure to include mo files in egg.

• Added formats=zip in setup.cfg to prevent some obscure bug in Python 2.4 (see https://lists.plone.org/pipermail/zopeskel/2011-April/000108.html).

1.4.4 (2011-01-24)

• Added missing Spanish translations

• Dropped ajax-form to use regular form improved with jQuery/jQueryUI

• Moved ImageTagsLabels from old ajax-form to a new browser view

• Minor bug fixes in JS for Plone 3

• Improved decimal separator handling in JavaScript (see change 1.4.2)

• Test updated according to above changes

• Tested in Plone 4.0.3

1.4.3 (2011-01-12)

• Fixed JavaScript to also correctly create a tag the second time [maurits]

• Added internationalization to some missing terms [maurits]

• Dutch translation [fvandijk]

1.4.2 (2011-01-10)

• Replace JavaScript (x,y) decimal separator with server expected decimal separator (thanks to maurits)

1.4.1 (2011-01-06)

• Added imagetags-show class available at paragraph_styles in kupu

• Added actionicons.xml for Plone 3

1.4 (2010-12-27)

• Backported to Plone 3

• Tested in Plone 4.0.2 and Plone 3.3.5

• Added known good set for Plone 3 installation (read INSTALL.txt)

1.3.3 (2010-11-12)

• UI improvements when tagging images in @@imagetags-manage

1.3.2 (2010-09-21)

• Added simplejson dependency, which is used to automatically create JSON from Python objects (thanks to kojiro)

• Change http headers for JSON responses: added content-length, changed mimetype for application/json (thanks to MacYET3)

• Test updated according to above changes

• Tested in Plone 4.0

1.3.1 (2010-07-27)

• Updated documentation

• Bug fix in po files and incorrect translation in AJAX form (forms.py)

1.3 (2010-07-25)

• Cleaner markup (more JavaScript work)

• Small change in CSS (z-index from 200 to 150) required by collective.collage.imagetags

1.2 (2010-07-20)

• Show tags sorted by title field

• Added get_sorted_tags to browser/manage.py

• Moved available_sizes, tag_box, tag_title and portal_url from browser/helper.py to browser/image.py (more sensible)

• Completed browser.interfaces.IImageTagsImage interface

1.1 (2010-07-16)

• i18n support

• Spanish translation

1.0 (2010-07-13)

• Initial release