Skip to main content
Help us improve Python packaging – donate today!

EEA Possible Relations. This package provides a flexible way to manage relations in a Plone site. it provides a new reference browser widget and a central management interface for relations, their labels and requirements.

Project Description

Main features

Main goal of EEA Relations is to be an alternative to the default Plone related item widget.

EEA Relations features:

  1. Define/restrict what kind of content types a certain content can relate to
  2. Set restrictions on possible relations (e.g. relations can be made only with published content)
  3. You can define easy to use faceted searches (using EEA Faceted navigation) on the relate items popup
  4. Nice visual diagram showning all the relations and restrictions you defined (Control Panel -> Possible relations)



Never do this directly on production servers and always backup your data before installing Plone add-ons.

  • Add eea.relations to your eggs and zcml section in your buildout and re-run buildout.

  • To use eea.relations widget for all default Plone Content-Types you’ll also need to add ‘eea.relations.default’ within zcml section like:

    eggs +=
    zcml +=
  • Install EEA Possible Relations within Site Setup > Add-ons



This will not uninstall EEA Relations dependencies. See Dependencies section within this document and mannually uninstall them as described by their own documentation before uninstalling EEA Relations.

  • Backup your data.
  • Go to ZMI > PloneSite and remove portal_relations object.
  • Uninstall EEA Possible Relations within Site Setup > Add-ons
  • Remove eea.relations from your eggs and zcml section within your buildout and re-run buildout
  • Restart Zope

Getting started

Once you install the package from “Control Panel Add-ons”, the package will add an utility called “Possible relations” under “Control Panel” from where you can start define the relations, the constraints between contents etc.


EEA Relations has the following dependencies:

  • graphviz

    $ yum install graphviz
    $ apt-get install graphviz
  • pydot

  • eea.facetednavigation

Source code

Latest source code (Plone 4 compatible): - Plone Collective on Github - EEA on Github


EEA - European Environment Agency (EU)


