Python JavaScript
Switch branches/tags
Nothing to show
Pull request Compare This branch is 100 commits behind plone:master.
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Failed to load latest commit information.
docs
plone
.gitignore
README.txt
setup.py

README.txt

Introduction
============

`plone.formwidget.multifile` is a z3c.form-widget based on jQuery 
`uploadify <http://www.uploadify.com>`_ plugin, which uses flash for 
uploading.

Using flash makes it possible to select multiple files at once in the file
selection dialog provided by the browser / operating system. After selecting
the files the flash plugin will upload each file by once and the files are
then stored in a draft
(`plone.app.drafts <http://pypi.python.org/pypi/plone.app.drafts>`_). When
submitting the form the converter will get the files from the drafts storage.


Usage
-----

Using the widget is quiet easy::

    >>> from plone.directives import form as directivesform
    >>> from plone.formwidget.multifile import MultiFileFieldWidget
    >>> from plone.namedfile.field import NamedFile
    >>> from zope import schema
    >>> from zope.interface import Interface
    >>> 
    >>> class IMySchema(Interface):
    ...     """My schema interface"""
    ...     
    ...     directivesform.widget(files=MultiFileFieldWidget)
    ...     files = schema.List(title=u'Files',
    ...                         value_type=NamedFile())


Limitations
-----------

Since the flash plugin submits the files it's not possible to use it with
HTTP basic authentication. Currently the widget passes the __ac cookie to
the flash plugin for authentication.