DCA reference: input type "upload" is not documented

[nkirstein]

The form file upload widget from system/modules/core/forms/FormFileUpload.php has been around for a long time but it never seems to have made it into the DCA documentation. I'd like to suggest the following additions to the DCA reference:

Fields

Key	Value	Description
inputType	Field type (string)	... ... upload File upload

Evaluation

Key	Value	Description
storeFile	true/false (boolean)	If true, the uploaded file will be stored on the server. Applies to upload fields only.
uploadFolder	Path to upload folder (string)	Specifies the folder where uploaded files will be stored. Applies to upload fields only.
useHomeDir	true/false (boolean)	If true, the user's home directory will be used as upload folder. Applies to upload fields only.
doNotOverwrite	true/false (boolean)	If true, existing files of the same name will not be overwritten. Applies to upload fields only.

Actually I'm not totally sure if these options only apply to the "upload" field type. Maybe someone more knowledgeable could check this?

[aschempp]

Be aware that the upload field does only work in the frontend. I think the DCA reference currently refers to the backend configuration. What do you think?

[cliffparnitzky]

Yeap, i agree to @aschempp ... DCA is backend ... die frontend formfield is described in section 4.6 Form fields

[nkirstein]

You're right, I got this mixed up because I'm using the DCA to add an upload form field to the Personal Data frontend module.

[aschempp]

We should add a documentation about these widgets too, but not in the DCA config. Let's keep this open for the API book.