PHPackages                             owl/tagbox - 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. [Utility &amp; Helpers](/categories/utility)
4. /
5. owl/tagbox

AbandonedArchivedLibrary[Utility &amp; Helpers](/categories/utility)

owl/tagbox
==========

Tag form widget for OctoberCMS.

420.9k2[1 issues](https://github.com/october-widgets/tagbox/issues)JavaScript

Since Apr 14Pushed 10y ago1 watchersCompare

[ Source](https://github.com/october-widgets/tagbox)[ Packagist](https://packagist.org/packages/owl/tagbox)[ RSS](/packages/owl-tagbox/feed)WikiDiscussions master Synced 2w ago

READMEChangelogDependenciesVersions (1)Used By (0)

Tagbox
======

[](#tagbox)

Tag form widget for OctoberCMS.

[![Packagist](https://camo.githubusercontent.com/1b4db7b06105467fff48583ac1c5064c469321510623ac680bbb841f05910441/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f6f776c2f746167626f782e737667)](https://camo.githubusercontent.com/1b4db7b06105467fff48583ac1c5064c469321510623ac680bbb841f05910441/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f6f776c2f746167626f782e737667)

### Installation

[](#installation)

To install the Tagbox widget with your plugin, add the following to your plugin's `composer.json` file.

```
"require": {
    "owl/tagbox": "~1.0@dev"
}
```

Next, register the widget in your plugin's `Plugin.php` file.

```
public function registerFormWidgets()
{
    return [
        'Owl\FormWidgets\Tagbox\Widget' => [
            'label' => 'Tagbox',
            'code'  => 'owl-tagbox'
        ],
    ];
}
```

### Usage

[](#usage)

To use the Tagbox widget, simply declare a field type as `owl-tagbox`

```
tags:
    label: Tags
    type: owl-tagbox
```

If tags *are not* being stored through a related model, the model attribute must be [jsonable](http://octobercms.com/docs/database/model#attribute-modifiers). If tags *are* being stored through a related model, the `getTagsAttribute` and `setTagsAttribute` methods must be declared to process the relationship. These methods should return / accept an array of strings.

Validation can be performed on tags by defining a `validation` regular expression parameter. A `validationMessage` can also be defined for custom error messages. For example, if you are accepting an array of emails, something like this could be used to validate the tagbox values...

```
emails:
    label: Email Addresses
    type: owl-tagbox
    validation: ^\w+([-+.']\w+)*@\w+([-.]\w+)*\.\w+([-.]\w+)*$
    validationMessage: Please enter a valid email address.
```

A `filter` expression may also be used to block unwanted characters. In the following example, we'll allow alpha-numeric characters, dashes, and underscores. The default css may be customized or removed by specifying a `cssPath` attribute.

```
tags:
    label: Tags
    type: owl-tagbox
    filter: "[^a-zA-Z0-9_.-]+"
    cssPath: /plugins/vendor/plugin/assets/css/custom-tagbox.css
```

Lastly, a tag may be "slugified" upon entry by setting the `slugify` parameter to `true`.

###  Health Score

26

—

LowBetter than 41% of packages

Maintenance15

Infrequent updates — may be unmaintained

Popularity27

Limited adoption so far

Community9

Small or concentrated contributor base

Maturity41

Maturing project, gaining track record

 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/904cc72c102eb3725fdc5191aaf7519724839af6feb847dc20dfa138f37e50b2?d=identicon)[scottbedard](/maintainers/scottbedard)

---

Top Contributors

[![scottbedard](https://avatars.githubusercontent.com/u/7980426?v=4)](https://github.com/scottbedard "scottbedard (23 commits)")

### Embed Badge

![Health badge](/badges/owl-tagbox/health.svg)

```
[![Health](https://phpackages.com/badges/owl-tagbox/health.svg)](https://phpackages.com/packages/owl-tagbox)
```

PHPackages © 2026

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