1. class
  2. Poppy
  3. \
  4. MgrPage
  5. \
  6. Classes
  7. \
  8. Form
  9. \
  10. _Back
  11. \
  12. MultipleFile

MultipleFile

class MultipleFile extends Field

Traits

UploadField
Macroable

Constants

FILE_DELETE_FLAG

FILE_SORT_FLAG

Properties

array|Closure $creationRules

The validation rules for creation.

 from  Field
array|Closure $updateRules

The validation rules for updates.

 from  Field
bool $isJsonType from  Field
protected array|string $id

Element id.

 from  Field
protected mixed $value

Element value.

 from  Field
protected mixed $data

Data of all original columns of value.

 from  Field
protected mixed $original

Field original value.

 from  Field
protected mixed $default

Field default value.

 from  Field
protected string $label

Element label.

 from  Field
protected string|array $column

Column name.

 from  Field
protected string $elementName

Form element name.

 from  Field
protected array $elementClass

Form element classes.

 from  Field
protected array $variables

Variables of elements.

 from  Field
protected array $options

Options for specify elements.

 from  Field
protected array $checked

Checked for specify elements.

 from  Field
protected array|Closure $rules

Validation rules.

 from  Field
protected Closure $validator from  Field
protected array $validationMessages

Validation messages.

 from  Field
protected array $attributes

Element attributes.

 from  Field
protected Form $form

Parent form.

 from  Field
protected string $view

View for field to render.

 from  Field
protected array $help

Help block.

 from  Field
protected mixed $errorKey

Key for errors.

 from  Field
protected string|array $placeholder

Placeholder for this field.

 from  Field
protected bool $showHelp from  Field
protected array $width

Width for label and field.

 from  Field
protected bool $horizontal

If the form horizontal layout.

 from  Field
protected Closure $customFormat

column data format.

 from  Field
protected bool $display from  Field
protected array $labelClass from  Field
protected array $groupClass from  Field
protected Closure $callback from  Field
protected string $directory

Upload directory.

 from  UploadField
protected null $name

File name.

 from  UploadField
protected Filesystem $storage

Storage instance.

 from  UploadField
protected bool $useUniqueName

If use unique name to store upload file.

 from  UploadField
protected bool $useSequenceName

If use sequence name to store upload file.

 from  UploadField
protected bool $retainable

Retain file when delete record from DB.

 from  UploadField
protected bool $downloadable from  UploadField
protected array $fileActionSettings

Configuration for setting up file actions for newly selected file thumbnails in the preview window.

 from  UploadField
protected string $storagePermission

Controls the storage permission. Could be 'private' or 'public'.

 from  UploadField
protected array $fileTypes from  UploadField

Methods

__construct($column, array $arguments = [])

Create a new File instance.

$this
setElementName(string $name)

Set form element name.

from  Field
void
fill(array $data)

Fill data to the field.

from  Field
$this
customFormat(Closure $call)

custom format form column data when edit.

from  Field
void
setOriginal(array $data)

Set original value to the field.

from  Field
$this
setForm(Form $form = null)

No description

from  Field
$this
setWidth(int $field = 8, int $label = 2)

Set width for field and label.

from  Field
$this
options(array $options = [])

Set options for file-upload plugin.

from  UploadField
$this
checked(array $checked = [])

Set the field option checked.

from  Field
$this
rules(array $rules = [], array $messages = [])

Set the validation rules for the field.

from  Field
$this
updateRules(array|callable $rules = [], array $messages = [])

Set the update validation rules for the field.

from  Field
$this
creationRules(array|callable $rules = [], array $messages = [])

Set the creation validation rules for the field.

from  Field
array|mixed
getValidationMessages()

Get validation messages for the field.

from  Field
$this
setValidationMessages(string $key, array $messages)

Set validation messages for column.

from  Field
$this
validator(callable $validator)

Set field validator.

from  Field
string
getErrorKey()

Get key for error message.

from  Field
$this
setErrorKey(string $key)

Set key for error message.

from  Field
mixed
value(null $value = null)

Set or get value of the field.

from  Field
$this
data(array $data = null)

Set or get data.

from  Field
$this
default($default)

Set default value for field.

from  Field
mixed
getDefault()

Get default value.

from  Field
$this
help(string $text = '', string $icon = 'fa-info-circle')

