Welcome, guest | Sign In | My Account | Store | Cart

Notice! PyPM is being replaced with the ActiveState Platform, which enhances PyPM’s build and deploy capabilities. Create your free Platform account to download ActivePython or customize Python with the packages you require and get automatic updates.

pypm install eea.depiction

How to install eea.depiction

  1. Download and install ActivePython
  2. Buy and install the Business Edition license from account.activestate.com
  3. Open Command Prompt
  4. Type pypm install eea.depiction

eea.depiction contains builds that are only available via PyPM when you have a current ActivePython Business Edition subscription.

 Python 2.7Python 3.2Python 3.3
Windows (32-bit)
Windows (64-bit)
Mac OS X (10.5+)
Linux (32-bit)
5.0 Available View build log
Linux (64-bit)
5.0 Available View build log
Depended by
http://ci.eionet.europa.eu/job/eea.depiction-www/badge/icon http://ci.eionet.europa.eu/job/eea.depiction-plone4/badge/icon


EEA Depiction (formerly valentine.imagescales) is a generic system for creating thumbnails/image representations for content types, both those provided by Plone, and custom ones.

At the moment this system is implemented and tested only on Archetypes content types, however this system could be adapted in a later version to work also for dexterity content types.

To make it work for a content type, three adapters need to be provided:

  1. ImageView that retrieves an image in the desired scale.
  2. ImageTag that returns the HTML tag for the image
  3. ImageLink that returns the HTML link to the image.

Upgrade notes

As of eea.depiction 5.2 we customize the following resources in order to display any items in thumbnail listings:

  1. atctListAlbum.py - which is responsible for displaying items in atct_album_view.pt
  2. thumbnail_view.pt - which is the browser template responsible for thumbnail listing for the plone.app.collection package



If you are using zc.buildout and the plone.recipe.zope2instance recipe to manage your project, you can do this:

  • Update your buildout.cfg file:

    eggs =
    zcml =
  • Re-run buildout, e.g. with:

    $ ./bin/buildout

You can skip the ZCML slug if you are going to explicitly include the package from another package's configure.zcml file.

How to specify fallback preview images

eea.depiction 0.3 introduces the concept of fallback images when the regular image traversal fails. The logic works like this:

  1. Look for an image returned by the contexts 'imgview' adapter
  2. If the imgview crashes, isn't found or can not locate/generate an image, we continue by checking if there's an image specified for any of the contexts interfaces.
  3. If there's no fallback image, we look for an image for the context portal type, e.g. article, news-item, document. This should be placed in the 'portal_depiction' utility (Site Setup > Depiction Library)
  4. Uses the generic content type image, i.e. portal_depiction/generic


  1. To map a fallback image to a portal type, place it in this folder and name it after the portal type.
  2. To map a fallback image to an interface just add a named-utility for IDepictionVocabulary (see eea.depiction.vocabularies)


EEA Depiction has the following dependencies:
  • Plone 4+
  • Pillow
This package also supports p4a.video. Thus the following dependencies are optional:
  • p4a.video
eggs =
  eea.depiction [full]

Funding and project management

EEA - European Environment Agency (EU)


5.2 - (2012-11-09)
  • Upgrade step: Within "Plone > Site setup > Add-ons" click on upgrade button available for eea.depiction [ichimdav #5601]
  • Feature: customized thumbnail_view for plone.app.collection in order to display all items since they have fallback images [ichimdav #5601]
  • Feature: customized atctListAlbum to display all items when using atct_album_view [ichimdav #5601]
5.1 - (2012-10-08)
  • Change: Using atct_album_view as the default view for portal_depiction [voineali refs #5497]
5.0 - (2012-09-25)
  • Upgrade step: Within "Plone > Site setup > Add-ons" click on upgrade button available for eea.depiction or install 'EEA Depiction' if it's not already installed.
  • Feature: Added utilities IDepictionTool and IDepictionVocabulary [voineali refs #5497]
  • Feature: Made p4a.video dependency optional [voineali refs #5497]
  • Change: Refactoring valentine.imagescales to eea.depiction [voineali refs #5497]
4.3 - (2012-08-27)
  • Bug fix: added type profile for Topic, fixes tests in Plone 4.2 [tiberich #5346]
4.2 - (2012-07-13)
  • Feature: Updated PIL dependency with Pillow [voineali]
4.1 - (2011-11-18)
  • Rerelease broken egg
4.0 - (2011-11-18)
  • Bug fix: added views registered for default image thumbnail sizes; allows plone filters to properly retrieve the image from html text links [tiberich #4651]
  • Feature: added a interface mapping fallback for our simile exhibit daviz product. [demarant]
  • Bug fix: fixed a bug with atfield adapter not properly dealing with broken blobs [tiberich]
  • Bug fix: fixed a bug with the traverser being triggered for atct_image_transform [tiberich]
  • Bug fix: Plone4 compatibility [tiberich]
  • Bug fix: Fixed pylint/pyflakes warrnings [ghicaale]
  • Change: Restructured package to work with plone.app.imaging instead of overriding it [tiberich #4284]
  • Change: return the whole image when it's not possible to return a scale in imgview for folders and fields [tiberich #4374]
  • Feature: Added upgrade steps [voineali #4392]
  • Feature: Plone 4.x compatible release [tiberich #4284]
0.11 - (2011-10-07)
  • Feature: added a interface mapping fallback for our simile exhibit daviz product. [demarant]
0.10 - (2011-05-25)
  • Bug fix: added workaround for a traversing bug [tiberich EEA #4363]
0.9 - (2011-05-13)
  • Bug fix: fixed scale for folder, in order to get first Image [ghicaale EEA #4347]
0.8 - (2011-05-03)
  • Bug fix: replaced call to getFolderContents with direct search in catalog [tiberich]
0.7 - (2011-03-28)
  • Bug fix: Added translation domain to ZCML files [voineali #4139]
  • Bug fix: Return the field when traversing to /image in traverser [tiberich #4135]
0.6 - (2011-02-17)
  • Bug fix: Use try/except in display method to avoid errors when blobs are missing [tiberich]
0.5 - (2011-01-26)
  • Feature: Added JPEG to known formats for thumbnails [voineali #3847]
0.4 - (2010-05-17)
  • Bug fix: Fixed "typo" in fallback interfaces map. [pthulin]
0.3 - (2010-05-07)
  • Feature: Use fallback images to ensure that an image is always returned. [pthulin]
0.2.1 - (2010-01-18)
  • Cleanup: Removed empty skin folder
0.2 - (2010-01-18)
  • Feature: Thumbnails are always in formats PNG, JPG or GIF even if original is something else i.e TIFF
  • Feature: Enabled folder.ImageView for ATTopics. [pthulin]
  • Bug fix: Fixed bug where 16:9 images scaled to 16:9 background resulted in black borders. [pthulin]
  • Cleanup: Simplified design, removed ImageLink and ImageTag. [pthulin]
  • Feature: Add black borders to 4:3 images scaled to 16:9, and don't stretch the play button. [pthulin]
0.1 - Unreleased
  • Initial release

Subscribe to package updates

Download Stats

Last month:1

What does the lock icon mean?

Builds marked with a lock icon are only available via PyPM to users with a current ActivePython Business Edition subscription.

Need custom builds or support?

ActivePython Enterprise Edition guarantees priority access to technical support, indemnification, expert consulting and quality-assured language builds.

Plan on re-distributing ActivePython?

Get re-distribution rights and eliminate legal risks with ActivePython OEM Edition.