EEA & Eionet documentation hub

Browse documentation for IT-systems used by the European Environment Agency and the Eionet network.

EEA Downloads


EEA Downloads (Media Storage) mounts a file-system directory within ZODB



  • Contents
  • Main features
  • Install
  • Getting started
  • Storage adapter
  • Dependencies
  • Source code
  • Copyright and license
  • Funding

Main features

  1. Mounts a file-system directory within ZODB


  • Within your buildout define environment-vars per instance:

    [instance] environment-vars +=   EEADOWNLOADS_NAME downloads   EEADOWNLOADS_PATH ${buildout:directory}/var/downloads
  • Make sure that registered file-system directory exists and the zope effective-user has read access there:

    $ mkdir -p var/downloads
  • Add eea.downloads to your eggs section in your buildout and re-run buildout:

    [instance] eggs +=   eea.downloads zcml +=   eea.downloads
  • You can download a sample buildout from

  • Install eea.downloads within Site Setup > Add-ons

Getting started

  1. Login to ZMI
  2. Navigate to Plone > downloads

Storage adapter

This package defines a storage interface IStorage that you can use to get generated files system paths and Plone related URLs. Default strategy of storing files is:


Here is an example:

>>> from eea.downloads.interfaces import IStorage
>>> store = IStorage(context).of('pdf')
>>> store.filepath()

>>> store.absolute_url()

You can always provide a custom IStorage adapter for your Zope objects if you need other file-system storage layout.


  1. Products.CMFCore
  2. collective.monkeypatcher

Source code

The Initial Owner of the Original Code is European Environment Agency (EEA). All Rights Reserved.

The EEA Downloads (the Original Code) is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 2 of the License, or (at your option) any later version.

More details under docs/License.txt


EEA - European Environment Agency (EU)

Edit this page