vasilgerginski/filament-short-url

Filament Short URL with marketing fields (description, price, UTM parameters)

v1.0.0 2025-12-15 15:21 UTC

Requires

• php: ^8.2
• ashallendesign/short-url: ^8.1
• bacon/bacon-qr-code: ^3.0
• filament/filament: ^4.0
• livewire/livewire: ^3.6
• spatie/laravel-package-tools: ^1.15.0

Requires (Dev)

• laravel/pint: ^1.14
• nunomaduro/collision: ^8.1.1
• orchestra/testbench: ^9.0.0
• pestphp/pest: ^2.34
• pestphp/pest-plugin-arch: ^2.7
• pestphp/pest-plugin-laravel: ^2.3
• pestphp/pest-plugin-livewire: ^2.1

MIT

• laravel
• marketing
• UTM
• filament
• filament-short-url
• vasilgerginski

README

Filament admin panel integration for ash-jc-allen/short-url with marketing fields support.

Features

• Full CRUD for short URLs
• Marketing fields: description, price/currency, UTM parameters
• QR code generation
• Visit tracking and statistics
• Bulk actions (activate/deactivate, toggle tracking)
• Copy URL to clipboard

Requirements

• PHP ^8.2
• Laravel ^11.0
• Filament ^3.2 || ^4.0

Installation

Install the package via composer:

composer require vasilgerginski/filament-short-url

Publish and run the migrations:

php artisan vendor:publish --provider="AshAllenDesign\ShortURL\Providers\ShortURLProvider"
php artisan vendor:publish --tag="filament-short-url-migrations"
php artisan migrate

Panel Setup

Register the plugin in your Filament panel:

use VasilGerginski\FilamentShortUrl\FilamentShortUrlPlugin;

->plugins([
    FilamentShortUrlPlugin::make()
])

Marketing Fields

This package extends the base short URL with marketing-specific fields:

Field	Description
description	Short description to identify the URL
price	Campaign cost for ROI tracking
currency	Currency (USD, EUR, GBP, BGN, etc.)
utm_source	UTM source parameter
utm_medium	UTM medium parameter
utm_campaign	UTM campaign parameter
utm_term	UTM term parameter
utm_content	UTM content parameter

Configuration

Publish the config file:

php artisan vendor:publish --tag="filament-short-url-config"

Tenant Scoping

Enable multi-tenancy support:

// config/filament-short-url.php
return [
    'tenant_scope' => true,
];

Testing

composer test

License

The MIT License (MIT). Please see License File for more information.