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¶
-
If you are using
django.contrib.staticfiles
, then addfile_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¶
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..