This project is no longer maintained and no further public releases are planned.

No further support will be given.

Feel free to fork the git repository.

Finisher\StoreUploadedFiles

Moves uploaded files from the temporary folder to a new one and renames them if so configured.

Version added

1.0.0

TypoScript path

plugin.Tx_Formhandler.settings.finishers.x copy to clipboard

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