Skip to main content

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 files for django-file-picker 0.9.1

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for django-file-picker 0.9.1
File Size Uploaded
django-file-picker-0.9.1.tar.gz 198.4 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for django-file-picker 0.9.1
File Interpreter ABI Platform
django_file_picker-0.9.1-py2-none-any.whl Python 2 none any Details

Total release size: 432.1 kB

Release files / django-file-picker-0.9.1.tar.gz

Download URL django-file-picker-0.9.1.tar.gz
Size 198.4 kB
Tags Source
SHA-256 checksum
How to use checksums
1152c0d88b9e4f115302a3affde3391a474aae769492bdeb0aae51f664f26c81
BLAKE2b-256 checksum
How to use checksums
18e2f1986fbae74b45112bd9b062bd9df971610affa61e6377468a4d9b1f5f11
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No

Release files / django_file_picker-0.9.1-py2-none-any.whl

Download URL django_file_picker-0.9.1-py2-none-any.whl
Size 233.7 kB
Tags Python 2
SHA-256 checksum
How to use checksums
3955219d1981f25366d4f06419b5ce5b00bd7be4f959d253d88a78f4ec45abb3
BLAKE2b-256 checksum
How to use checksums
644573db7e40b255673840ed2a3dd0f61371c6fb345706bddcba5ef7a78de03f
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No

Release history Release notifications | RSS feed

This release

0.9.1 This release

2 release files

0.9.0

2 release files

0.8.0

2 release files

0.7.0

2 release files

0.6.0

1 release file

0.5.0

1 release file

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page