Plone Quick Upload
Pure javascript files upload tool for Plone, with drag and drop, multi selection, and progress bar.
Project Description
Plone Quick Upload
Description
This product offers a multiple files upload tool for Plone, with multi selection, drag and drop, and progress bar. A pure javacript tool is used on client side, with html5 file fields and ajax upload for modern browsers, and a graceful fallback for other browsers. You can also choose to replace the javascript with jquery.uploadify, a flashupload based script which could be interesting in rare situations (Plone site for MSIE client's browsers only, without http authentication in front, and no https).
To install it in your buildout, just add 'collective.quickupload' to your egg list, then
>> bin/buildout
To install it in Plone, use the Addons control panel, select "Plone Quick Upload" Product and install it.
To see it in action, just assign the Quick Upload portlet somewhere in your site and test it.
Details
This package contains :
collective.quickupload.browser
A simple ajax view that can be called by any plone template.
This view is using a javascript multiple upload tool based on fileuploader.js (a fork with many ameliorations of http://valums.com/ajax-upload/) OR jquery.uploadify.js (based on flashupload, see also collective.uploadify plone product from which some parts of code have been taken)
By default the javascript only method is used : the fileuploader.js is a pure ajax file uploader which uses html5 multiple file fields and ajax upload post method. It's not a jquery plugin. For modern browsers like FireFox 3.6+, Chrome, or Safari 4+, it offers drag and drop, multi-selection, and progress bar during upload. For other browsers (IE7, IE8, ...), the script offers a graceful hidden iframe upload fall back.
Flashupload (jquery.uploadify) is more user friendly under MSIE, but has some "big" problems :
- cannot be used behind any kind of http authentication (basic authentication, windowsNT authentication, ...)
- cannot be used through https
- not open source
the webmaster has the choice between these 2 solutions (see control panel below).
the upload form can be viewed only with permission CMF.AddPortalContent on context
the upload form can be viewed only for objects providing IQuickUploadCapable, by default ATFolder, ATBTreeFolder and Plone Site are implementing IQuickUploadCapable
the quickupload form allows to fill title and description for each uploaded file (see control panel below)
the quickupload view log and returns errors to the form (unauthorized, id always exist, type not allowed, etc ... )
the view can use some attributes set in session or request:
- force mediatype (could be None, image, video, audio, or something like this '*.pdf;*.doc;')if a mediatype is set in request :
- with fileuploader.js an error is raised in the form when a file content-type selected is not correct.
- with Flashupload, only choosed content types are shown in selection window, with a specific message "select images", "select video files" (...).
force portal_type
if portal_type is not set in request, content_type_registry is used to find the good portal_type, otherwise the "File" portal_type will be used.
a basic Plone Control panel with some options:
- use flashupload (yes/no), default = no - fill file's titles in form (yes/no), default = yes - fill file's descriptions in form (yes/no), default = no - automatic upload on select (yes/no), default=no - max size limit for each file in KB (default= 0 = no limit) - simultaneous uploads limit (default=2, 0 = no limit)
collective.quickupload.portlet
- a portlet calling the quickupload ajax view (it's also an example on how to use the quick_upload view)
- the portlet is not assigned (can be done TTW or in another package)
collective.quickupload.profiles
- control panel GS profile
- the javascript and css registry GS profile
- portlet GS profile
quickupload.tests
- doctests for control panel, portlet, and quick_upload view
Compliance
- Plone 4.x
Plone 3.3.x support stopped with 1.0.3.
About fileuploader.js fork
These ameliorations have been done :
- queue uploads
- graphic progress bar
- simultaneous upload limit
- can send all files in a second time, after multiple selections, and after different actions on form.
- can add new fields using a new method (onAfterSelect), associated to each file
- debugMode and debugConsole
- css improvements
How To
How to add the quickupload view in my own template or viewlet ?
Just look the quickupload portlet code, it's really easy.
You can also take a look at collective.plonefinder product http://plone.org/products/collective.plonefinder which requires collective.quickupload.
How to set by code types where upload is allowed ?
You include minimal.zcml only, adding to your product configure.zcml:
<exclude package="collective.quickupload" file="configure.zcml" /> <include package="collective.quickupload" file="minimal.zcml" />
And you implement IUploadCapable on types you want:
<class class=".content.EPRIVR_Documents.EPRIVR_Domain"> <implements interface="collective.quickupload.browser.interfaces.IQuickUploadCapable" /> </class>
How to exclude upload on some types ?
If a type implements IQuickUploadNotCapable, portlet will never be shown on it. Add to your zcml:
<class class=".content.MyContent"> <implements interface="collective.quickupload.browser.interfaces.IQuickUploadNotCapable" /> </class>
TODO
- javascript client tests
- unit tests for upload methods
- fileuploader.js refactorisation using jquery
Support
A tracker will be open at http://plone.org/products/collective.quickupload/
More Information
Jean-mat Grimaldi http://macadames.wordpress.com
Thanks to :
- Adrew Valumns (for original fileuploader.js),
- Ramon Bartl (for some parts of code taken in collective.uploadify Plone product),
- Ronnie Garcia, Travis Nickels (for jquery.uploadify.js)
- Gilles Lenfant David Pack and Christophe Combelles, Alter Way Solutions, for functional tests, ideas, and moral support.
- Maik Roeder, for functional tests
Changelog
1.3.1 (2011-12-22)
- Display quickupload portlet on display views only (disable it on edit forms, etc). [thomasdesvenain]
- Add error logs when failures happen. [thomasdesvenain]
- Works with dexterity AND without blobs. [thomasdesvenain]
1.3.0 (2011-11-29)
- Added Italian translation [giacomos]
- Make sure that the portlet is rendered if upload_portal_type is set to auto. [swampmonkey]
- Prevent diazo themes from theming the json response. [swampmonkey]
- If downloaded content type has been selected in portlet settings and content type can't been added in current folder, portlet is hidden. [thomasdesvenain]
- Works with dexterity. We can upload dexterity content types which have a file or image field. We can upload contents in dexterity containers. [thomasdesvenain]
- Updated Chinese translation. [jianaijun]
1.2.1 (2011-10-10)
- Don't speak about drag and drop feature if navigator is IE. (it doesn't works unless version is IE 9.) [thomasdesvenain]
- If chameleon is installed the i18n:attributes don't get translated if the tag doesn't already have the attribute(s). [swampmonkey]
- Update with more Norwegian translations. [tormod, hannosch]
1.2.0 (2011-09-22)
- Fixed error message when trying to upload a file which already exists in folder. [thomasdesvenain]
- Added support for tests using plone.app.testing; control panel is now removed when package is uninstalled. [hvelarde]
- Catch errors if sessions are disabled. [swampmonkey]
- Use plone.app.portlets.ManagePortlets permission, allows site-admins to add/edit the portlet. [ggozad]
- A folder type can implement IQuickUploadNotCapable so that upload is not allowed on it. [thomasdesvenain]
- We can include minimal.zcml file only to manually set IUploadCapable types. [thomasdesvenain]
- Add more messages into po files + french translations. [thomasdesvenain]
- Use IQuickUploadCapable interface to test if portlet has to be displayed. Avoid some 404 errors. [thomasdesvenain]
- User defined title is internationalized in plone domain. [thomasdesvenain]
- Remove !important in css, that shouldn't be used in base css. [thomasdesvenain]
- Portlet has a bottom left and bottom right. [thomasdesvenain]
- Javascripts and css are loaded for authenticated users only. Refs http://plone.org/products/collective.quickupload/issues/11. [frisi, thomasdesvenain]
- Fixed portlet field validation. [thomasdesvenain]
- Fixed internationalizations. Fixed .pot and .po files. [thomasdesvenain]
- Added try/finally around upload_lock protected code to ensure that the lock is released if an exception occurs. [swampmonkey]
- Added Spanish translation [hvelarde]
1.1.1 (2011-06-27)
- Notify ObjectInializedEvent at upload. Fixes http://plone.org/products/collective.quickupload/issues/7 [thomasdesvenain, thanks to lars.eisbaer]
- Pass content_type to the ContentTypeRegistry Fixes http://plone.org/products/collective.quickupload/issues/13/ [thomasw]
- Added Brazilian Portuguese translation [erico_andrei]
- Quickupload form allows to fill description for each uploaded file [regisrouet]
1.1.0 (2011-04-06)
- Mimetype detection works with blobs (plone 4.0+ files). [thomasdesvenain]
- Keep dots in filename during id normalization. [thomasdesvenain]
- Plone 4.1 compatibility. [vincentfretin]
1.0.3
- let an empty content_type when mimetype_registry return None as mimetype object will result in "application/octet-stream" macadames 2010-09-29
- use a specific interface IQuickUploadFactory in place of IFileFactory to avoid possible conflicts with another products using the same interface http://plone.org/products/collective.quickupload/issues/4 macadames and mroeder 2010-10-07
- files id consolidation macadames and mroeder 2010-10-07
- log some rare exceptions (bad id, no primary field ...) resolve http://plone.org/products/collective.quickupload/issues/6 macadames and mroeder 2010-10-08
- fix error in quick_upload.py when typeupload was defined without mediaupload resolve http://plone.org/products/collective.quickupload/issues/5 macadames and kayeva 2010-10-10
- improve doctests (with last bugfixes on typeupload/mediaupload) macadames 2010-10-10
- fix doctests in Plone4 macadames 2010-10-10
1.0.2
- IE7 css fixes upload button was uggly macadames 2010-09-22
- fix content-type header with FireFox xhr upload sometimes is missing macadames 2010-09-24
- don't use unicode in setFileName because it break Archetypes File Field download (unicode decode error) macadames 2010-09-24
- minor fixes in medialabel for upload macadames 2010-09-26
1.0.1
- fix set_id or check_id methods now called on context, no more on aq_parent(context) macadames 2010-09-14
- slow down the removing of progressBar to see something even when Plone is too fast :-) macadames 2010-09-15
- try to find the good content_type for uploaded files using plone mime_types_registry when mimetypes.guess_type(file_name) returns (None, None) macadames 2010-09-17
- fix strange ATFile behavior with content_types when passing mutator(data, content_type=content_type) the content_type is not always good macadames 2010-09-17
- Don't use unicode in setFileName macadames 2010-09-24
- fix content-type header with FireFox xhr upload sometimes is missing macadames 2010-09-24
1.0.0
- fix jquery.uploadify on MSIE with a temp workaround see ticket : https://dev.plone.org/plone/ticket/10894 macadames - 2010/09/02
- using different ids for each uploader methods launchers since we could have different uploaders in a same page example : an images uploader portlet, a video uploader portlet macadames - 2010/09/02
- remove the cookie authentication method with jquery.uploadify (it's not secure to send the cookie in all requests) Just keep the old PloneFlashUpload method (ticket) macadames - 2010/09/02
- many improvements around fileuploader.js (fork) : autoUpload option added onAfterSelect option added refactoristion with these new options macadames - 2010/09/02
- added fileuploader.js jscript launcher macadames - 2010/08/25
- change flashupload jscript launchers to allow multiple uploaders in same page macadames - 2010/08/25
- Add fileuploader.js for XHR or simple hidden iframe uploader macadames - 2010/08/25
- Add quick upload control panel macadames - 2010/08/25
- Initial release : extract upload code from collective.plonefinder to make a separate package macadames - 2010/08/25
Self-Certification
[X] Internationalized
[X] Unit tests
[X] End-user documentation
[X] Internal documentation (documentation, interfaces, etc.)
[ ] Existed and maintained for at least 6 months
[X] Installs and uninstalls cleanly
[ ] Code structure follows best practice
Current Release
collective.quickupload 1.3.1
Released Dec 22, 2011
-
Get
Plone Quick Upload
for
all platforms
- collective.quickupload-1.3.1.zip
- If you are using Plone 3.2 or higher, you probably want to install this product with buildout. See our tutorial on installing add-on products with buildout for more information.
All Releases
| Version | Released | Description | Compatibility | Status |
|---|---|---|---|---|
| 1.3.1 | Dec 22, 2011 | More about this release… | final | |
| 1.3.0 | Nov 29, 2011 | More about this release… | final | |
| 1.2.1 | Oct 10, 2011 | More about this release… | final | |
| 1.2.0 | Sep 22, 2011 | More about this release… | final | |
| 1.1.1 | Jul 27, 2011 | bug fixes More about this release… |
Plone 4
Plone 3
|
final |
| 1.1.0 | Apr 06, 2011 | Blobs & Plone 4.1 compatibility, and better file names management More about this release… |
Plone 4
|
final |
| 1.0.3 | Oct 11, 2010 | Bugfixes More about this release… |
Plone 4
Plone 3
|
final |
| 1.0.2 | Sep 26, 2010 | Bug fixes More about this release… |
Plone 4
Plone 3
|
final |
| 1.0.0 | Sep 11, 2010 | More about this release… | final |


It works fine now, but had a liitle problem.
In my environment, everytime I upload a file, fileupload.js shows error although the file is correctly received by Plone. It turned out that the response from Plone is HTML-encoded:
<html><body><p>{"success": true}</p></body></html>
After I modified quick_upload.py as follows, this problems is resolved.
< response.setHeader('Content-Type', 'text/html; charset=utf-8')
---
> # response.setHeader('Content-Type', 'text/html; charset=utf-8')
> response.setHeader('Content-Type', 'application/json; charset=utf-8')
I'm not sure this problem is specific to my environment.
Is there any configuration in Plone or Zope to avoid HTML-encoding of JSON response ?