Code Monkey home page Code Monkey logo

filepond's Introduction

FilePond.


php-version PHPUnit PHPUnit Codecov Infection

filepond

Installation

The preferred way to install this extension is through composer.

Either run

composer require --dev --prefer-dist yii2-extensions/filepond

or add

"yii2-extensions/filepond": "dev-main"

to the require-dev section of your composer.json file.

Usage

Name

use Yii2\Extensions\Filepond\FilePond;

echo FilePond::widget(['name' => 'image_file']);

Active Field

use Yii2\Extensions\Filepond\FilePond;

echo $form
    ->field($formModel, 'image_file')
    ->widget(
        FilePond::class,
        [
            'loadFileDefault' => $imageFile,
            'imagePreviewHeight' => 170,
            'imageCropAspectRatio' => '1:1',
        ],
    );

Controller or Model

use Yii2\Extensions\Filepond\FileProcessing;

$imageFile = FileProcessing::saveWithReturningFile(
    $categoryForm->image_file,
    Yii::getAlias('@uploads'),
    "category{$category->id}",
    false
);        

Properties of the widget

Property Type Description Default
acceptedFileTypes string The accepted file types. Can be mime types or wild cards. []
allowFileTypeValidation bool Whether to allow file type validation. true
allowFileRename bool Whether to allow file rename. false
allowFileValidateSize bool Whether to allow file size validation. true
allowImageCrop bool Whether to allow image crop. false
allowImageExifOrientation bool Whether to allow image exif orientation. true
allowImagePreview bool Whether to allow image preview. true
allowImageTransform bool Whether to allow image transform. false
allowMultiple bool Whether to allow multiple files. false
allowpdfPreview bool Whether to allow pdf preview. false
cssClass string The css class of the widget. ''
cdn boolean Whether to use the CDN. true
config array The config of the widget. []
fileRename string The file rename. ''
use: fileRenameFunction: (file) => return my_new_name${file.extension}`;
fileValidateTypeDetectType string The file validate type detect type function. ''
fileValidateTypeLabelExpectedTypes string The file validate type label expected types. ''
imageCropAspectRatio string,null The image crop aspect ratio. null
imagePreviewHeight string,null The image preview height. null
imagePreviewMarkupShow bool Whether to show the image preview markup. true
imagePreviewMaxFileSize string,null The image preview max file size. null
imagePreviewMaxHeight int The image preview max height. 256
imagePreviewMaxInstantPreviewFileSize int The image preview max instant preview file size. 10000000
imagePreviewMinHeight int The image preview min height. 44
imagePreviewTransparencyIndicator string,null The image preview transparency indicator. null
imageTransformAfterCreateBlob array,null The image transform after create blob. null
imageTransformBeforeCreateBlob array,null The image transform before create blob. null
imageTransformOutputQuality int,null The image transform output quality. null
imageTransformClientTransforms array,null The image transform client transforms. null
imageTransformOutputQualityMode string,null The image transform output quality mode. añways
imageTransformOutputStripImageHead bool The image transform output strip image head. true
imageTransformVariants array,null The image transform variants. null
imageTransformVariantsIncludeDefault bool The image transform variants include default. true
imageTransformVariantsDefaultName string,null The image transform variants default name. null
imageTransformVariantsIncludeOriginal bool The image transform variants include original. false
labelIdle string The label idle. ''
labelMaxFileSize string The label max file size. ''
labelMaxFileSizeExceeded string The label max file size exceeded. ''
labelMaxTotalFileSize string The label max total file size. ''
labelMaxTotalFileSizeExceeded string The label max total file size exceeded. ''
labelFileTypeNotAllowed string The label file type not allowed. ''
loadFileDefault string The load file default. ''
maxFiles int The max files. 1
maxFileSize string,null The max file size. null
maxTotalFileSize string,null The max total file size. null
minFileSize string,null The min file size. null
pluginDefault array The plugins default. [
FilePondPluginFileValidateType,
FilePondPluginFileValidateSize,
FilePondPluginFileValidateType,
FilePondPluginImageExifOrientation,
FilePondPluginImagePreview,
]
pdfPreviewHeight int The pdf preview height. 320
pdfComponentExtraParams string The pdf component extra params. toolbar=0&view=fit&page=1
required bool Whether the field is required. false

Translation support

The extension supports translation. You can translate the extension into your language, for default the extension supports the following languages:

  • Chinese
  • English
  • French
  • German
  • Poland
  • Portuguese
  • Russian
  • Spanish

Quality code

static-analysis phpstan-level StyleCI

Support versions Yii2

Yii20 Yii22

Testing

Check the documentation testing to learn about testing.

Our social networks

Twitter

License

The MIT License. Please see License File for more information.

filepond's People

Contributors

terabytesoftw avatar tomaszkane avatar

Stargazers

 avatar

Watchers

 avatar

Forkers

tomaszkane

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. 📊📈🎉

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google ❤️ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.