InputfieldFile

getDisplayBasename(Pagefile $pagefile, $maxLength = 25)

Return a basename for display in the file list. Long names are shortened unless noShortName is true.

$name = $f->getDisplayBasename($pagefile);

getWireUpload()

Return the current WireUpload instance, creating it on first call. This is most useful for inspecting upload errors after processing.

$upload = $f->getWireUpload();
foreach($upload->getErrors() as $error) {
    $log->save('uploads', $error);
}

isEmpty()

Return true when the value contains no files.

if($f->isEmpty()) {
    echo "No files uploaded.";
}

getItemInputfields(?Pagefile $item = null)

Return an InputfieldWrapper containing custom fields configured for the Pagefile field's template. Pass a Pagefile to populate values for that item, or omit the argument to prepare those inputs for render-ready state.

$inputfields = $f->getItemInputfields($pagefile);
if($inputfields) echo $inputfields->render();

Returns false when the underlying file field has no custom fields template or when the current value cannot provide one.

setMaxFilesize($filesize)

Set the maximum file size in bytes. Accepts an integer or shorthand strings like '30m', '2g', or '500k'. The stored value is capped to PHP's upload_max_filesize.

$f->setMaxFilesize('50m');
$f->setMaxFilesize(1048576);

$wire->addHookAfter('InputfieldFile::fileAdded', function(HookEvent $event) {
    $pagefile = $event->arguments(0); /** @var Pagefile $pagefile */
    if(!$pagefile->description) {
        $name = pathinfo($pagefile->name, PATHINFO_FILENAME);
        $pagefile->description = ucwords(str_replace(['-', '_'], ' ', $name));
    }
});

$wire->addHookBefore('InputfieldFile::processInput', function(HookEvent $event) {
    $inputfield = $event->object; /** @var InputfieldFile $inputfield */
    if($inputfield->name === 'documents') {
        $inputfield->extensions = 'pdf docx';
    }
});

• Adding InputfieldFile to an InputfieldForm with method=post automatically sets the form enctype to multipart/form-data.
• renderUpload() appends [] to the file input name when the name does not already end with ].
• AJAX uploads are enabled by default. Set noAjax=1 to render without the drag-and-drop target.
• unzip=1 adds zip to the allowed extensions only when maxFiles=0.
• maxFiles=1 allows replacement of the current file and sets the upload max to one file.
• Overwrite mode preserves existing description, tags, and filedata where possible, and refuses overwrites that would replace a file owned by another field on the same page.
• Tags use FieldtypeFile constants: useTagsOff, useTagsNormal, useTagsPredefined, or useTagsNormal | useTagsPredefined.
• Pagefile custom fields are configured through the file field's template. Use getItemInputfields() only when the value has a real Page/Field context.
• InputfieldImage extends this class and adds image-specific rendering, editing, focus point, and variation behavior.

Source file: wire/modules/Inputfield/InputfieldFile/InputfieldFile.module