Set help block for current field.

from  Field
string|array
column()

Get column of the field.

from  Field
string
label()

Get label of the field.

from  Field
mixed
original()

No description

bool|Validator|mixed
getValidator(array $input)

No description

$this
attribute(array|string $attribute, mixed $value = null)

Add html attributes to elements.

from  Field
$this
style(string $attr, string $value)

Set Field style.

from  Field
$this
width(string $width)

Set Field width.

from  Field
$this
autofocus()

Set the field automatically get focus.

from  Field
$this
readonly()

Set the field as readonly mode.

from  Field
$this
disable()

Set field as disabled.

from  Field
$this
placeholder(string $placeholder = '')

Set field placeholder.

from  Field
string
getPlaceholder()

Get placeholder.

from  Field
mixed
prepare(UploadedFile|array $files)

Prepare for saving.

$this
disableHorizontal()

No description

from  Field
array
getViewElementClasses()

No description

from  Field
array
getElementClass()

Get element class.

from  Field
$this
setElementClass(string|array $class)

Set form element class.

from  Field
$this
addElementClass($class)

Add the element class.

from  Field
$this
removeElementClass($class)

Remove element class.

from  Field
$this
resetElementClassName(string $className, string $resetClassName)

reset field className.

from  Field
string
getLabelClass()

No description

from  Field
Field
setLabelClass(array $labelClass)

No description

from  Field
array
variables()

Get the view variables of this field.

from  Field
string
getView()

Get view of this field.

from  Field
string
setView(string $view)

Set view of current field.

from  Field
string
getType()

No description

from  Field
$this
setDisplay(bool $display)

To set this field should render or not.

from  Field
Field
with(Closure $callback)

No description

from  Field
Factory|View|string
render()

Render file upload field.

string
__toString()

No description

from  Field
string
getRules()

Get field validation rules.

from  Field
array|mixed|string
formatName(string $column)

Format the name of the field.

from  Field
array
skeleton()

No description

from  Field
mixed
formatColumn(string $column = '')

Format the field column name.

from  Field
string|array
formatId(string|array $column)

Format the field element id.

from  Field
string
formatLabel(array $arguments = [])

Format the label value.

from  Field
formatValue()

Format value by passing custom formater.

from  Field
addRequiredAttribute(array $rules)

Add required attribute to current field if has required rule, except file and image fields.

from  Field
addRequiredAttributeFromRules()

If has required rule, add required attribute to this field.

from  Field
array
formatRules(array|string $rules)

Format validation rules.

from  Field
array|Closure
mergeRules(string|array|Closure $input, string|array $original)

No description

from  Field
void
removeRule(string $rule)

Remove a specific rule by keyword.

from  Field
array
sanitizeInput(array $input, string $column)

Sanitize input data.

from  Field
string
formatAttributes()

Format the field attributes.

from  Field
mixed
getElementClassString()

Get element class string.

from  Field
string|array
getElementClassSelector()

Get element class selector.

from  Field
string
getGroupClass(bool $default = false)

Get element class.

from  Field
Field
setGroupClass(string|array $class)

Set form group class.

from  Field
Field
addVariables(array $variables = [])

Add variables to field view.

from  Field
bool
shouldRender()

If this field should render.

from  Field
$this
downloadable(bool $downloadable = true)

Indicates if the underlying field is downloadable.

from  UploadField
$this
removable()

Allow use to remove file.

from  UploadField
$this
retainable($retainable = true)

Indicates if the underlying field is retainable.

from  UploadField
$this
disk(string $disk)

Set disk for storage.

from  UploadField
$this
move(string $directory, null|string $name = null)

Specify the directory and name for upload file.

from  UploadField
$this
dir(string $dir)

Specify the directory upload file.

from  UploadField
$this
name(string|callable $name)

Set name of store name.

from  UploadField
$this
uniqueName()

Use unique name for store upload file.

from  UploadField
$this
sequenceName()

Use sequence name for store upload file.

from  UploadField
mixed|string
getDirectory()

Get directory for store file.

from  UploadField
void
renameIfExists(UploadedFile $file)

If name already exists, rename it.

from  UploadField
string
objectUrl($path)

Get file visit url.

from  UploadField
destroy(string $key)

Destroy original files.

$this
storagePermission(string $permission)

Set file permission when stored into storage.

