README

Small leads module for projects built with pardalsalcap/linter.

This package provides:

• Lead storage and basic lead scoring
• Spam blacklist management
• Lead configuration management
• Filament resources for managing leads from the CMS

Compatibility

• v3.x: compatible with Filament 3
• main: compatible with Filament 5

Installation

Install the package with Composer:

composer require pardalsalcap/linter-leads

Publish the config file and migrations:

php artisan vendor:publish --tag="linter-leads-config"
php artisan vendor:publish --tag="linter-leads-migrations"

Run the migrations:

php artisan migrate

Run the installation command:

php artisan linter-leads:install

The installation command can:

• Populate the spam blacklist
• Populate the default lead configuration
• Copy the package models to app/Models
• Copy the Filament resources to app/Filament/Resources

Configuration

After publishing the config, you can adjust these values in config/linter-leads.php:

• Available lead statuses
• Field mappings for supported form types
• Notification email and name for lead management
• Spam score threshold

Default mappings included:

• contact: email, phone, name, message
• newsletter: email

Typical Setup Flow

composer require pardalsalcap/linter-leads
php artisan vendor:publish --tag="linter-leads-config"
php artisan vendor:publish --tag="linter-leads-migrations"
php artisan migrate
php artisan linter-leads:install

Development

Run tests:

composer test

Run static analysis:

composer analyse

License

The MIT License (MIT). See LICENSE.md.