tickets: 8857

This data as json

id	created	changetime	last_pulled_from_trac	stage	status	component	type	severity	version	resolution	summary	description	owner	reporter	keywords	easy	has_patch	needs_better_patch	needs_tests	needs_docs	ui_ux
8857	2008-09-03 20:33:39	2011-09-28 16:12:21	2022-03-06 03:43:20.865758	Accepted	closed	Documentation			dev	fixed	Forms documentation doesn't describe how to handle uploads	The general form documentation [http://docs.djangoproject.com/en/dev/topics/forms/ Working with Forms] does not mention how to handle forms that include files. There is no mention of passing `request.FILES` into the Form's constructor, nor of the required `enctype="multipart/form-data"` attribute of the `<form>` tag. However, the "next" article [http://docs.djangoproject.com/en/dev/topics/forms/modelforms/#the-save-method Creating forms from models] refers back to [http://docs.djangoproject.com/en/dev/topics/forms/ Working with Forms] for handling file uploads.: " ... a form requires multipart file upload (and hence whether request.FILES must be passed to the form), etc. See [http://docs.djangoproject.com/en/dev/topics/forms/ Working with Forms] for more information." The documentation for handling form uploads in buried in the [http://docs.djangoproject.com/en/dev/ref/forms/api/#binding-uploaded-files Forms API]. It would be very useful to have this info (or a link to it) in the introductory "Working with forms" document. At the very least, the reference to "Working with forms" from "Creating forms from models" needs to be removed, since the information is not contained there.	jacob	kylefox	docs, forms, files, uploads	0	0	0	0	0	0