from  UploadField
initStorage()

Initialize the storage instance.

from  UploadField
void
setupDefaultOptions()

Set default options form image field.

from  UploadField
void
setupPreviewOptions()

Set preview options form image field.

from  UploadField
array|bool
guessPreviewType($file)

No description

from  UploadField
string
getStoreName(UploadedFile $file)

Get store name of upload file.

from  UploadField
mixed
upload(UploadedFile $file)

Upload file and delete original file.

from  UploadField
string
generateUniqueName(UploadedFile $file)

Generate a unique name for uploaded file.

from  UploadField
string
generateSequenceName(UploadedFile $file)

Generate a sequence name for uploaded file.

from  UploadField
mixed
defaultDirectory()

Default directory for file to upload.

array
hydrateFiles(array $value)

Hydrate the files array.

array
sortFiles(string $order)

Sort files.

mixed|string
prepareForeach(UploadedFile $file = null)

Prepare for each file.

array
preview()

Preview html for file-upload plugin.

string
initialCaption(array $caption)

Initialize the caption.

array
initialPreviewConfig()

No description

$this
sortable()

Allow to sort files.

Details

at line 24
__construct($column, array $arguments = [])

Create a new File instance.

Parameters

$column
array $arguments

in Field at line 245
$this setElementName(string $name)

Set form element name.

Parameters

string $name

Return Value

$this

in Field at line 259
void fill(array $data)

Fill data to the field.

Parameters

array $data

Return Value

void

in Field at line 283
$this customFormat(Closure $call)

custom format form column data when edit.

Parameters

Closure $call

Return Value

$this

in Field at line 297
void setOriginal(array $data)

Set original value to the field.

Parameters

array $data

Return Value

void

in Field at line 315
$this setForm(Form $form = null)

No description

Parameters

Form $form

Return Value

$this

in Field at line 330
$this setWidth(int $field = 8, int $label = 2)

Set width for field and label.

Parameters

int $field
int $label

Return Value

$this

in UploadField at line 142
$this options(array $options = [])

Set options for file-upload plugin.

Parameters

array $options

Return Value

$this

in Field at line 365
$this checked(array $checked = [])

Set the field option checked.

Parameters

array $checked

Return Value

$this

in Field at line 384
$this rules(array $rules = [], array $messages = [])

Set the validation rules for the field.

Parameters

array $rules
array $messages

Return Value

$this

in Field at line 401
$this updateRules(array|callable $rules = [], array $messages = [])

Set the update validation rules for the field.

Parameters

array|callable $rules
array $messages

Return Value

$this

in Field at line 418
$this creationRules(array|callable $rules = [], array $messages = [])

Set the creation validation rules for the field.

Parameters

array|callable $rules
array $messages

Return Value

$this

in Field at line 432
array|mixed getValidationMessages()

Get validation messages for the field.

Return Value

array|mixed

in Field at line 455
$this setValidationMessages(string $key, array $messages)

Set validation messages for column.

Parameters

string $key
array $messages

Return Value

$this

in Field at line 469
$this validator(callable $validator)

Set field validator.

Parameters

callable $validator

Return Value

$this

in Field at line 481
string getErrorKey()

Get key for error message.

Return Value

string

in Field at line 493
$this setErrorKey(string $key)

Set key for error message.

Parameters

string $key

Return Value

$this

in Field at line 507
mixed value(null $value = null)

Set or get value of the field.

Parameters

null $value

Return Value

mixed

in Field at line 523
$this data(array $data = null)

Set or get data.

Parameters

array $data

Return Value

$this

in Field at line 541
$this default($default)

Set default value for field.

Parameters

$default

Return Value

$this

in Field at line 553
mixed getDefault()

Get default value.

Return Value

mixed

in Field at line 570
$this help(string $text = '', string $icon = 'fa-info-circle')

Set help block for current field.

Parameters

string $text
string $icon

Return Value

$this

in Field at line 582
string|array column()

Get column of the field.

Return Value

string|array

in Field at line 592
string label()

Get label of the field.

Return Value

string

at line 140
mixed original()

No description

Return Value

mixed

at line 44
bool|Validator|mixed getValidator(array $input)

No description

Parameters

array $input

Return Value

bool|Validator|mixed

in Field at line 655
$this attribute(array|string $attribute, mixed $value = null)