6.6 - (2013-10-22)

  • Feature: filter forward and backward relations of translations and instead show only the canonical relation if getLanguage is present which is normally present after Products.LinguaPlone is installed [ichim-david refs #16995]
  • Feature: added categorizations.txt functional test for covering the logic of relations macros [ichimdav refs #17059]
  • Change: Merged forward, backward and auto relations within in order to avoid having publicated titles if any of the relations categories had the same title. If they don’t have the same title then the behaviour will be the same as before this change. [ichimdav refs #17059]
  • Bug fix: Fixed permissions for popup-selecteditems view as it asks for login and breaks the edit layout if the user doesn’t have the standard Editor role but she/he can add/edit a document [voineali refs #17010]
  • Bug fix: Fixed i18n attributes for as i18ndude returned an error. [prospchr refs #17141]

6.5 - (2013-10-07)

  • Change: Added the notoc class in order to remove the relations h3 headers from the EEA TOC [ichimdav refs #16929]

6.4 - (2013-09-06)

  • Bug fix: fixed tab behaviour with faceted loading when upgrading to Plone 4.3 [ichim-david fixes #16598]
  • Bug fix: fixed height of tabs on Chrome browser which spanned over two lines because of the required images [ichim-david refs #16598]
  • Change: added small optimizations to relations lookups [ichim-david refs #14863]

6.3 - (2013-08-09)

  • Bug fix: Fixed missing i18n translations. [prospchr refs #15572]

6.2 - (2013-05-20)

  • Upgrade step: Within “Plone > Site setup > Add-ons” click on upgrade button available for eea.relations
  • Bug fix: Use schemaextender to override default relatedItems widget for all Archetypes Content-Types. This fixes the missing macro eeareferencebrowser error when EEA Relations is not installed yet in Site Setup > Add-ons [voineali refs #9486]
  • Feature: Added uninstall profile to easily uninstall eea.relations [voineali refs #9486]
  • Change: load relatedItemsWithThumbs macro only on view template to avoid it from showing up in unwanted places like edit form [ichim-david]

6.1 - (2013-04-17)

  • Upgrade step: Within “Plone > Site setup > Add-ons” click on upgrade button available for eea.relations [ichim-david #13870]
  • Bug fix: fixed issue when the relations div from the relations macro appeared wrongly when the auto relations returned an empty list [ichim-david #13870]
  • Feature: added javascript logic that makes use of the reordering controls [ichim-david #13870]
  • Feature: added controls for reordering of related content [tiberich #13870]

6.0 - (2013-03-15)

  • Bug fix: fixed generation of tabs call when IAutoRelations queryAdapter returns no result [ichimdav]
  • Feature: added information for contributors [ciobabog refs #13892]

5.9 - (2013-02-27)

  • Bug fix: avoid crash for backwards and forward relations when relation is None [ichimdav 13988]
  • Bug fix: sort items in related items macro based on title [tiberich #13870]

5.8 - (2013-02-25)

  • Bug fix: optimize Macro forward and backwards methods calls for similar performance gains like those done in 5.5 [ichimdav #13771]
  • Bug fix: Corrected missing i18n attributes for translations. [prospchr refs #13827]
  • Bug fix: Added domain=eea.notranslation to views that don’t need translations. [prospchr refs #13827]

5.7 - (2013-02-04)

  • Change: optimized relatedItems macro tal definitions and reference listing url in a way that can work without our own extra packages [ichimdav #13677]

5.6 - (2013-01-28)

  • Feature: added related content header to relatedItemsWithThumbs macro [ichimdav #13639]

5.5 - (2013-01-16)

  • Bug fix: Optimize queryContentType component. Now it’s 5 times faster [voineali refs #13590]

5.4 - (2013-01-15)

  • Change: removed i18n information regarding pagination since no code for it is found inside eea.relations [ichimdav]

5.3 - (2013-01-10)

  • Change: relationItems are now rendered by default with an album_view style which can be changed by supplying a template parameter [ichimdav #10182]
  • Change: changed auto relations logic returns False instead of generator when there are no results [ichimdav #10182]

5.2 - (2012-11-22)

  • Feature: added subscriber to update relations once a relation contenttype has been renamed [ichimdav #9547]
  • Feature: added warning of broken relation when viewing the portal_relations, relations and content types pages and continue displaying graph without those broken relations [ichimdav #9547]

5.1 - (2012-11-09)

  • Change: better Zope logging when listing relations that don’t comply portal_relations schema [ghicaale refs #6773]
  • Change: pass context to eeareferencebrowser-popup-selecteditem.html so that eea.daviz knows how to get the context of the field [tiberich refs #9571]
  • Change: added tests and documentation for listing relations that don’t comply portal_relations schema [ghicaale refs #6773]

5.0 - (2012-10-08)

  • Change: use IVideo interface when checking for videos [ichimdav #5480]
  • Feature: Added a listing of all relations that don’t comply portal_relations schema [ghicaale refs #3212]
  • Bug fix: Fix doc tests [voineali]

4.8 - (2012-08-27)

  • Bug fix: correctly set css class for related links to avoid floating issues [ichimdav #5455]
  • Bug fix: show fancybox popup on video click and display view page instead of downloading file [ichimdav #5403]
  • Feature: Trigger event when updating widget is done [szabozo0 refs #5138]

4.7 - (2012-07-13)

  • Bug fix: fixed description error for Sparql related items [ichimdav #4705]
  • Bug fix: Fixed i18n missing tags and i18n:domain in .pt files [prospchr refs #5162]

4.6 - (2012-06-12)

  • Upgrade step: Within “Plone > Site setup > Add-ons” click on upgrade button available for eea.relations
  • Upgrade step: (optional) For each “Plone > portal_relations > <Content-Type>” enable ‘faceted search’ within Actions menu [voineali refs #5218]
  • Bug fix: Fixed generic relations (all to all relations) [voineali fixes #4908]
  • Bug fix: fixed markup of HISTORY.txt file [ciobabog refs #5231]
  • Feature: Use the faceted ‘search mode’ by default for relations content-types in order to speed up the relations popup [voineali refs #5218]

4.5 - (2012-03-30)

  • i18n: Added i18n locales folder, pot files and po files for en and ro [voineali]
  • Change: Update popup look&feel [voineali #4968]
  • Change: remove left and right column for portal_relations admin page [demarant]
  • Feature: possibility to overwrite default thumb scale when show relations [demarant]
  • Bug fix: Fixed view macro under [ghicaale #4998]
  • Change: removed content creation status message in reference popup [tiberich #4982]

4.4 - (2012-03-05)

  • Bug fix: Renamed css file to css.dtml. Use portal_url to anchor images [tiberich #4956]
  • Change: make the @eea.relations.macros generic [tiberich #4982]

4.3 - (2012-02-15)

  • Bug fix: don’t check for thumbs on content types, we always have them [tiberich #4671]

4.2 - (2012-01-03)

  • Bug fix: Fixed permission for related items [voineali #4841]
  • Bug fix: Fixed icons for items in portal_relations tool [voineali #4834]

4.1 - (2011-11-18)

  • Rerelease broken egg

4.0 - (2011-11-18)

  • Feature: added a way to easily override Plone default ATContentTypes widget for relatedItems field. Just add ‘eea.relations.default’ within your zc.buildout include ZCMLs [voineali #4232]
  • Cleanup: fixed all pylint, pyflakes violations [voineali #4232]
  • Feature: added upgrade steps [voineali #4392]
  • Feature: Plone 4.x compatible release [voineali #4232]

0.10 - (2011-03-29)

  • Bug fix: fixed failure if object has no workflow [voineali #4217]

0.9 - (2011-02-18)

  • Changed: replaced thickbox with fancybox [ichimdav #3773]

0.8 - (2010-12-13)

  • Bug fix: fixed jslint warnings [voineali #3821]

0.7 - (2010-11-22)

  • Bug fix: fixed missing end tag found by hudson zptlint [voineali #3821]

0.6 - (2010-11-12)

  • Bug fix: fix failing tests [voineali #3821]
  • Change: added cache metadata to images [ghicaale #3667]

0.5 - (2010-11-05)

  • Bug fix: when exporting GS profile, constrain to string the type titles [tiberich]

0.4 (2010-09-06)

  • Feature: color links in reference widget according to their state. [tiberich #3561]
  • Feature: added default location field to content type entries [tiberich #3544]

0.3 (2010-08-16)

  • Change: set permissions for reference popups to View instead of ModifyContent [tiberich #3525]

0.2 (2010-06-16)

  • Change: changed AutoRelations API to return a list of tabs (labeled brains) [#3298 voineali]

0.1 (2010-06-07)

  • Initial release [voineali]

Release history Release notifications

History Node


History Node


History Node


History Node


History Node


History Node


History Node


History Node


History Node


History Node


History Node


History Node


History Node


History Node


History Node


History Node


History Node


History Node


History Node


History Node


History Node


History Node


History Node


History Node


History Node


History Node


History Node


History Node


History Node


History Node


This version
History Node


History Node


History Node


History Node


History Node


History Node


History Node


History Node


History Node


History Node


History Node


History Node


History Node


History Node


History Node


History Node


History Node


History Node


History Node


History Node


History Node


History Node


History Node


History Node


History Node


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Filename, size & hash SHA256 hash help File type Python version Upload date (136.4 kB) Copy SHA256 hash SHA256 Source None Oct 25, 2013

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging CloudAMQP CloudAMQP RabbitMQ AWS AWS Cloud computing Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page