eea.downloads 1.6

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

  • 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

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]