Metadata-Version: 1.1
Name: collective.upload
Version: 1.0rc1
Summary: File upload widget with multiple file selection, drag&drop support, progress bars, client-side image resizing and preview images.
Home-page: https://github.com/collective/collective.upload
Author: OpenMultimedia
Author-email: contacto@openmultimedia.biz
License: UNKNOWN
Description: *****************
        collective.upload
        *****************
        
        .. contents:: Table of Contents
        
        Life, the Universe, and Everything
        ----------------------------------
        
        File upload widget with multiple file selection, drag&drop support, progress
        bars, client-side image resizing and preview images.
        
        ``collective.upload`` is smoothly integrated with Plone's UI and works with
        any folderish content type based on Archetypes or Dexterity.
        
        Mostly Harmless
        ---------------
        
        .. image:: https://secure.travis-ci.org/collective/collective.upload.png?branch=master
            :alt: Travis CI badge
            :target: http://travis-ci.org/collective/collective.upload
        
        .. image:: https://coveralls.io/repos/collective/collective.upload/badge.png?branch=master
            :alt: Coveralls badge
            :target: https://coveralls.io/r/collective/collective.upload
        
        .. image:: https://pypip.in/d/collective.upload/badge.png
            :alt: Downloads
            :target: https://pypi.python.org/pypi/collective.upload
        
        Got an idea? Found a bug? Let us know by `opening a support ticket`_.
        
        .. _`opening a support ticket`: https://github.com/collective/collective.upload/issues
        
        Don't Panic
        -----------
        
        Installation
        ^^^^^^^^^^^^
        
        To enable this product in a buildout-based installation:
        
        #. Edit your buildout.cfg and add ``collective.upload`` to the list of eggs to
           install::
        
            [buildout]
            ...
            eggs =
                collective.upload
        
        #. If you're using Plone 4.2, you may need to pin the right versions of the
           jQuery and jQuery Tools packages::
        
            [versions]
            plone.app.jquery = 1.7.2
            plone.app.jquerytools = 1.5.7
        
        After updating the configuration you need to run ''bin/buildout'', which will
        take care of updating your system.
        
        Go to the 'Site Setup' page in a Plone site and click on the 'Add-ons' link.
        
        Check the box next to ``collective.upload`` and click the 'Activate' button.
        
        .. Note::
            You may have to empty your browser cache and save your resource registries
            in order to see the effects of the product installation.
        
        Features
        ^^^^^^^^
        
        - Support for Archetypes and Dexterity-based content types
        - **Multiple file upload**: Allows to select multiple files at once and upload
          them sequentially (simultaneously is not currently enabled)
        - **Drag & Drop support**: Allows to upload files by dragging them from your
          desktop or file manager and dropping them on your browser window
        - **Upload progress bar**: Shows a progress bar indicating the upload progress
          for individual files and for all uploads combined
        - **Cancelable uploads**: Individual file uploads can be canceled to stop the
          upload progress
        - **Client-side image resizing**: Images can be automatically resized on
          client-side with browsers supporting the required JS APIs
        - **Preview images**: A preview of image files can be displayed before
          uploading with browsers supporting the required JS APIs
        - **No browser plugins required**: The implementation is based on open
          standards like HTML5 and JavaScript and requires no additional browser
          plugins
        - **Graceful fallback for legacy browsers**: Uploads files via XMLHttpRequests
          if supported and uses iframes as fallback for legacy browsers
        - **Cross-site file uploads**: Supports uploading files to a different domain
          with Cross-site XMLHttpRequests
        
        Browsers supported
        ^^^^^^^^^^^^^^^^^^
        
        - Google Chrome 7.0+
        - Mozilla Firefox 3.0+
        - Microsoft Internet Explorer 6.0+
        - Opera 10.0+
        - Apple Safari 4.0+
        
        Drag & Drop is only supported on Google Chrome, Firefox 4.0+ and Safari 5.0+.
        
        Client-side image resizing is only supported on Google Chrome, Firefox 4.0+.
        
        Microsoft Internet Explorer has no support for multiple file selection or
        upload progress.
        
        `Extended browser support information`_.
        
        Future features
        ^^^^^^^^^^^^^^^
        
        We want to implement these features at some point in the future:
        
        - Refactoring of widget's UI
        - **Resumable uploads**: Aborted uploads can be resumed with browsers
          supporting the Blob API
        - **Chunked uploads**: Large files can be uploaded in smaller chunks with
          browsers supporting the Blob API
        - **HTML file upload form fallback**: Shows a standard HTML file upload form
          if JavaScript is disabled
        - Enable/disable automatic uploads
        - Server side image resizing
        - Server side file type constraint
        - Asynchronous Module Definition (`AMD`_) support
        - Widget for "allowed extensions" option
        
        Developer's notes
        ^^^^^^^^^^^^^^^^^
        
        In the folder "static" you are going to find the JavaScript used in this
        project; here a list with the file name and function:
        
        applications.js
          The main file; here you will find 2 important things: plugin initialization
          and inheritance of basic UI code with custom templates (e.g. every new file
          dropped in the file upload widget is going to generate a new row, here is
          the code for that).
        
        `canvas-to-blob.min.js`_
          Converts canvas elements into Blob objects, is a polyfill for the standard
          HTML canvas.toBlob method.
        
        `load-image.min.js`_
          Load Image is a function to load images provided as File or Blob objects or
          via URL.
        
        jquery.fileupload.js
          The most basic version of the File Upload plugin, with no UI.
        
        jquery.fileupload-fp.js
          Extends the basic fileupload widget with image processing functionality.
        
        jquery.fileupload-ui.js
          Extends the FP version, adds complete user interface interaction.
        
        jquery.iframe-transport.js
          Used for cross-site iframe transport uploads a way of degradation for the
          XHR upload.
        
        cors/jquery.xdr-transport.js
          jQuery XDomainRequest Transport plugin; enables cross-domain AJAX requests
          (GET and POST only) (not really used, its just there if you need to
          implement that kind of functionality).
        
        vendor/jquery.ui.widget.js
          jQuery UI widget factory; very lightweight, flexible base for building
          complex, statefull plugins with a consistent API. It is designed for general
          consumption by developers who want to create object-oriented components
          without reinventing common infrastructure.
        
        vendor/jquery.getimagedata.min.js
          It enables pixel level access to images from different origins. It works by sending a JSONP request with the URL of the image to the server. The server then converts the image into base64 encoded data URL and sends the image back as a JSON object. (what this script does, can be done with CORS)
        
        To-do list
        ^^^^^^^^^^
        
        * Check if constraints are in place before adding the menu item.
        
        .. _`Extended browser support information`: https://github.com/blueimp/jQuery-File-Upload/wiki/Browser-support
        .. _`canvas-to-blob.min.js`: https://github.com/blueimp/JavaScript-Canvas-to-Blob
        .. _`load-image.min.js`: https://github.com/blueimp/JavaScript-Load-Image
        .. _`AMD`: https://github.com/amdjs/amdjs-api/wiki/AMD
        
        Not entirely unlike
        -------------------
        
        `collective.quickupload`_
            Pure javascript files upload tool for Plone, with drag and drop, multi
            selection, and progress bar.
        
        `collective.uploadify`_
            Multi File Upload for Plone.
        
        .. _`collective.quickupload`: http://pypi.python.org/pypi/collective.quickupload
        .. _`collective.uploadify`: http://pypi.python.org/pypi/collective.uploadify
        
        Share and Enjoy
        ---------------
        
        ``collective.upload`` would not have been possible without the contribution of
        the following people:
        
        - Silvestre Huens
        - Joaquín Rosales
        - Héctor Velarde
        - Gonzalo Almeida
        
        You can find an updated list of package contributors on `GitHub`_.
        
        ``collective.upload`` is an implementation of the `jQuery File Upload`_ plugin
        for Plone.
        
        Development sponsored by Open Multimedia.
        
        .. _`jQuery File Upload`: http://blueimp.github.com/jQuery-File-Upload/
        .. _`GitHub`: https://github.com/collective/collective.upload/contributors
        
        Changelog
        ---------
        
        There's a frood who really knows where his towel is.
        
        1.0rc1 (2014-10-24)
        ^^^^^^^^^^^^^^^^^^^
        
        - Fix browser CORS check.
          [petschki]
        
        - Add missing uninstall profile.
          [thet]
        
        
        1.0b6 (2013-07-24)
        ^^^^^^^^^^^^^^^^^^
        
        - Fixes issue `#24`_, upload not working on folderish objects with a
          default_page defined. [jpgimenez]
        
        - Fix issue with collective.upload not setting filename on uploaded images
          (Archetypes). [ericof]
        
        - Fix misplaced input element in chrome. [domruf]
        
        
        1.0b5 (2013-06-13)
        ^^^^^^^^^^^^^^^^^^
        
        - Display viewlet **only** for users with Add portal content permission and
          if the context is a contaner [ericof]
        
        - Fix issue with collective.upload ignoring title information [ericof]
        
        
        1.0b4 (2013-05-02)
        ^^^^^^^^^^^^^^^^^^
        
        - Package now depends on plone.app.jquerytools >= 1.5.5 to keep it in sync
          with Plone 4.3 pinned versions. [hvelarde]
        
        - Support Dexterity content types (plone.app.contenttypes). [ericof]
        
        - Fix package dependencies. [hvelarde]
        
        - Remove dependency on unittest2. This could break tests when ran under
          Python 2.6; you have been warned. [hvelarde]
        
        - Package is now compatible with Plone 4.3. [jpgimenez, hvelarde]
        
        - Add placeholders to input fields in upload template. [hvelarde]
        
        - Fix translation. [quimera]
        
        
        1.0b3 (2013-01-15)
        ^^^^^^^^^^^^^^^^^^
        
        - Added support for Cross-site file uploads. [quimera]
        
        - Fixed URL generation in the sub menu item. [quimera]
        
        - Fixed compatibility with Chameleon and the JavaScript template. [quimera]
        
        - Refactoring (almost) all dirty JavaScript code. [quimera]
        
        - Updated version of jQuery File Upload. [quimera]
        
        - Add deprecation warning message on the IMultipleUpload behavior. [hvelarde]
        
        - Tested compatibility with Plone 4.3. [hvelarde]
        
        - Update package documentation. [hvelarde]
        
        - Fix package license to GPLv2. [hvelarde]
        
        - Package will now support Plone 4.2+ only. [hvelarde]
        
        - Fixed browser layer interface. [hvelarde]
        
        
        1.0b2 (2012-05-16)
        ^^^^^^^^^^^^^^^^^^
        
        - To avoid problems (for example with collective.googlenews) we pass portal
          site to namechooser instead of context, because the context could be another
          contenttype. [flecox]
        
        
        1.0b1 (2012-05-02)
        ^^^^^^^^^^^^^^^^^^
        
        - Initial release.
        
        .. _`#24`: https://github.com/collective/collective.upload/issues/24
        
Keywords: plone jquery upload
Platform: UNKNOWN
Classifier: Development Status :: 4 - Beta
Classifier: Environment :: Web Environment
Classifier: Framework :: Plone
Classifier: Framework :: Plone :: 4.2
Classifier: Framework :: Plone :: 4.3
Classifier: Intended Audience :: End Users/Desktop
Classifier: Intended Audience :: System Administrators
Classifier: License :: OSI Approved :: GNU General Public License v2 (GPLv2)
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: JavaScript
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 2.6
Classifier: Programming Language :: Python :: 2.7
Classifier: Topic :: Software Development :: Libraries :: Python Modules
