PHPackages                             vkabachenko/yii2-filepond - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. vkabachenko/yii2-filepond

ActiveYii2-extension

vkabachenko/yii2-filepond
=========================

Yii2 upload file module based on filepond js library

55337[1 issues](https://github.com/vkabachenko/yii2-filepond/issues)PHP

Since Mar 7Pushed 6y ago1 watchersCompare

[ Source](https://github.com/vkabachenko/yii2-filepond)[ Packagist](https://packagist.org/packages/vkabachenko/yii2-filepond)[ RSS](/packages/vkabachenko-yii2-filepond/feed)WikiDiscussions master Synced yesterday

READMEChangelogDependenciesVersions (1)Used By (0)

Filepond Yii2 extension
=======================

[](#filepond-yii2-extension)

This extension allows you to use [Filepond upload js library](https://pqina.nl/filepond/) as a widget in yii2 projects.

Installation
------------

[](#installation)

The preferred way to install this extension is through [composer](http://getcomposer.org/download/).

Either run

```
php composer.phar require  vkabachenko/yii2-filepond

```

or add

```
"vkabachenko/yii2-filepond": "dev-master"

```

to the require section of your `composer.json` file.

Usage
-----

[](#usage)

Add the extension to the `module` section in your config file

```
    'modules' => [
       'filepond' => [
           'class' => \vkabachenko\filepond\Module::class
       ]
    ],

```

After that you can use Filepond library to upload files in your project.

[Single file upload without model](docs/single-without-model.md)

[Single file upload with model](docs/single-with-model.md)

[Multiple files upload without model](docs/multiple-without-model.md)

[Multiple files upload with model](docs/multiple-with-model.md)

### Filepond options

[](#filepond-options)

Filepond options described at the [documentation](https://pqina.nl/filepond/docs/) can be set by setting `instanceOptions` or `settingsOptions`.

This is the preferred way:

```

```

### Filepond plugins

[](#filepond-plugins)

If you want to add some of filepond plugins to the widget, set the allow plugin option to `true`. For example, to add file type validation plugin set `allowFileSizeValidation`:

```

```

### Validation

[](#validation)

Only client-side validation is available. This kind of validation is the part of filepond library. You can add file size and file type validation. Example of file type validation:

```

```

### Localization

[](#localization)

Original library isn't localized and has only english labels. This widget has russian translations too. To apply the localization you have to set `language` option in `Yii` settings or directly in the widget:

```

```

### Two or more widget instances on the page

[](#two-or-more-widget-instances-on-the-page)

Simply separate widget class definitions.

Widget 1:

```

```

Widget 2:

```

```

###  Health Score

22

—

LowBetter than 22% of packages

Maintenance16

Infrequent updates — may be unmaintained

Popularity20

Limited adoption so far

Community10

Small or concentrated contributor base

Maturity34

Early-stage or recently created project

 Bus Factor1

Top contributor holds 100% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

### Community

Maintainers

![](https://www.gravatar.com/avatar/43004fc780843e4b79e2467af6f813d2e8d9df65a813fc99b69101324f94287d?d=identicon)[vkabachenko](/maintainers/vkabachenko)

---

Top Contributors

[![vkabachenko](https://avatars.githubusercontent.com/u/9642019?v=4)](https://github.com/vkabachenko "vkabachenko (15 commits)")

### Embed Badge

![Health badge](/badges/vkabachenko-yii2-filepond/health.svg)

```
[![Health](https://phpackages.com/badges/vkabachenko-yii2-filepond/health.svg)](https://phpackages.com/packages/vkabachenko-yii2-filepond)
```

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)