mkrecek234/atk4-multiupload

Upload field based on dropdown for uploading multiple files.

3.0.3 2021-10-29 09:47 UTC

Requires

• php: >=7.0.0
• atk4/data: ~3
• atk4/filestore: ~3
• atk4/ui: *

Requires (Dev)

• behat/behat: ^3.4
• behat/mink-extension: ^2.2
• behat/mink-zombie-driver: ^1.4
• fzaninotto/faker: *
• phpunit/phpcov: ^3.0

MIT

• Michael Krecek

• framework
• data
• atk4
• Agile
• agile ui

README

ATK UI implements a high-level User Interface for Web App - such as Admin System. One of the most common things for the Admin system is a log-in screen.

This add-on will provide a) an upload field that allows to upload multiple files at once or sequentially and b) a sample integration in atk4/filestore.

Installation

Install through composer composer require mkrecek234/multiupload

Usage

Simply add the multiupload field in your form like this.

$control = $form->addControl('file', [\atk4\multiupload\MultiUpload::class,
    'empty'      => 'Upload multiple files',
    'isMultiple' => true
]
    );
$control->setModel(new \Atk4\Filestore\Model\File($app->db));

The ->setModel command is only required if you want to translate tokens into filenames (here as an example for atk4/filestore integration).

A click on the upload icon performs an upload of one or multiple files. A further click adds further items. A click on the "X" icon removes an individual file. A click on the filename performs an onDownload action. The file tokens are stored as comma-separated values in a single field which is very convenient not requiring child-tables just for attached files.

You will see 2 demos:

1. demos/uploadtest.php to show the standard upload control element
2. demos/uploadtest-filestore.php to show the integration in atk4/filestore.