Add html attributes to elements.

Parameters

array|string $attribute
mixed $value

Return Value

$this

in Field at line 675
$this style(string $attr, string $value)

Set Field style.

Parameters

string $attr
string $value

Return Value

$this

in Field at line 687
$this width(string $width)

Set Field width.

Parameters

string $width

Return Value

$this

in Field at line 697
$this autofocus()

Set the field automatically get focus.

Return Value

$this

in Field at line 707
$this readonly()

Set the field as readonly mode.

Return Value

$this

in Field at line 717
$this disable()

Set field as disabled.

Return Value

$this

in Field at line 729
$this placeholder(string $placeholder = '')

Set field placeholder.

Parameters

string $placeholder

Return Value

$this

in Field at line 741
string getPlaceholder()

Get placeholder.

Return Value

string

at line 122
mixed prepare(UploadedFile|array $files)

Prepare for saving.

Parameters

UploadedFile|array $files

Return Value

mixed

in Field at line 763
$this disableHorizontal()

No description

Return Value

$this

in Field at line 773
array getViewElementClasses()

No description

Return Value

array

in Field at line 795
array getElementClass()

Get element class.

Return Value

array

in Field at line 807
$this setElementClass(string|array $class)

Set form element class.

Parameters

string|array $class

Return Value

$this

in Field at line 821
$this addElementClass($class)

Add the element class.

Parameters

$class

Return Value

$this

in Field at line 837
$this removeElementClass($class)

Remove element class.

Parameters

$class

Return Value

$this

in Field at line 862
$this resetElementClassName(string $className, string $resetClassName)

reset field className.

Parameters

string $className
string $resetClassName

Return Value

$this

in Field at line 874
string getLabelClass()

No description

Return Value

string

in Field at line 884
Field setLabelClass(array $labelClass)

No description

Parameters

array $labelClass

Return Value

Field

in Field at line 896
array variables()

Get the view variables of this field.

Return Value

array

in Field at line 921
string getView()

Get view of this field.

Return Value

string

in Field at line 939
string setView(string $view)

Set view of current field.

Parameters

string $view

Return Value

string

in Field at line 946
string getType()

No description

Return Value

string

in Field at line 959
$this setDisplay(bool $display)

To set this field should render or not.

Parameters

bool $display

Return Value

$this

in Field at line 971
Field with(Closure $callback)

No description

Parameters

Closure $callback

Return Value

Field

at line 233
Factory|View|string render()

Render file upload field.

Return Value

Factory|View|string

in Field at line 1000
string __toString()

No description

Return Value

string

Exceptions

Throwable

in Field at line 1010
string getRules()

Get field validation rules.

Return Value

string

in Field at line 1056
array|mixed|string formatName(string $column)

Format the name of the field.

Parameters

string $column

Return Value

array|mixed|string

in Field at line 1090
array skeleton()

No description

Return Value

array

in Field at line 1102
protected mixed formatColumn(string $column = '')

Format the field column name.

Parameters

string $column

Return Value

mixed

in Field at line 1120
protected string|array formatId(string|array $column)

Format the field element id.

Parameters

string|array $column

Return Value

string|array

in Field at line 1132
protected string formatLabel(array $arguments = [])

Format the label value.

Parameters

array $arguments

Return Value

string

in Field at line 1144
protected formatValue()

Format value by passing custom formater.

in Field at line 1157
protected addRequiredAttribute(array $rules)

Add required attribute to current field if has required rule, except file and image fields.

Parameters

array $rules

in Field at line 1167
protected addRequiredAttributeFromRules()

If has required rule, add required attribute to this field.

in Field at line 1188
protected array formatRules(array|string $rules)

Format validation rules.

Parameters

array|string $rules

Return Value

array

in Field at line 1203
protected array|Closure mergeRules(string|array|Closure $input, string|array $original)

No description

Parameters

string|array|Closure $input
string|array $original

Return Value

array|Closure

in Field at line 1226
protected void removeRule(string $rule)

Remove a specific rule by keyword.

Parameters

string $rule

Return Value

void

in Field at line 1249
protected array sanitizeInput(array $input, string $column)

Sanitize input data.

Parameters

array $input
string $column

Return Value

array

in Field at line 1264
protected string formatAttributes()

Format the field attributes.

Return Value

string

