eea.downloads 2.1

EEA Downloads Media Storage

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

Contents

Contents

• Contents

• Main features

• Install

• Getting started

• Storage adapter

• Dependencies

• Source code

• Copyright and license

• Funding

• Changelog

  • 2.1 - (2019-01-28)

  • 2.0 - (2017-12-12)

  • 1.9 - (2017-11-07)

  • 1.8 - (2017-09-11)

  • 1.7 - (2017-04-24)

  • 1.6 - (2016-12-05)

  • 1.5 - (2016-05-19)

  • 1.4 - (2016-03-31)

  • 1.3 - (2016-03-31)

  • 1.2 - (2015-03-17)

  • 1.1 - (2014-10-01)

  • 1.0 - (2014-09-15)

Main features

1. Mounts a file-system directory within ZODB

Install

• 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 https://github.com/eea/eea.downloads/tree/master/buildouts/plone4

• 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:

EEADOWNLOADS_PATH / UID / MODIFIED / ID.EXTENSION

Here is an example:

>>> from eea.downloads.interfaces import IStorage
>>> store = IStorage(context).of('pdf')
>>> store.filepath()
'/opt/downloads/uid-21323e2321312/3213213/context-id.pdf'

>>> store.absolute_url()
'http://localhost:8080/Plone/downloads/uid-21323e2321312/3213213/context-id.pdf'

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

Dependencies

1. Products.CMFCore

2. collective.monkeypatcher

Source code

• Latest source code (Plone 4 compatible): https://github.com/eea/eea.downloads

Copyright and license

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

Funding

EEA - European Environment Agency (EU)

Changelog

2.1 - (2019-01-28)

• Jenkins: Add sonarqube step [avoinea refs #101552]

• Change: updated URLs pointing to eea.europa.eu with https:// [alecghica refs #95849]

2.0 - (2017-12-12)

• Change: Replace eeacms/zptlint with eeacms/plone-test:4 zptlint [avoinea refs #90415]

1.9 - (2017-11-07)

• Change: Remove Sphinx generated documentation [petchesi-iulian refs #88212]

1.8 - (2017-09-11)

• Change: Possibility to register FS dirs from other projects [avoinea]

1.7 - (2017-04-24)

• Change: updated package information [eduard-fironda]

1.6 - (2016-12-05)

• Feature: added translations [irina-botez]

1.5 - (2016-05-19)

• Bug fix: Fix pylint warnings [chiridra refs #71940]

1.4 - (2016-03-31)

• Bug fix: Fix Plone 4 buildout install.sh permissions [avoinea]

1.3 - (2016-03-31)

• Bug fix: Warn if EEADOWNLOADS_PATH is not set and fallback to CLIENT_HOME/tmp instead of crashing entire application [avoinea]

• Bug fix: Warn if EEADOWNLOADS_NAME is not set and fallback to CLIENT_HOME/tmp instead of crashing entire application [avoinea]

1.2 - (2015-03-17)

• Change: Switched to curl in the jenkins build install script [olimpiurob refs #22402]

• Change: Changed fetch url for jenkins build install script to the install script from the main EEA CPB repository [olimpiurob refs #22402]

1.1 - (2014-10-01)

• Feature: registered .lock files for the “Filesystem Directory View” [ghicaale refs #20972]

1.0 - (2014-09-15)

• Upgrade step: Within “Plone > Site setup > Add-ons” install EEA Downloads [voineali refs #20677]

• Pre-upgrade step: Make sure that the folder defined within EEADOWNLOADS_PATH exists on disk and Zope effective-user has read and write access within it. If you use ZEO and have more that one Zope instance, this folder should be shared for all Zope instances. [voineali refs #20677]

• Pre-upgrade step: Within your buildout define environment-vars per instance: EEADOWNLOADS_NAME and EEADOWNLOADS_PATH [voineali refs #20677]