Django file form

Django-file-form helps you to write forms with a pretty ajax upload.

Features:

• You can easily add an ajax file-upload to a form.
• The ajax upload works the same as an html upload.
  • This means that you don't have to change your code to support ajax upload.
• Supports single and multiple file upload.

The project is hosted on github.

Works with Django 1.11 - 2.1. Also with Python 2.7, 3.5 - 3.7

Note that version 0.3.0 also supports Django 1.8 - 1.10.

Usage

1 Install django-file-form

pip install django-file-form

2 Add the apps to your INSTALLED_APPS

You must include 'django_file_form' and 'django_file_form.ajaxuploader'

INSTALLED_APPS = [
    'django_file_form',
    'django_file_form.ajaxuploader',
]

3 Add the app to your urls

In this example we use the url upload/. You can use a different url if you like.

urlpatterns = patterns(
    '',
    url(r'^upload/', include('django_file_form.urls')),
)

4 Add FileFormMixin to your form

from django_file_form.forms import FileFormMixin

class ExampleForm(FileFormMixin, forms.Form):
    pass

5 Add a UploadedFileField

from django_file_form.forms import FileFormMixin, UploadedFileField

class ExampleForm(FileFormMixin, forms.Form):
    input_file = UploadedFileField()

6 Include javascript and css in your template

<script src="{% static "ajaxuploader/js/fileuploader.js" %}"></script>
<script src="{% static "file_form/file_form.js" %}"></script>
<link rel="stylesheet" href="{% static "ajaxuploader/css/fileuploader.css" %}">

You must also include jquery

7 Call the initUploadFields javascript function

<form id="example-form" method="POST" enctype="multipart/form-data">
    {% csrf_token %}
    {{ form }}
</form>

<script>
   $(function() {
       initUploadFields($('#example-form'));
   });
</script>

8 Include the upload_template.html in your template

{% include 'django_file_form/upload_template.html' %}

9 Handle uploaded files

class ExampleFormView(generic.FormView):
    template_name = 'example_form.html'
    form_class = forms.ExampleForm

    def form_valid(self, form):
        input_file = form.cleaned_data['input_file']

        return super(ExampleFormView, self).form_valid(form)

10 Delete temporary files

class ExampleFormView(generic.FormView):
    template_name = 'example_form.html'
    form_class = forms.ExampleForm

    def form_valid(self, form):
        input_file = form.cleaned_data['input_file']

        form.delete_temporary_files()

        return super(ExampleFormView, self).form_valid(form)

Also see the testproject in the repository.

Settings

Settings in settings.py:

• FILE_FORM_MUST_LOGIN (True / False):

  • Must the user be logged in to upload a file.
  • The default is False.

• FILE_FORM_UPLOAD_DIR (string):

  • The directory for the temporary uploads.
  • The setting is not full path, but must be a subdirectory of MEDIA_ROOT.
  • The default is temp_uploads.

• FILE_FORM_FILE_STORAGE (string):

  • The class that is used to store the temporary uploads.
  • The default is django.core.files.storage.FileSystemStorage.

• FILE_FORM_UPLOAD_BACKEND (string)

  • The class that is used for the upload backend.
  • This makes it possible to write your upload backend.
  • The default is django_file_form.uploader.FileFormUploadBackend.