Dependencies
- distribute
- fanstatic
- pillow
- python-magic
- z3c.form
- z3c.template
- zc.set
- ZODB3
- zope.annotation
- zope.app.file
- zope.catalog
- zope.component
- zope.datetime
- zope.dublincore
- zope.event
- zope.interface
- zope.lifecycleevent
- zope.location
- zope.publisher
- zope.schema
- zope.tales
- zope.traversing
- ztfy.extfile>=0.2.10
- ztfy.jqueryui>=0.7.0
- ztfy.skin>=0.5.0
- ztfy.utils
- [test] zope.testing
Contents
What is ztfy.file ?
ztfy.file is a set of classes to be used with Zope3 application server. The purpose of this package is to handle :
- custom schema fields with their associated properties and browser widgets to automatically handle fields as external files
- automatically handle generation of images thumbnails for any image ; these thumbnails are accessed via a custom namespace ("++display++w128.jpeg" for example to get a thumbnail of 128 pixels width) and are stored via images annotations
- allow selection of a square part of a thumbnail to be used as a "mini-square thumbnail".
Square thumbnails selection is based on JQuery package extensions, so the ztfy.jqueryui is required to use all functions of ztfy.file package.
How to use ztfy.file ?
A set of ztfy.file usages are given as doctests in ztfy/file/doctests/README.txt
Changelog
0.3.5
- added annotations check
- added IWatermarker interface and utility
0.3.4
- corrected TAR extractor to correctly handle directories
- corrected GZip extractor to correctly implement IArchiveExtractor interface
0.3.3
- added MIME types vocabulary (based on file extensions)
- added libmagic MIME types vocabulary
0.3.2
- commit transaction before sending blob file and change opening mode to 'c'
0.3.1
- updated locales
- updated style of files download links
0.3.0
- use ZTFY.skin data API
0.2.14
- allow FileProperty value update from a FileUpload input
- syntax correction in HTML field input
0.2.13
- added display template for HTML input field
0.2.12
- force images in "RGBA" mode when reading images in "P" mode before resizing while generating thumbnails
0.2.11
- added new getMagicContentType function
- added archives extraction interface and utilities
- added "downloadable" attribute on file/image widgets
- corrected display widgets
- switch dependencies from PIL to Pillow
0.2.10
- changed package source layout
0.2.9
- include IObjectCopiedEvent subscriber moved from ztfy.extfile package
- remove default JPEG format when creating thumbnails (thumbnails are now created by default using the same file format as the original image); JPEG is only used as default when source image is not in JPEG, PNG or GIF format
- use PIL to get image size when not in JPEG, PNG or GIF format
- added 'display:' TALES adapter to easily get display adapter from page templates
0.2.8
- update imports for last ztfy.jqueryui and ztfy.skin packages
0.2.7
- automatically add filename extension in name of FileField or ImageField attributes values. WARNING: since then, getting field data directly from request returns a tuple made of file content and file name !!
- use mimetypes package to get content-type for text files
- updated doctests
0.2.6
- modified ++file++ and ++display++ namespaces to accept an extension
0.2.5
- added ImageFieldDataConverter to check that uploaded files are really images
0.2.4
- changed position of file input fields
- changed handling of jQuery's "imgAreaSelect" plug-in
0.2.3
- added check in image field widget thumbnail generation code
0.2.2
- added extension in displays URLs
- changed square thumbnails management by using JQuery "imgAreaSelect" plug-in
- handle NOT_CHANGED value in square thumbnails converters
0.2.1
- handle z3c.form NOT_CHANGED value in file field data converter
- migrated resources management from zc.resourcelibrary to Fanstatic
0.2
- Switched to ZTK-1.1.2
0.1.1
- added a little sharpening on thumbnails generation
- added conversions while getting position and dimension of square thumbnails generation
0.1
- initial release