Metadata-Version: 2.0
Name: django-file-picker
Version: 0.8.0
Summary: Pluggable file picker
Home-page: https://github.com/caktus/django-file-picker/
Author: Caktus Consulting Group
Author-email: solutions@caktusgroup.com
License: BSD
Description-Content-Type: UNKNOWN
Platform: UNKNOWN
Classifier: Topic :: Internet :: WWW/HTTP :: Dynamic Content
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: BSD License
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 2
Classifier: Programming Language :: Python :: 2.7
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Classifier: Development Status :: 5 - Production/Stable
Classifier: Operating System :: OS Independent
Requires-Dist: sorl-thumbnail (>=12.4a1)
Requires-Dist: Pillow (<4.0,>=3.1.0)

django-file-picker
==================

django-file-picker is a pluggable Django application used for uploading,
browsing, and inserting various forms of media into HTML form fields.

Using jQuery Tools, django-file-picker integrates seamlessly into pre-existing pages by
installing an overlay that lists file details and, when applicable, image
thumbnails. New files can also be uploaded from within the overlay (via AJAX
Upload).

django-file-picker provides a few optional extensions to help get started,
including ``file_picker.uploads``, an app with pre-built Image and File models, and
``file_picker.wymeditor``, an app that integrates with
`WYMeditor <http://www.wymeditor.org/>`_, a web-based
WYSIWYM (What You See Is What You Mean) XHTML editor. These extensions are
provided for convenience and can easily be replaced by custom modules.

For complete documentation checkout, `<http://django-file-picker.readthedocs.org>`_

Dependencies
------------

Required
````````
* Python 2.7 (**note**: Python 3 is not yet supported)
* `Django 1.8 to 1.11 (inclusive) <http://www.djangoproject.com/>`_
* sorl-thumbnail==12.4a1
* `jQuery 1.4.x <http://www.jquery.com/>`_
* `jQuery Tools 1.2.x <http://flowplayer.org/tools/>`_
* `AJAX Upload <http://valums.com/ajax-upload/>`_ (included)

Optional
````````
* `django.contrib.staticfiles <https://docs.djangoproject.com/en/1.8/howto/static-files/>`_
* `WYMeditor 0.5 <http://www.wymeditor.org/>`_

  If you are using ``django.contrib.staticfiles``, then add ``file_picker`` to your INSTALLED_APPS
  to include the related css/js.

  Otherwise make sure to include the contents of the static folder in your project's
  media folder.

..  _installation:

Basic Installation
------------------

#. Add ``file_picker`` to INSTALLED_APPS in settings.py::

    INSTALLED_APPS = (
        'file_picker',
        'file_picker.uploads', # file and image Django app
        'file_picker.wymeditor', # optional WYMeditor plugin
    )

   ``file_picker.uploads`` will automatically create two pickers named 'images' and 'files'.

#. Add the ``file_picker`` URLs to urls.py, e.g.::

    from django.conf.urls import include, url
    import file_picker

    urlpatterns = [
        # ...
        url(r'^file-picker/', include(file_picker.site.urls)),
        # ...
    ]

Development sponsored by `Caktus Consulting Group, LLC. <https://www.caktusgroup.com/services/>`_.


