PHPackages zpmlabs/filament-popup - 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 & Helpers](/categories/utility) 4. / 5. zpmlabs/filament-popup ActiveLibrary[Utility & Helpers](/categories/utility) zpmlabs/filament-popup ====================== Filament table column popup plugin. v1.0.0(1mo ago)7151—0%1MITPHPPHP ^8.3 Since Apr 30Pushed 1mo agoCompare [ Source](https://github.com/zpm-packages/filament-popup)[ Packagist](https://packagist.org/packages/zpmlabs/filament-popup)[ RSS](/packages/zpmlabs-filament-popup/feed)WikiDiscussions main Synced 1w ago READMEChangelog (1)Dependencies (3)Versions (2)Used By (0) [![FilamentPopup](https://private-user-images.githubusercontent.com/100382372/585799195-58c51f10-6612-4dd4-92e1-f0bf53d0c52b.jpg?jwt=eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJpc3MiOiJnaXRodWIuY29tIiwiYXVkIjoicmF3LmdpdGh1YnVzZXJjb250ZW50LmNvbSIsImtleSI6ImtleTUiLCJleHAiOjE3ODAxMjk2ODUsIm5iZiI6MTc4MDEyOTM4NSwicGF0aCI6Ii8xMDAzODIzNzIvNTg1Nzk5MTk1LTU4YzUxZjEwLTY2MTItNGRkNC05MmUxLWYwYmY1M2QwYzUyYi5qcGc_WC1BbXotQWxnb3JpdGhtPUFXUzQtSE1BQy1TSEEyNTYmWC1BbXotQ3JlZGVudGlhbD1BS0lBVkNPRFlMU0E1M1BRSzRaQSUyRjIwMjYwNTMwJTJGdXMtZWFzdC0xJTJGczMlMkZhd3M0X3JlcXVlc3QmWC1BbXotRGF0ZT0yMDI2MDUzMFQwODIzMDVaJlgtQW16LUV4cGlyZXM9MzAwJlgtQW16LVNpZ25hdHVyZT1mZWQxMjg3MWZlYTczZWFjMmE5NGZlMWZmNTU1MWI3ZThjNjczNmQ3ZjQyZTc0YjIzMDEzMjY5YmFjMGRkMWNlJlgtQW16LVNpZ25lZEhlYWRlcnM9aG9zdCZyZXNwb25zZS1jb250ZW50LXR5cGU9aW1hZ2UlMkZqcGVnIn0.TgB-wVSCAbL2queTvqYRskkt5b1PufShgVgk5Vd44zc)](https://private-user-images.githubusercontent.com/100382372/585799195-58c51f10-6612-4dd4-92e1-f0bf53d0c52b.jpg?jwt=eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJpc3MiOiJnaXRodWIuY29tIiwiYXVkIjoicmF3LmdpdGh1YnVzZXJjb250ZW50LmNvbSIsImtleSI6ImtleTUiLCJleHAiOjE3ODAxMjk2ODUsIm5iZiI6MTc4MDEyOTM4NSwicGF0aCI6Ii8xMDAzODIzNzIvNTg1Nzk5MTk1LTU4YzUxZjEwLTY2MTItNGRkNC05MmUxLWYwYmY1M2QwYzUyYi5qcGc_WC1BbXotQWxnb3JpdGhtPUFXUzQtSE1BQy1TSEEyNTYmWC1BbXotQ3JlZGVudGlhbD1BS0lBVkNPRFlMU0E1M1BRSzRaQSUyRjIwMjYwNTMwJTJGdXMtZWFzdC0xJTJGczMlMkZhd3M0X3JlcXVlc3QmWC1BbXotRGF0ZT0yMDI2MDUzMFQwODIzMDVaJlgtQW16LUV4cGlyZXM9MzAwJlgtQW16LVNpZ25hdHVyZT1mZWQxMjg3MWZlYTczZWFjMmE5NGZlMWZmNTU1MWI3ZThjNjczNmQ3ZjQyZTc0YjIzMDEzMjY5YmFjMGRkMWNlJlgtQW16LVNpZ25lZEhlYWRlcnM9aG9zdCZyZXNwb25zZS1jb250ZW50LXR5cGU9aW1hZ2UlMkZqcGVnIn0.TgB-wVSCAbL2queTvqYRskkt5b1PufShgVgk5Vd44zc)Filament Popup ============== [](#filament-popup) A Filament 5 plugin for rendering Livewire-powered popups from table columns. The package is designed for quick previews and inline interactions on table cells: ``` use ZPMLabs\FilamentPopup\Enums\PopUpPosition; TextColumn::make('name') ->badge() ->popup(UserPopupInfolist::class, PopUpPosition::TopCenter) ->searchable(); ``` How It Works ------------ [](#how-it-works) The table cell only stores popup metadata. JavaScript handles browser events and sends an open event to one global Livewire popup host. The host loads the Eloquent record, renders the popup content, manages form state, validates forms, saves data, and refreshes the page table. This is important because Filament forms, actions, and tables need a real Livewire render cycle. The package does not put rendered HTML into `data-*` attributes. Installation ------------ [](#installation) Install with Composer: ``` composer require zpmlabs/filament-popup ``` The service provider registers the column macros, assets, Livewire component, and a Filament `BODY_END` render hook for the global popup host. If package auto-discovery is disabled, register the provider manually: ``` ZPMLabs\FilamentPopup\FilamentPopupServiceProvider::class, ``` Publish the config if you want to change defaults: ``` php artisan vendor:publish --tag=filament-popup-config ``` If your panel theme uses Tailwind source scanning, include the package views: ``` @source '../../../../vendor/zpmlabs/filament-popup/resources/views/**/*'; ``` Then publish Filament assets: ``` php artisan filament:assets ``` Column API ---------- [](#column-api) Use `popup()` on any Filament table column: ``` TextColumn::make('name') ->popup(UserPopupInfolist::class, PopUpPosition::TopCenter, [ 'width' => 'md', 'delay' => 250, 'closeDelay' => 300, 'offset' => 10, 'interactive' => true, 'trigger' => 'hover', ]); ``` Fluent helpers are also available: ``` TextColumn::make('name') ->popup(UserPopupInfolist::class) ->popupPosition(PopUpPosition::TopCenter) ->popupWidth('md') ->popupDelay(300) ->popupCloseDelay(300) ->popupTrigger('hover', key: 'shift'); ``` Options ------- [](#options) Supported options: - `width`: `xs`, `sm`, `md`, `lg`, `xl`, `2xl` - `delay`: hover open delay in milliseconds - `closeDelay`: hover close delay in milliseconds - `offset`: spacing between the trigger and popup - `interactive`: keeps hover popups usable while moving into the popup - `position`: provided by the `PopUpPosition` enum: `TopLeft`, `TopCenter`, `TopRight`, `MiddleLeft`, `MiddleRight`, `BottomLeft`, `BottomCenter`, `BottomRight` - `trigger`: `hover`, `click`, or `contextmenu` - `triggerKey`: optional modifier or key, such as `shift`, `alt`, `ctrl`, or `meta` - `showActions`, `saveLabel`, `cancelLabel`: legacy host action options; prefer schema actions for forms Shared Example Table -------------------- [](#shared-example-table) The examples use a normal users table with four trigger styles: ``` TextColumn::make('name') ->label('Hover') ->badge() ->popup($content, PopUpPosition::TopCenter, [ 'width' => 'md', 'trigger' => 'hover', ]); TextColumn::make('email') ->label('Click') ->copyable() ->popup($content, PopUpPosition::MiddleRight, [ 'width' => 'lg', 'trigger' => 'click', ]); IconColumn::make('email_verified_at') ->label('Right click') ->boolean() ->popup($content, PopUpPosition::BottomCenter, [ 'trigger' => 'contextmenu', ]); TextColumn::make('created_at') ->label('Shift hover') ->dateTime() ->popup($content, PopUpPosition::MiddleLeft, [ 'width' => 'xl', 'trigger' => 'hover', 'triggerKey' => 'shift', ]); ``` Array Popups ------------ [](#array-popups) Arrays are useful for simple read-only previews: ``` TextColumn::make('name') ->popup(fn ($record) => [ 'Name' => $record->name, 'Email' => $record->email, 'Joined' => $record->created_at?->toFormattedDateString(), ]); ``` Closures are resolved when the table cell metadata is rendered. They should return static array content. Infolist / Schema Popups ------------------------ [](#infolist--schema-popups) For Filament schema or infolist content, create a class with a static `make()` method: ``` use Filament\Infolists\Components\IconEntry; use Filament\Infolists\Components\TextEntry; use Filament\Schemas\Components\Grid; use Filament\Schemas\Schema; final class UserPopupInfolist { public static function make(Schema $schema, mixed $record): Schema { return $schema ->record($record) ->components([ Grid::make(2) ->schema([ TextEntry::make('name'), TextEntry::make('email'), IconEntry::make('email_verified_at') ->label('Verified') ->boolean(), ]), ]); } } ``` Then use it: ``` TextColumn::make('name') ->popup(UserPopupInfolist::class); ``` Form Popups ----------- [](#form-popups) Form popups should also use a static `make()` method. The important part is `statePath('popupFormData')`, because the popup host stores form state there. ``` use Filament\Actions\Action; use Filament\Forms\Components\TextInput; use Filament\Schemas\Components\Actions; use Filament\Schemas\Components\Form; use Filament\Schemas\Components\Grid; use Filament\Schemas\Schema; final class UserPopupForm { public static function make(Schema $schema, mixed $record): Schema { return $schema ->record($record) ->statePath('popupFormData') ->components([ Form::make([ Grid::make(2) ->schema([ TextInput::make('name') ->required(), TextInput::make('email') ->label('Email address') ->email() ->required(), ]) ->columnSpanFull(), ]) ->footer([ Actions::make([ Action::make('cancelPopupForm') ->label('Cancel') ->color('gray') ->action('close'), Action::make('savePopupForm') ->label('Save user') ->action('save'), ]) ->alignEnd(), ]) ->columnSpanFull(), ]); } } ``` Use string Livewire handlers for form actions: ``` Action::make('savePopupForm')->action('save'); Action::make('cancelPopupForm')->action('close'); ``` Do not use closure actions for the popup save/cancel buttons. Popup content is rendered dynamically by the popup host, so string handlers are the simplest way to render buttons with direct `wire:click` handlers. The host `save()` method validates the popup schema before updating the record, then dispatches refresh events so the page table updates. You do not need `->livewireSubmitHandler('save')` when using action buttons with `->action('save')`. Add it only if you intentionally use a submit button that relies on the form submit event. Blade View Popups ----------------- [](#blade-view-popups) Pass a Blade view name: ``` TextColumn::make('name') ->popup('filament-popup::examples.user-popup'); ``` The view receives: ``` $record $options ``` Blade Component Popups ---------------------- [](#blade-component-popups) Pass a Blade component class: ``` TextColumn::make('name') ->popup(UserPopupComponent::class); ``` The component is constructed with named arguments: ``` public function __construct( public mixed $record, public array $options = [], ) {} ``` Table Popups ------------ [](#table-popups) Table popup classes use a static `configure()` method: ``` use Filament\Tables\Columns\IconColumn; use Filament\Tables\Columns\TextColumn; use Filament\Tables\Table; final class UserPopupPreviewTable { public static function configure(Table $table, mixed $record): Table { return $table ->records(fn (): array => [ 1 => [ 'title' => 'First item', 'slug' => 'first-item', 'is_featured' => true, ], 2 => [ 'title' => 'Second item', 'slug' => 'second-item', 'is_featured' => false, ], ]) ->columns([ TextColumn::make('title'), TextColumn::make('slug'), IconColumn::make('is_featured') ->boolean(), ]); } } ``` Then use: ``` TextColumn::make('name') ->popup(UserPopupPreviewTable::class); ``` For custom array data, make sure every row has a stable key. Filament adds one when using keyed arrays like the example above. Example Resource ---------------- [](#example-resource) The package includes a ready-to-register `UserResource` for testing all formats against `App\Models\User`. Register it in your panel provider: ``` use ZPMLabs\FilamentPopup\Examples\UserResource; public function panel(Panel $panel): Panel { return $panel ->resources([ UserResource::class, ]); } ``` The example routes are: - `/admin/popup-examples`: infolist popup - `/admin/popup-examples/array`: array popup - `/admin/popup-examples/view`: Blade view popup - `/admin/popup-examples/component`: Blade component popup - `/admin/popup-examples/form`: form popup - `/admin/popup-examples/table`: table popup Configuration ------------- [](#configuration) The config key is `filament-popup`: ``` return [ 'default_width' => 'sm', 'default_delay' => 250, 'default_close_delay' => 200, 'default_offset' => 8, 'default_position' => 'top-center', 'default_trigger' => 'hover', 'default_trigger_key' => null, 'default_show_actions' => false, 'default_save_label' => 'Save', 'default_cancel_label' => 'Cancel', ]; ``` Troubleshooting --------------- [](#troubleshooting) If the popup JavaScript changes are not visible, run: ``` php artisan filament:assets php artisan optimize:clear ``` If Tailwind classes in package views are missing, add the package view source path to your panel theme CSS and rebuild your frontend assets. If a form button renders but does not do anything, check that it uses a string Livewire handler such as `->action('save')` or `->action('close')`, not a closure. If a table popup shows "no data", ensure the table class returns records with stable keys and that it is passed as a class string with `configure(Table $table, mixed $record): Table`. Current Scope ------------- [](#current-scope) Supported content: - arrays and closures returning arrays - schema/infolist classes - schema form classes - Blade views - Blade components - table classes Not supported yet: - full Filament page rendering inside a popup ### Health Score 45 — FairBetter than 91% of packages Maintenance92 Actively maintained with recent releases Popularity21 Limited adoption so far Community7 Small or concentrated contributor base Maturity48 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. ### Release Activity Cadence Unknown Total 1 Last Release 40d ago ### Community Maintainers ![](https://avatars.githubusercontent.com/u/211412089?v=4)[ZPM Labs](/maintainers/zpmlabs)[@ZPMLabs](https://github.com/ZPMLabs) --- Top Contributors [![sasaorasanin](https://avatars.githubusercontent.com/u/100382372?v=4)](https://github.com/sasaorasanin "sasaorasanin (3 commits)") ### Embed Badge ![Health badge](/badges/zpmlabs-filament-popup/health.svg) ``` [![Health](https://phpackages.com/badges/zpmlabs-filament-popup/health.svg)](https://phpackages.com/packages/zpmlabs-filament-popup) ``` ### Alternatives [nasirkhan/laravel-starter A CMS like modular Laravel starter project. 1.4k2.7k](/packages/nasirkhan-laravel-starter)[tanthammar/filament-extras Filament macros, pages, fields, columns and other helpers 535.0k](/packages/tanthammar-filament-extras)[crumbls/layup A visual page builder plugin for Filament 5 — Divi-style grid layouts with extensible widgets. 591.7k1](/packages/crumbls-layup)[team-nifty-gmbh/tall-datatables Server-side rendered datatables for Laravel and Livewire 1319.7k3](/packages/team-nifty-gmbh-tall-datatables)[tomshaw/electricgrid A feature-rich Livewire package designed for projects that require dynamic, interactive data tables. 119.2k](/packages/tomshaw-electricgrid) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)