Ticket #17016: model_file_uploads.diff

AUTHORS

@@ -550 +550 @@
     Gasper Zejn <zejn@kiberpipa.org>
     Jarek Zgoda <jarek.zgoda@gmail.com>
     Cheng Zhang
+    Tim Saylor <tim.saylor@gmail.com>
 
 A big THANK YOU goes to:
 

docs/topics/http/file-uploads.txt

@@ -179 +179 @@
         Which means "try to upload to memory first, then fall back to temporary
         files."
 
+Handling uploaded files with a model
+------------------------------------
+
+If you're saving a file from a standard form into a :class:`FileField` on a 
+model, the process is much easier. The :class:`FileField` accepts the parameter 
+'upload_to', which tells the model where to store your file. In the view, you 
+can simply assign the file object from reqeust.FILES to the file field in the
+model and the file will be saved to disk in the location specified by the 
+'upload_to' parameter::
+
+    from django.http import HttpResponseRedirect
+    from django.shortcuts import render_to_response
+    from models import ModelWithFileField
+
+    def upload_file(request):
+        if request.method == 'POST':
+            form = UploadFileForm(request.POST, request.FILES)
+            if form.is_valid():
+                instance = ModelWithFileField(file_field=request.FILES['file'])
+                instance.save()
+                return HttpResponseRedirect('/success/url/')
+        else:
+            form = UploadFileForm()
+        return render_to_response('upload.html', {'form': form})
+
 ``UploadedFile`` objects
 ========================