jFormsControlUpload2
extends jFormsControl
in package
base class for all jforms control.
Tags
Table of Contents
- $accept : mixed
- $alertInvalid : string
- $alertRequired : string
- $capture : mixed
- $datatype : jDatatype
- $defaultValue : mixed
- $emptyValueLabel : string
- $fileInfo : mixed
- $help : string
- $hint : string
- $initialActivation : bool
- $initialReadOnly : bool
- $label : string
- $maxsize : mixed
- $mimetype : mixed
- $ref : string
- $required : bool
- $type : string
- $attributes : array<string|int, mixed>
- $container : jFormsDataContainer
- $error : mixed
- $form : jFormsBase
- $modified : mixed
- __construct() : mixed
- check() : null|int
- check and filter the value of the control.
- deactivate() : mixed
- deleteFile() : mixed
- delete the current file indicated into the control
- getAttribute() : mixed
- getDisplayValue() : mixed
- getNewFile() : string
- The filename of the file uploaded during the form submission
- getOriginalFile() : string
- the filename sets into the form during its initialization
- getTempFile() : mixed
- getUniqueFileName() : string
- Return a filename under which the file can be saved without overwriting an existing file.
- getWidgetType() : string
- isActivated() : bool
- check if the control is activated.
- isContainer() : mixed
- says if the control can have multiple values.
- isHtmlContent() : mixed
- says if the content is html or not.
- isModified() : mixed
- isReadOnly() : bool
- check if the control is readonly.
- saveFile() : bool
- Save the uploaded file into the given directory, under the original filename, or under the name given into $alternateName
- setAttribute() : mixed
- setData() : mixed
- setDataFromDao() : mixed
- setForm() : mixed
- setNewFile() : void
- Change the name of the new file name. If there is already an uploaded file, it is deleted
- setReadOnly() : mixed
- setValueFromRequest() : mixed
- _diffValues() : bool
- deleteNewFile() : mixed
- isUploadedFile() : mixed
- moveUploadedFile() : mixed
- processNewFile() : mixed
- processUpload() : mixed
Properties
$accept
public
mixed
$accept
= ''
Tags
$alertInvalid
public
string
$alertInvalid
= ''
the message when the value is invalid
Tags
$alertRequired
public
string
$alertRequired
= ''
the message when there is no value and it is required
Tags
$capture
public
mixed
$capture
= ''
Tags
$datatype
public
jDatatype
$datatype
the object that manage constraints on the value
Tags
$defaultValue
public
mixed
$defaultValue
= ''
the value when the form is created (and not initialized by a data source
Tags
$emptyValueLabel
public
string
$emptyValueLabel
label displayed when only values are displayed, and when there is no value
Tags
$fileInfo
public
mixed
$fileInfo
= array()
Tags
$help
public
string
$help
= ''
the message for the help on the control (typically help displayed in a popup)
Tags
$hint
public
string
$hint
= ''
the message for tips on the control (typically the tooltip value)
Tags
$initialActivation
public
bool
$initialActivation
= \true
Tags
$initialReadOnly
public
bool
$initialReadOnly
= \false
indicate if the control is in read only mode
Tags
$label
public
string
$label
= ''
the label
Tags
$maxsize
public
mixed
$maxsize
= 0
Tags
$mimetype
public
mixed
$mimetype
= array()
Tags
$ref
public
string
$ref
= ''
the identifiant of the control
Tags
$required
public
bool
$required
= \false
true if the control should be filled by the user
Tags
$type
public
string
$type
= 'upload'
a type name that identify the control type
Tags
$attributes
protected
array<string|int, mixed>
$attributes
= array()
miscellaneous values attached to the control
Tags
$container
protected
jFormsDataContainer
$container
content all values of the form
Tags
$error
protected
mixed
$error
Tags
$form
protected
jFormsBase
$form
the form object
Tags
$modified
protected
mixed
$modified
= \false
Tags
Methods
__construct()
public
__construct(string $ref) : mixed
Parameters
- $ref : string
-
the identifiant of the control
Tags
Return values
mixed —check()
check and filter the value of the control.
public
check() : null|int
It is the responsability of the implementation to fill the "errors" or "data" properties of the container.
Tags
Return values
null|int —null if it is ok, or one of jForms::ERRDATA_* constants when there is an error
deactivate()
public
deactivate([mixed $deactivation = true ]) : mixed
Parameters
- $deactivation : mixed = true
Tags
Return values
mixed —deleteFile()
delete the current file indicated into the control
public
deleteFile(string $directoryPath) : mixed
Parameters
- $directoryPath : string
-
the directory where the file is supposed to be stored
Tags
Return values
mixed —getAttribute()
public
getAttribute(mixed $name) : mixed
Parameters
- $name : mixed
Tags
Return values
mixed —getDisplayValue()
public
getDisplayValue(mixed $value) : mixed
Parameters
- $value : mixed
Tags
Return values
mixed —getNewFile()
The filename of the file uploaded during the form submission
public
getNewFile() : string
Tags
Return values
string —getOriginalFile()
the filename sets into the form during its initialization
public
getOriginalFile() : string
Tags
Return values
string —getTempFile()
public
getTempFile(mixed $file) : mixed
Parameters
- $file : mixed
Tags
Return values
mixed —getUniqueFileName()
Return a filename under which the file can be saved without overwriting an existing file.
public
getUniqueFileName(string $directoryPath[, string $alternateName = '' ]) : string
The base name of the file is the name of the uploaded file, or the name given into the $alternateName parameter. The returning filename can be ended by a number if there is already a file with the original name.
Parameters
- $directoryPath : string
-
the directory where the file is supposed to be stored
- $alternateName : string = ''
Tags
Return values
string —the filename
getWidgetType()
public
getWidgetType() : string
Tags
Return values
string —the default widget type to use to render the control
isActivated()
check if the control is activated.
public
isActivated() : bool
Tags
Return values
bool —true if it is activated
isContainer()
says if the control can have multiple values.
public
isContainer() : mixed
Tags
Return values
mixed —isHtmlContent()
says if the content is html or not.
public
isHtmlContent() : mixed
Tags
Return values
mixed —isModified()
public
isModified() : mixed
Tags
Return values
mixed —isReadOnly()
check if the control is readonly.
public
isReadOnly() : bool
Tags
Return values
bool —true if it is readonly
saveFile()
Save the uploaded file into the given directory, under the original filename, or under the name given into $alternateName
public
saveFile(string $directoryPath[, string $alternateName = '' ][, mixed $deletePreviousFile = true ]) : bool
If there is already a file with that name, it will be overwritten. If you don't want this behavior, you can call getUniqueFileName to have a unique name.
This method should be idempotent.
Parameters
- $directoryPath : string
-
the directory where the file is supposed to be stored
- $alternateName : string = ''
- $deletePreviousFile : mixed = true
Tags
Return values
bool —setAttribute()
public
setAttribute(mixed $name, mixed $value) : mixed
Parameters
- $name : mixed
- $value : mixed
Tags
Return values
mixed —setData()
public
setData(mixed $value) : mixed
Parameters
- $value : mixed
Tags
Return values
mixed —setDataFromDao()
public
setDataFromDao(mixed $value, mixed $daoDatatype) : mixed
Parameters
- $value : mixed
- $daoDatatype : mixed
Tags
Return values
mixed —setForm()
public
setForm(mixed $form) : mixed
Parameters
- $form : mixed
Tags
Return values
mixed —setNewFile()
Change the name of the new file name. If there is already an uploaded file, it is deleted
public
setNewFile(string $fileName) : void
Parameters
- $fileName : string
Tags
Return values
void —setReadOnly()
public
setReadOnly([mixed $r = true ]) : mixed
Parameters
- $r : mixed = true
Tags
Return values
mixed —setValueFromRequest()
public
setValueFromRequest(jRequest $request) : mixed
Parameters
- $request : jRequest
Tags
Return values
mixed —_diffValues()
protected
_diffValues(mixed &$v1, mixed &$v2) : bool
Parameters
- $v1 : mixed
- $v2 : mixed
Tags
Return values
bool —true if the values are not equals
deleteNewFile()
protected
deleteNewFile() : mixed
Tags
Return values
mixed —isUploadedFile()
protected
isUploadedFile(mixed $file) : mixed
Parameters
- $file : mixed
Tags
Return values
mixed —moveUploadedFile()
protected
moveUploadedFile(mixed $file, mixed $target) : mixed
Parameters
- $file : mixed
- $target : mixed
Tags
Return values
mixed —processNewFile()
protected
processNewFile(mixed $fileInfo) : mixed
Parameters
- $fileInfo : mixed
Tags
Return values
mixed —processUpload()
protected
processUpload(mixed $action, mixed $fileInfo) : mixed
Parameters
- $action : mixed
- $fileInfo : mixed