Finisher\StoreUploadedFiles
Moves uploaded files from the temporary folder to a new one and renames them if so configured.
Properties
.finishedUploadFolder
Path to store the files at.
New in version 1.4.0: schemeMarkers are replace here too. You can use this to set different upload folders depending on the user input!
Data type
String | cObj
Version added
1.0.0
.createNonExistingFolder
Set to "1" if want to create the upload folder dynamically if it doesn't exist.
Data type
Boolean | cObj
Version added
1.4.0
Important
Use this very carefully as you might create a huge amount of folders!
.disablePathCheck
Formhandler checks if the new path of the file is different from the current path. You can disable the check using this option.
Data type
Boolean | cObj
Version added
2.1.0
Important
Use this very carefully as you might create a huge amount of folders!
.renameScheme
Specifies how to rename the files.
Possbile options
[pid] = The current page id
[md5] = md5 hash over file name
[time] = The submission time stamp
[filename] = Original file name
[field] = The name of the upload field
[xxx] = Your own marker defined in schemeMarkers
Data type
String | cObj
Version added
1.0.0
Example code
renameScheme = [pid]_[filename]
.schemeMarkers
Define your own markers to be used in renameScheme.
You can use any cObject like TEXT or USER to fill the markers or you can use the special keyword "fieldValue" to fill the marker with a value entered in the form.
Data type
Array
Version added
1.0.0
Example code
renameScheme = [mymarker]_[marker2]_[filename] schemeMarkers { mymarker = TEXT mymarker.value = asdf marker2 = fieldValue marker2.field = field1 }
.schemeMarkers.[marker].field
This option is only available if you used the keyword "fieldValue" for the marker. Enter the name of a form field here and the marker is filled with the value of this field.
Data type
String | cObj
Version added
1.1.0
.schemeMarkers.[marker].separator
If the value of the form field specified in field is an array, you can specify a separator used to join the array items.
Data type
String | cObj
Default value
,
Version added
1.4.0