django-file-picker is a pluggable Django application used for uploading, browsing, and inserting various forms of media into HTML form fields.
When a user is editing some content, and they want to insert a link to a file or image into their content, possibly uploading the image or file in the process, django-file-picker provides the tools to do that.
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,
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 more complete documentation, see http://django-file-picker.readthedocs.org
- Python 2.7, 3.4, 3.5 and 3.6
- Django 1.8 to 1.11 (inclusive)
- jQuery 1.4.x
- jQuery Tools 1.2.x
- AJAX Upload (included)
If you are using
django.contrib.staticfiles, then add
file_pickerto 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.
sorl.thumbnailto INSTALLED_APPS in settings.py:
INSTALLED_APPS = ( 'file_picker', 'file_picker.uploads', # file and image Django app 'file_picker.wymeditor', # optional WYMeditor plugin 'sorl.thumbnail', # required )
file_picker.uploadswill automatically create two pickers named 'images' and 'files'.
Note: sorl-thumbnail was out of support for a number of years, but there is now a new pre-release that seems to work, which you can install using:
$ pip install --pre sorl-thumbnail==12.4a1
Hopefully newer releases will come soon.
file_pickerURLs 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..