in Field at line 1280
protected mixed getElementClassString()

Get element class string.

Return Value

mixed

in Field at line 1303
protected string|array getElementClassSelector()

Get element class selector.

Return Value

string|array

in Field at line 1327
protected string getGroupClass(bool $default = false)

Get element class.

Parameters

bool $default

Return Value

string

in Field at line 1339
Field setGroupClass(string|array $class)

Set form group class.

Parameters

string|array $class

Return Value

Field

in Field at line 1358
protected Field addVariables(array $variables = [])

Add variables to field view.

Parameters

array $variables

Return Value

Field

in Field at line 1373
protected bool shouldRender()

If this field should render.

Return Value

bool

in UploadField at line 104
$this downloadable(bool $downloadable = true)

Indicates if the underlying field is downloadable.

Parameters

bool $downloadable

Return Value

$this

in UploadField at line 116
$this removable()

Allow use to remove file.

Return Value

$this

in UploadField at line 128
$this retainable($retainable = true)

Indicates if the underlying field is retainable.

Parameters

$retainable

Return Value

$this

in UploadField at line 158
$this disk(string $disk)

Set disk for storage.

Parameters

string $disk

Disks defined in config/filesystems.php.

Return Value

$this

Exceptions

Exception

in UploadField at line 181
$this move(string $directory, null|string $name = null)

Specify the directory and name for upload file.

Parameters

string $directory
null|string $name

Return Value

$this

in UploadField at line 197
$this dir(string $dir)

Specify the directory upload file.

Parameters

string $dir

Return Value

$this

in UploadField at line 213
$this name(string|callable $name)

Set name of store name.

Parameters

string|callable $name

Return Value

$this

in UploadField at line 227
$this uniqueName()

Use unique name for store upload file.

Return Value

$this

in UploadField at line 239
$this sequenceName()

Use sequence name for store upload file.

Return Value

$this

in UploadField at line 251
mixed|string getDirectory()

Get directory for store file.

Return Value

mixed|string

in UploadField at line 267
void renameIfExists(UploadedFile $file)

If name already exists, rename it.

Parameters

UploadedFile $file

Return Value

void

in UploadField at line 281
string objectUrl($path)

Get file visit url.

Parameters

$path

Return Value

string

at line 254
destroy(string $key)

Destroy original files.

Parameters

string $key

in UploadField at line 321
$this storagePermission(string $permission)

Set file permission when stored into storage.

Parameters

string $permission

Return Value

$this

in UploadField at line 333
protected initStorage()

Initialize the storage instance.

in UploadField at line 343
protected void setupDefaultOptions()

Set default options form image field.

Return Value

void

in UploadField at line 376
protected void setupPreviewOptions()

Set preview options form image field.

Return Value

void

in UploadField at line 386
protected array|bool guessPreviewType($file)

No description

Parameters

$file

Return Value

array|bool

in UploadField at line 422
protected string getStoreName(UploadedFile $file)

Get store name of upload file.

Parameters

UploadedFile $file

Return Value

string

in UploadField at line 450
protected mixed upload(UploadedFile $file)

Upload file and delete original file.

Parameters

UploadedFile $file

Return Value

mixed

in UploadField at line 468
protected string generateUniqueName(UploadedFile $file)

Generate a unique name for uploaded file.

Parameters

UploadedFile $file

Return Value

string

in UploadField at line 480
protected string generateSequenceName(UploadedFile $file)

Generate a sequence name for uploaded file.

Parameters

UploadedFile $file

Return Value

string

at line 36
mixed defaultDirectory()

Default directory for file to upload.

Return Value

mixed

at line 78
protected array hydrateFiles(array $value)

Hydrate the files array.

Parameters

array $value

Return Value

array

at line 101
protected array sortFiles(string $order)

Sort files.

Parameters

string $order

Return Value

array

at line 156
protected mixed|string prepareForeach(UploadedFile $file = null)

Prepare for each file.

Parameters

UploadedFile $file

Return Value

mixed|string

at line 170
protected array preview()

Preview html for file-upload plugin.

Return Value

array

at line 184
protected string initialCaption(array $caption)

Initialize the caption.

Parameters

array $caption

Return Value

string

at line 198
protected array initialPreviewConfig()

No description

Return Value

array

at line 221
$this sortable()

Allow to sort files.

Return Value

$this