plone.recipe.atcontenttypes 0.2

ZC Buildout recipe to generate an ATContentTypes configuration file in the etc/ folder of a zope instance

Usage
=====

This recipe generates a custom ATContentTypes configuration file and places it in
the etc/ folder of your zope instance.

You can use it with a part like this::

[atcontenttypes-conf]
recipe = plone.recipe.atcontenttypes
zope-instance-location = /home/kevin/instance/

Generally, we use this recipe in combination with a zope instance part. Here is
an example base on `plone.recipe.zope2instance documentation`_

.. _`plone.recipe.zope2instance documentation`: http://pypi.python.org/pypi/plone.recipe.zope2instance

::

[instance]
recipe = plone.recipe.zope2instance
zope2-location = /path/to/zope2/install
user = admin:admin
http-address = 8080
eggs = ${buildout:eggs} my.package
products = ${buildout:directory}/products
zcml = my.package

[atcontenttypes-conf]
recipe = plone.recipe.atcontenttypes
zope-instance-location = ${instance:location}
max-file-size = ATImage:1mb
ATFile:100mb
ATNewsItem:500kb
max-image-dimension = ATNewsItem:640,400
ATImage:2048,2048
pil-quality = 95


In case you have a multi-instance setup you can define multiple instance locations
and the recipe will create config files in each instance's etc directory::

[atcontenttypes-conf]
recipe = plone.recipe.atcontenttypes
zope-instance-location =
${instance1:location}
${instance2:location}


Options
=======

zope-instance-location
The path(s) where your zope instance(s) is(are) installed. If you are also using the
plone.recipe.zope2instance recipe (like the second example above), and you
have that configured as a part called 'instance' prior to the atcontenttypes
part, you can use ${instance:location} for this parameter.

max-file-size (default: no)
This option let you set the maximum file size (in byte, kb or mb). You can
specify different file size limit, one for each content type.
Example:
max-file-size = ATImage:1mb
ATFile:100mb
ATNewsItem:500kb

max-image-dimension (default: 0,0)
This option let you set the maximum image dimension ("w, h"). "0,0" means no
rescaling of the original image. This option is per-content-type and its
syntax is the same as above.
Example:
max-image-dimension = ATNewsItem:640,400
ATImage:2048,2048

pil-quality (default: 90)
This option affects the quality images get saved with.

Reporting bugs or asking questions
==================================

We have a shared bugtracker and help desk on Launchpad:
https://bugs.launchpad.net/collective.buildout/

Change History
==============

0.2 (2010-04-07)
----------------

- allow to set pil quality
[fRiSi]

- allow to supply multiple values to zope-instance-location
[fRiSi]

0.1
---

- Initial implementation.
[kdeldycke]