phpinnacle/tags

Polymorphic record tagging and management for Laravel Filament applications.

1.0.0 2026-09-01 10:40 UTC

Requires

• php: ^8.4
• filament/filament: ^4.0|^5.0
• phpinnacle/palette: ^1.0

MIT

• PHPinnacle Devs

• laravel
• phpinnacle
• filament

Published on Packagist.org on 2026-09-01 12:40 UTC

README

Tags adds reusable, polymorphic tagging to Eloquent records and provides the Filament components needed to edit, display, filter and bulk-assign tags.

Features

• Central Tag model with polymorphic record assignments.
• Filament TagsInput form field.
• TagsColumn for table display.
• TagsFilter for narrowing table records.
• TagsBulkAction for assigning tags to multiple records.
• Policy-backed tag management, custom connection and optional tenancy.

Installation

composer require phpinnacle/tags
php artisan vendor:publish --tag="phpinnacle-tags-migrations"
php artisan migrate

Register TagsPlugin::make() in the target Filament panel. Publish phpinnacle-tags-config when using a non-default database connection or tenant model.

Filament usage

use PHPinnacle\Tags\Actions\TagsBulkAction;
use PHPinnacle\Tags\Filters\TagsFilter;
use PHPinnacle\Tags\Forms\TagsInput;
use PHPinnacle\Tags\Tables\TagsColumn;

TagsInput::make('tags');

TagsColumn::make('tags');

TagsFilter::make('tags');

TagsBulkAction::make();

The tagged model must expose the relationship expected by these components. Follow the relation naming and morph contract used by Tag and the package migration when integrating an existing model. Authorization for tag records is handled by TagPolicy.

Testing

composer test

Changelog and license

See CHANGELOG. Released under the MIT License.