Forms documentation doesn't describe how to handle uploads
|Reported by:||kylefox||Owned by:||jacob|
|Severity:||Keywords:||docs, forms, files, uploads|
|Has patch:||no||Needs documentation:||no|
|Needs tests:||no||Patch needs improvement:||no|
The general form documentation 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.
" ... a form requires multipart file upload (and hence whether request.FILES must be passed to the form), etc. See Working with Forms for more information."
The documentation for handling form uploads in buried in the 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.
Change History (9)
comment:1 Changed 7 years ago by anonymous
- milestone set to 1.0
- Needs documentation unset
- Needs tests unset
- Patch needs improvement unset
comment:4 Changed 7 years ago by jacob
- milestone set to 1.1
- Triage Stage changed from Unreviewed to Accepted
comment:5 Changed 6 years ago by jacob
- Owner changed from nobody to jacob
- Status changed from new to assigned
Changed 6 years ago by prairiedogg
comment:7 Changed 6 years ago by Alex
- Resolution set to fixed
- Status changed from assigned to closed