Skip to main content
This is a pre-production deployment of Warehouse. Changes made here affect the production instance of PyPI (pypi.python.org).
Help us improve Python packaging - Donate today!

Pluggable file picker

Project Description

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, 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 more complete documentation, see http://django-file-picker.readthedocs.org

Dependencies

Required

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 and sorl.thumbnail to 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.uploads will 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.

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

Release History

Release History

This version
History Node

0.9.1

History Node

0.9.0

History Node

0.8.0

History Node

0.7.0

History Node

0.6.0

History Node

0.5.0

Download Files

Download Files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

File Name & Checksum SHA256 Checksum Help Version File Type Upload Date
django_file_picker-0.9.1-py2-none-any.whl (233.7 kB) Copy SHA256 Checksum SHA256 py2 Wheel Nov 6, 2017
django-file-picker-0.9.1.tar.gz (198.4 kB) Copy SHA256 Checksum SHA256 Source Nov 6, 2017

Supported By

WebFaction WebFaction Technical Writing Elastic Elastic Search Pingdom Pingdom Monitoring Dyn Dyn DNS Sentry Sentry Error Logging CloudAMQP CloudAMQP RabbitMQ Heroku Heroku PaaS Kabu Creative Kabu Creative UX & Design Fastly Fastly CDN DigiCert DigiCert EV Certificate Rackspace Rackspace Cloud Servers DreamHost DreamHost Log Hosting