PHPackages                             aiarmada/filament-vouchers - 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. [Admin Panels](/categories/admin)
4. /
5. aiarmada/filament-vouchers

ActiveLibrary[Admin Panels](/categories/admin)

aiarmada/filament-vouchers
==========================

A Filament v5 plugin for administering vouchers provided by the AIArmada vouchers package

v1.4.7(5mo ago)0971MITPHPPHP ^8.4

Since Nov 6Pushed 1mo agoCompare

[ Source](https://github.com/AIArmada/filament-vouchers)[ Packagist](https://packagist.org/packages/aiarmada/filament-vouchers)[ Docs](https://github.com/aiarmada/commerce)[ RSS](/packages/aiarmada-filament-vouchers/feed)WikiDiscussions main Synced 1mo ago

READMEChangelogDependencies (3)Versions (34)Used By (1)

Filament Vouchers
=================

[](#filament-vouchers)

> Filament v5 admin panel plugin for managing vouchers powered by the `aiarmada/vouchers` package.

Features
--------

[](#features)

- **Complete Voucher Management** – create, edit, view, and delete vouchers with a rich Filament UI
- **Usage Tracking** – monitor redemptions, discounts applied, and user activity
- **Wallet System** – allow users to save vouchers for later use
- **Dashboard Widgets** – stats overview, redemption trends, and usage timelines
- **Cart Integration** – seamless voucher application when `aiarmada/filament-cart` is installed
- **Multi-Tenant Support** – owner-scoped resources for marketplace scenarios
- **Targeting Configuration** – define preset targeting rules for vouchers
- **Stacking Rules** – configure how vouchers combine with each other

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

[](#installation)

```
composer require aiarmada/filament-vouchers
```

Register the plugin in your panel provider:

```
use AIArmada\FilamentVouchers\FilamentVouchersPlugin;

public function panel(Panel $panel): Panel
{
    return $panel
        ->plugins([
            FilamentVouchersPlugin::make(),
        ]);
}
```

Publish the configuration:

```
php artisan vendor:publish --tag=filament-vouchers-config
```

---

Configuration
-------------

[](#configuration)

```
// config/filament-vouchers.php
return [
    // Navigation group for resources
    'navigation_group' => 'E-commerce',

    // Default currency for monetary displays
    'default_currency' => 'MYR',

    // Table polling interval (seconds or null to disable)
    'polling_interval' => 60,

    // Resource navigation ordering
    'resources' => [
        'navigation_sort' => [
            'vouchers' => 40,
            'voucher_usage' => 41,
        ],
    ],

    // Order resource for linking (set class-string or null)
    'order_resource' => null,

    // Owner types for multi-tenant voucher assignment
    'owners' => [],
];
```

---

Resources
---------

[](#resources)

### Voucher Resource

[](#voucher-resource)

Manage vouchers with full CRUD operations:

- **Code & Name** – unique voucher identifier and display name
- **Type** – percentage, fixed amount, or free shipping
- **Value** – discount amount with currency support
- **Usage Limits** – global and per-user redemption limits
- **Scheduling** – start and expiry dates
- **Conditions** – target rules via DSL presets
- **Owner Assignment** – multi-tenant voucher ownership

### Voucher Usage Resource

[](#voucher-usage-resource)

Track all voucher redemptions:

- User/redeemer information
- Discount amounts applied
- Redemption channel (automatic, manual, API)
- Order linking when configured

---

Widgets
-------

[](#widgets)

The plugin provides these dashboard widgets:

WidgetDescription`VoucherStatsWidget`Overview stats (total, active, upcoming, redemptions)`RedemptionTrendChart`Redemption trends over time`VoucherCartStatsWidget`Cart-specific voucher metrics`VoucherWalletStatsWidget`Wallet entry statistics`VoucherUsageTimelineWidget`Redemption timeline for a voucher`AppliedVoucherBadgesWidget`Shows applied vouchers on a cart`QuickApplyVoucherWidget`Inline voucher application form`VoucherSuggestionsWidget`Smart voucher suggestions for carts`AppliedVouchersWidget`Table of applied vouchers on a cart---

Cart Integration
----------------

[](#cart-integration)

When `aiarmada/filament-cart` is installed, the plugin automatically enables:

- Deep linking from usage records to cart views
- Voucher application actions on cart pages
- Applied voucher widgets on cart detail pages

### Using Cart Actions

[](#using-cart-actions)

Add voucher actions to your cart resource pages:

```
use AIArmada\FilamentVouchers\Extensions\CartVoucherActions;

protected function getHeaderActions(): array
{
    return [
        CartVoucherActions::applyVoucher(),
        CartVoucherActions::showAppliedVouchers(),
    ];
}
```

**Available actions:**

- `applyVoucher()` – modal form to enter and apply a voucher code
- `showAppliedVouchers()` – modal displaying currently applied vouchers
- `removeVoucher($code)` – remove a specific voucher from cart

---

Multi-Tenant Ownership
----------------------

[](#multi-tenant-ownership)

Configure owner types to enable voucher assignment to specific entities:

```
// config/filament-vouchers.php
'owners' => [
    [
        'label' => 'Store',
        'model' => App\Models\Store::class,
        'title_attribute' => 'name',
        'subtitle_attribute' => 'email',      // Optional
        'search_attributes' => ['name', 'code'],
    ],
    [
        'label' => 'Vendor',
        'model' => App\Models\Vendor::class,
        'title_attribute' => 'company_name',
        'search_attributes' => ['company_name', 'email'],
    ],
],
```

When configured, a searchable owner selector appears in the voucher form.

---

Documentation
-------------

[](#documentation)

- [Overview](docs/01-overview.md) – Package introduction and quick start
- [Installation](docs/02-installation.md) – Installation guide
- [Configuration](docs/03-configuration.md) – All configuration options
- [Usage](docs/04-usage.md) – Resources, pages, and actions
- [Widgets](docs/05-widgets.md) – Available widgets and customization
- [Cart Integration](docs/06-cart-integration.md) – Voucher-cart integration guide
- [Troubleshooting](docs/99-troubleshooting.md) – Common issues and solutions

---

License
-------

[](#license)

MIT License. See [LICENSE](LICENSE) for details.

###  Health Score

43

—

FairBetter than 91% of packages

Maintenance81

Actively maintained with recent releases

Popularity9

Limited adoption so far

Community5

Small or concentrated contributor base

Maturity64

Established project with proven stability

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

Every ~4 days

Recently: every ~27 days

Total

33

Last Release

66d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/726da4efcb731bc0ebcdd0b7ce64759e1f8dd63f6f771eab335458f6a2f2d3af?d=identicon)[sairiz](/maintainers/sairiz)

### Embed Badge

![Health badge](/badges/aiarmada-filament-vouchers/health.svg)

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

###  Alternatives

[filament/spatie-laravel-settings-plugin

Filament support for `spatie/laravel-settings`.

1092.4M73](/packages/filament-spatie-laravel-settings-plugin)[awcodes/filament-quick-create

Plugin for Filament Admin that adds a dropdown menu to the header to quickly create new items.

246177.6k7](/packages/awcodes-filament-quick-create)[guava/filament-knowledge-base

A filament plugin that adds a knowledge base and help to your filament panel(s).

206120.5k1](/packages/guava-filament-knowledge-base)[ralphjsmit/laravel-filament-seo

A package to combine the power of Laravel SEO and Filament Admin.

15398.7k10](/packages/ralphjsmit-laravel-filament-seo)[geo-sot/filament-env-editor

Access .env file though Filament admin panel

2432.3k1](/packages/geo-sot-filament-env-editor)[inerba/filament-db-config

A Filament plugin for database-backed application settings and editable content, with caching and easy page generation.

329.1k](/packages/inerba-filament-db-config)

PHPackages © 2026

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