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, 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, 3.4, 3.5 and 3.6
• Django 1.8 to 1.11 (inclusive)
• sorl-thumbnail==12.4a1
• jQuery 1.4.x
• jQuery Tools 1.2.x
• AJAX Upload (included)

Optional

• django.contrib.staticfiles

• WYMeditor 0.5

  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.

Basic Installation

1. 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'.

2. 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..