PHPackages                             afea/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. afea/filament-popup

ActiveLibrary[Utility & Helpers](/categories/utility)

afea/filament-popup
===================

Popup module for the Afea Filament CMS package ecosystem: content popups with trigger rules and target-page matching.

v0.1.0(1mo ago)017↑328.6%MITPHPPHP ^8.4

Since Apr 21Pushed 1mo agoCompare

[ Source](https://github.com/AfeaSoftware/filament-popup)[ Packagist](https://packagist.org/packages/afea/filament-popup)[ RSS](/packages/afea-filament-popup/feed)WikiDiscussions main Synced 1w ago

READMEChangelogDependencies (12)Versions (2)Used By (0)

afea/filament-popup
===================

[](#afeafilament-popup)

Popup module for the Afea Filament CMS package ecosystem.

Ships:

- `Popup` model — content + image, display rules, target-page matching
- `PopupTriggerType` enum: `immediate`, `delay`, `scroll`, `exit_intent`
- Filament v4 `PopupResource` with RichEditor (shares `afea-cms.rich_content.blocks`)
- `PopupPlugin` for panel registration
- `afea:install:popup` installer

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

[](#installation)

```
composer require afea/filament-popup
php artisan afea:install:popup
```

Register in `AdminPanelProvider`:

```
->plugin(\Afea\Cms\Popup\Filament\PopupPlugin::make())
```

Picking the right popup on the front-end
----------------------------------------

[](#picking-the-right-popup-on-the-front-end)

```
use Afea\Cms\Popup\Models\Popup;

$popups = Popup::active()
    ->orderBy('order')
    ->get()
    ->filter(fn (Popup $popup) => $popup->matchesPath(request()->path()));
```

`matchesPath()` honors both `target_pages` and `exclude_pages`, supporting `*` and `/prefix/*` globs. Exclusions win over inclusions.

Three common scenarios
----------------------

[](#three-common-scenarios)

### 1. Show once per visitor

[](#1-show-once-per-visitor)

Toggle `show_once`. Store a cookie on dismiss and skip the popup if present — the flag is just a signal for your front-end.

### 2. Custom trigger thresholds

[](#2-custom-trigger-thresholds)

`display_rules` is freeform JSON. The default schema ships with `trigger_type`, `delay_seconds`, `scroll_percentage`, `target_pages`, `exclude_pages`. Add your own keys (e.g. `device: ['mobile']`) by extending the form.

### 3. Override the Popup model

[](#3-override-the-popup-model)

```
class Popup extends \Afea\Cms\Popup\Models\Popup
{
    public function scopeForLocale(Builder $q, string $locale): Builder
    {
        return $q->whereJsonContains('display_rules->locales', $locale);
    }
}
```

```
'models' => ['popup' => \App\Models\Popup::class],
```

###  Health Score

38

—

LowBetter than 83% of packages

Maintenance90

Actively maintained with recent releases

Popularity8

Limited adoption so far

Community6

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.

###  Release Activity

Cadence

Unknown

Total

1

Last Release

49d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/090664afed2a3f014aa9cc4d2225925052fbc30e1995ebb9898272dc77a5b45f?d=identicon)[ahmetozrahat](/maintainers/ahmetozrahat)

---

Top Contributors

[![ahmetozrahat](https://avatars.githubusercontent.com/u/12434217?v=4)](https://github.com/ahmetozrahat "ahmetozrahat (2 commits)")

---

Tags

laravelcmspopupfilamentafea

###  Code Quality

TestsPest

Code StyleLaravel Pint

### Embed Badge

![Health badge](/badges/afea-filament-popup/health.svg)

```
[![Health](https://phpackages.com/badges/afea-filament-popup/health.svg)](https://phpackages.com/packages/afea-filament-popup)
```

###  Alternatives

[psalm/plugin-laravel

Psalm plugin for Laravel

3325.1M337](/packages/psalm-plugin-laravel)[laravel/ai

The official AI SDK for Laravel.

9782.1M153](/packages/laravel-ai)[tapp/filament-form-builder

User facing form builder using Filament components

141.9k2](/packages/tapp-filament-form-builder)[a2insights/filament-saas

Filament Saas for A2Insights

171.5k](/packages/a2insights-filament-saas)

PHPackages © 2026

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