upload()
Create upload field. The form's controls will be buffered and displayed upon calling the display() method. Please note that the HTML code generated leaves you various ways to customize your upload button via CSS (see examples for details).
string upload( string field [, string label [, string directory [, mixed allow [, mixed valid = true [, int usage = 1 [, string value ]]]]]])Return
Buffers and returns HTML code.
Parameter
Description
fieldInput field name
labelInput field caption
directoryThe directory where the uploaded file will be stored
allowFile-extensions i.e. STRING 'txt' or ARRAY ('jpg', 'jpeg', 'png'). We strongly advise to define a list of allowed file-extensions. Uploaded .php files will always be ignored!
validMax. filesize in KILOBYTES or an expression that results in TRUE/FALSE
usage0=store
1=require+store
2=require
1=require+store
2=require
valueManually set field value
Upload JPG
$FORM->upload("upload1", "Upload", "data/", "jpg")RETURN: '<div id="frm_testform_outer_upload1" class="frm_testform div_outer div_upload upload1">
<input id="sys__testform_upload_upload1_id" type="hidden" name="sys__testform_upload_upload1" value="" /><label for="frm_testform_upload1" class="lbl_adapt ...
Upload image with a max. filesize of 5kb
$FORM->upload("upload2", "Upload", "data/", array("jpg", "jpeg", "png"), 5)RETURN: '<div id="frm_testform_outer_upload2" class="frm_testform div_outer div_upload upload2">
<input id="sys__testform_upload_upload2_id" type="hidden" name="sys__testform_upload_upload2" value="" /><label for="frm_testform_upload2" class="lbl_adapt ...
